Here are my notes from producing the v0.2.2 release. Change the version number as appropriate.
Edit the “Version” variable in
main.go and commit.
export PREVVERSION=2.4 export VERSION=2.5 git checkout master vi main.go git commit -m'Release v'"$VERSION" main.go git tag v0."$VERSION" git push origin tag v0."$VERSION"
Pick the v0.$VERSION tag
Release title: Release v0.$VERSION
Fill in the text box with something friendly like, “So many new features!” then make a bullet list of major new functionality.
Review the git log using this command:
git log v0."$VERSION"...v0."$PREVVERSION"
(Don’t click SAVE until the next step is complete!)
Create the binaries and attach them to the release:
go run build/build.go
NOTE: This command creates binaries with the version number and git hash embedded. It also builds the releases for all supported platforms (i.e. creates a .exe for Windows even if you are running on Linux. Isn’t Go amazing?)
WARNING: if there are unchecked in files, the version string will have “dirty” appended.
This is what it looks like when you did it right:
$ ./dnscontrol-Darwin version dnscontrol 0.1.5 ("6fdf78997815055bbe119c0116c9e2d60310a515") built 24 Aug 17 11:26 EDT
This is what it looks like when there was a file that should have been checked in:
$ ./dnscontrol-Darwin version dnscontrol 0.1.5 ("6fdf78997815055bbe119c0116c9e2d60310a515[dirty]") built 24 Aug 17 11:27 EDT ^^^^^ ^^^^^ See? ^^^^^
Drag and drop binaries into the web form.
Submit the release.
Email the mailing list: (note the format of the Subject line and that the first line of the email is the URL of the release)
To: email@example.com Subject: New release: dnscontrol v0.$VERSION https://github.com/StackExchange/dnscontrol/releases/tag/v0.$VERSION So many new providers and features! Plus, a new testing framework that makes it easier to add big features without fear of breaking old ones. * list * of * major * changes
Mention on https://gitter.im/dnscontrol/Lobby that the new release has shipped.
dnscontrol $VERSION has been released! https://github.com/StackExchange/dnscontrol/releases/tag/v0.$VERSION
Mention the fact that you did this release in your weekly accomplishments.
If you are at Stack Overflow:
dnscontrol_embed - Promote most recent artifact into ExternalDNS repo