@ -4,26 +4,45 @@ Meta: There should always be a single release engineer to disambiguate responsib
## Pre-release
The following should have been checked well in advance of the release:
- All dependencies have been updated as appropriate:
- BDB
- Boost
- ccache
- libgmp
- libsnark (upstream of our fork)
- libsodium
- miniupnpc
- OpenSSL
### Github Milestone
Ensure all goals for the github milestone are met. If not, remove tickets
or PRs with a comment as to why it is not included. (Running out of time
is a common reason.)
### Pre-release checklist:
Check that dependencies are properly hosted by looking at the `check-depends` builder:
https://ci.z.cash/#/builders/1
Check that there are no surprising performance regressions:
https://speed.z.cash
Ensure that new performance metrics appear on that site.
### Protocol Safety Checks:
If this release changes the behavior of the protocol or fixes a serious
bug, verify that a pre-release PR merge updated `PROTOCOL_VERSION` in
`version.h` correctly.
If this release breaks backwards compatibility or needs to prevent
interaction with software forked projects, change the network magic
numbers. Set the four `pchMessageStart` in `CTestNetParams` in
`chainparams.cpp` to random values.
Both of these should be done in standard PRs ahead of the release
process. If these were not anticipated correctly, this could block the
release, so if you suspect this is necessary, double check with the
whole engineering team.
## Release process
Run the release script:
Run the release script, which will verify you are on the latest clean
checkout of master, create a branch, then commit standard automated
changes to that branch locally:
$ ./zcutil/make-release.py < RELEASE > < RELEASE_PREV >
@ -31,58 +50,50 @@ Example:
$ ./zcutil/make-release.py v1.0.8-1 v1.0.9
### B3. Generate release notes
Run the release-notes.py script to generate release notes and update authors.md file. For example:
$ python zcutil/release-notes.py --version $ZCASH_RELEASE
Add the newly created release notes to the Git repository:
### Create, Review, and Merge the release branch pull request
$ git add ./doc/authors.md ./doc/release-notes/release-notes-$ZCASH_RELEASE.md
Review the automated changes in git:
Update the Debian package changelog:
$ git log master..HEAD
export DEBVERSION=$(echo $ZCASH_RELEASE | sed 's/-beta/~beta/' | sed 's/-rc/~rc/' | sed 's/-/+/')
export DEBEMAIL="${DEBEMAIL:-team@z.cash}"
export DEBFULLNAME="${DEBFULLNAME:-Zcash Company}"
Push the resulting branch to github:
dch -v $DEBVERSION -D jessie -c contrib/debian/changelog
$ git push 'git@github.com:$YOUR_GITHUB_NAME/zcash' $(git rev-parse --abbrev-ref HEAD)
(`dch` comes from the devscripts package.)
Then create the PR on github. Complete the standard review process,
then merge, then wait for CI to complete.
### B4. Change the network magics
## Make tag for the newly merged result
If this release breaks backwards compatibility, change the network magic
numbers. Set the four `pchMessageStart` in `CTestNetParams` in `chainparams.cpp`
to random values.
### B5. Merge the previous changes
Do the normal pull-request, review, testing process for this release PR.
Checkout master and pull the latest version to ensure master is up to date with the release PR which was merged in before.
## C. Verify code artifact hosting
$ git checkout master
$ git pull --ff-only
### C1. Ensure depends tree is working
Check the last commit on the local and remote versions of master to make sure they are the same:
https://ci.z.cash/builders/depends-sources
$ git log -1
### C2. Ensure public parameters work
The output should include something like, which is created by Homu:
Run `./fetch-params.sh` .
Auto merge of #4242 - nathan-at-least:release-v1.0.9, r=nathan-at-least
## D. Make tag for the newly merged result
Then create the git tag. The `-s` means the release tag will be
signed. **CAUTION:** Remember the `v` at the beginning here:
Checkout master and pull the latest version to ensure master is up to date with the release PR which was merged in before.
$ git tag -s v1.0.9
$ git push origin v1.0.9
Check the last commit on the local and remote versions of master to make sure they are the same.
## Make and deploy deterministic builds
Then create the git tag:
- Run the [Gitian deterministic build environment ](https://github.com/zcash/zcash-gitian )
- Compare the uploaded [build manifests on gitian.sigs ](https://github.com/zcash/gitian.sigs )
- If all is well, the DevOps engineer will build the Debian packages and update the
[apt.z.cash package repository ](https://apt.z.cash ).
$ git tag -s v${ZCASH_RELEASE}
$ git push origin v${ZCASH_RELEASE}
## Post Release Task List
## E. Deploy testnet
### Deploy testnet
Notify the Zcash DevOps engineer/sysadmin that the release has been tagged. They update some variables in the company's automation code and then run an Ansible playbook, which:
@ -93,26 +104,8 @@ Notify the Zcash DevOps engineer/sysadmin that the release has been tagged. They
Then, verify that nodes can connect to the testnet server, and update the guide on the wiki to ensure the correct hostname is listed in the recommended zcash.conf.
## F. Update the 1.0 User Guide
## G. Publish the release announcement (blog, zcash-dev, slack)
### G1. Check in with users who opened issues that were resolved in the release
Contact all users who opened `user support` issues that were resolved in the release, and ask them if the release fixes or improves their issue.
## H. Make and deploy deterministic builds
- Run the [Gitian deterministic build environment ](https://github.com/zcash/zcash-gitian )
- Compare the uploaded [build manifests on gitian.sigs ](https://github.com/zcash/gitian.sigs )
- If all is well, the DevOps engineer will build the Debian packages and update the
[apt.z.cash package repository ](https://apt.z.cash ).
## I. Celebrate
## missing steps
Zcash still needs:
### Update the 1.0 User Guide
* thorough pre-release testing (presumably more thorough than standard PR tests )
### Publish the release announcement (blog, zcash-dev, slack)
* automated release deployment (e.g.: updating build-depends mirror, deploying testnet, etc...)
## Celebrate