vagrant/RELEASE.md

Releasing Vagrant

This documents how to release Vagrant. Various steps in this document will require privileged access to private systems, so this document is only targetted at Vagrant core members who have the ability to cut a release.

1. Update version.txt to the version you want to release.

2. Update CHANGELOG.md to have a header with the release version and date.

3. Commit those changes and also tag the release with the version:

   $ git tag vX.Y.Z
   $ git push --tags
   

4. Trigger an installer creation run within the HashiCorp Bamboo installation. This will take around 45 minutes.

5. Download all the resulting artifacts into the pkg/dist folder relative to the Vagrant repository on your local machine.

6. Run ./scripts/sign.sh with the version that is being created. This must be run from the Vagrant repo root. This will GPG sign and checksum the files.

7. Run the following command to upload to the releases site:

   $ hc-releases -upload pkg/dist -publish -purge
   

8. Update website/config.rb to point to the latest version, commit, and push.

9. Tell HashiBot to deploy in ``#deploys`

   hashibot deploy vagrant
   

10. Update version.txt to append .dev and add a new blank entry in the CHANGELOG, commit, and push.

11. Update Checkpoint with the new version.