more info on verifying the builds (whether downloaded or not) and vote (a script)
also tidy the release/dir moving pr_report to a subdir Project: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/repo Commit: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/commit/b21985d2 Tree: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/tree/b21985d2 Diff: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/diff/b21985d2 Branch: refs/heads/0.8.0-incubating Commit: b21985d2a6b411eaecb44b6eb89e91cbe80de4a5 Parents: 69972d5 Author: Alex Heneveld <[email protected]> Authored: Thu Sep 3 14:48:08 2015 +0100 Committer: Alex Heneveld <[email protected]> Committed: Fri Sep 4 14:33:51 2015 +0100 ---------------------------------------------------------------------- .../release-process/verify-release-artifacts.md | 17 ++++++-- .../committers/release-process/vote.md | 44 ++++++++++++-------- 2 files changed, 40 insertions(+), 21 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/brooklyn-docs/blob/b21985d2/docs/website/developers/committers/release-process/verify-release-artifacts.md ---------------------------------------------------------------------- diff --git a/docs/website/developers/committers/release-process/verify-release-artifacts.md b/docs/website/developers/committers/release-process/verify-release-artifacts.md index 086e56c..40c8b20 100644 --- a/docs/website/developers/committers/release-process/verify-release-artifacts.md +++ b/docs/website/developers/committers/release-process/verify-release-artifacts.md @@ -36,10 +36,12 @@ curl https://dist.apache.org/repos/dist/release/incubator/brooklyn/KEYS | gpg2 - {% endhighlight %} -Verify the hashes and signatures of artifacts ---------------------------------------------- +Download the artifacts +---------------------- -If the releases have been published to the pre-release area, download them: +If you've just built the RC, simply go to that directory and skip this step. + +If you're verifying a build someone else has made, first download the files including all keys using: {% highlight bash %} TEMP_DIR=~/tmp/brooklyn/release/${VERSION_NAME}-rc${RC_NUMBER} @@ -56,7 +58,14 @@ for ext in -src.tar.gz -src.zip -bin.tar.gz -bin.zip; do done {% endhighlight %} -Then verify the hashes, and ensure you get a positive message from each one: +(Alternatively if you have `apache-dist-dev-repo` checked out, +you can do an `svn up` in there and `cd apache-brooklyn-${VERSION_NAME}-rc${RC_NUMBER}`.) + + +Verify the hashes and signatures of artifacts +--------------------------------------------- + +Then check the hashes and signatures, ensuring you get a positive message from each one: {% highlight bash %} for ext in -src.tar.gz -src.zip -bin.tar.gz -bin.zip; do http://git-wip-us.apache.org/repos/asf/brooklyn-docs/blob/b21985d2/docs/website/developers/committers/release-process/vote.md ---------------------------------------------------------------------- diff --git a/docs/website/developers/committers/release-process/vote.md b/docs/website/developers/committers/release-process/vote.md index db8b305..d3f6930 100644 --- a/docs/website/developers/committers/release-process/vote.md +++ b/docs/website/developers/committers/release-process/vote.md @@ -7,32 +7,39 @@ navgroup: developers Start the vote -------------- -Copy-paste the e-mail below, being sure to substitute: +A script to generate the voting email can be found in `release/print-vote-email.sh`, +taking a single argument being the staging repo link. For example: -- version number -- RC number + release/print-vote-email.sh orgapachebrooklyn-1234 | pbcopy + +You should move the subject and put your name at the end, and simply eyeball the rest. This should be sent to **[email protected]**. + +Alternatively, copy-paste the e-mail template below, being sure to substitute: + +- VERSION_NAME +- RC_NUMBER - URLs containing version numbers - URL for your own PGP key - Checksums - URL for the Maven staging repository -### Subject: [VOTE] Release Apache Brooklyn 0.7.0-incubating [rc1] +### Subject: [VOTE] Release Apache Brooklyn ${VERSION_NAME} [rc${RC_NUMBER}] {% highlight text %} -This is to call for a vote for the release of Apache Brooklyn 0.7.0-incubating. +This is to call for a vote for the release of Apache Brooklyn ${VERSION_NAME}. This release comprises of a source code distribution, and a corresponding binary distribution, and Maven artifacts. The source and binary distributions, including signatures, digests, etc. can be found at: -https://dist.apache.org/repos/dist/dev/incubator/brooklyn/apache-brooklyn-0.7.0-incubating-rc1 +https://dist.apache.org/repos/dist/dev/incubator/brooklyn/apache-brooklyn-${VERSION_NAME}-rc${RC_NUMBER} The artifact SHA-256 checksums are as follows: -c3b5c581f14b44aed786010ac7c8c2d899ea0ff511135330395a2ff2a30dd5cf *apache-brooklyn-0.7.0-incubating-rc1-bin.tar.gz -cef49056ba6e5bf012746a72600b2cee8e2dfca1c39740c945c456eacd6b6fca *apache-brooklyn-0.7.0-incubating-rc1-bin.zip -8069bfc54e7f811f6b57841167b35661518aa88cabcb070bf05aae2ff1167b5a *apache-brooklyn-0.7.0-incubating-rc1-src.tar.gz -acd2229c44e93e41372fd8b7ea0038f15fe4aaede5a3bcc5056f28a770543b82 *apache-brooklyn-0.7.0-incubating-rc1-src.zip +c3b5c581f14b44aed786010ac7c8c2d899ea0ff511135330395a2ff2a30dd5cf *apache-brooklyn-${VERSION_NAME}-rc${RC_NUMBER}-bin.tar.gz +cef49056ba6e5bf012746a72600b2cee8e2dfca1c39740c945c456eacd6b6fca *apache-brooklyn-${VERSION_NAME}-rc${RC_NUMBER}-bin.zip +8069bfc54e7f811f6b57841167b35661518aa88cabcb070bf05aae2ff1167b5a *apache-brooklyn-${VERSION_NAME}-rc${RC_NUMBER}-src.tar.gz +acd2229c44e93e41372fd8b7ea0038f15fe4aaede5a3bcc5056f28a770543b82 *apache-brooklyn-${VERSION_NAME}-rc${RC_NUMBER}-src.zip The Nexus staging repository for the Maven artifacts is located at: https://repository.apache.org/content/repositories/orgapachebrooklyn-1004 @@ -48,10 +55,10 @@ The artifacts were built from Git commit ID https://git-wip-us.apache.org/repos/asf?p=incubator-brooklyn.git;a=commit;h=24a23c5a4fd5967725930b8ceaed61dfbd225980 -Please vote on releasing this package as Apache Brooklyn 0.7.0-incubating. +Please vote on releasing this package as Apache Brooklyn ${VERSION_NAME}. The vote will be open for at least 72 hours. -[ ] +1 Release this package as Apache Brooklyn 0.7.0-incubating +[ ] +1 Release this package as Apache Brooklyn ${VERSION_NAME} [ ] +0 no opinion [ ] -1 Do not release this package because ... @@ -99,12 +106,15 @@ Finally, count up the +1s and separate into binding (PPMC) and non-binding. Email the vote result --------------------- -This is a new email thread with a different subject. +This is a new email thread with a different subject +(the same as before with `[RESULT]` prepended). + +Note that you must find the URL for the previous thread at [mail-archives.apache.org](https://mail-archives.apache.org/). -### Subject: [RESULT][VOTE] Release Apache Brooklyn 0.7.0-incubating [rc1] +### Subject: [RESULT]\[VOTE] Release Apache Brooklyn ${VERSION_NAME} [rc${RC_NUMBER}] {% highlight text %} -The vote for releasing Apache Brooklyn 0.7.0-incubating passed with 5 binding +1s, 1 non-binding +1s, and no 0 or -1. +The vote for releasing Apache Brooklyn ${VERSION_NAME} passed with 5 binding +1s, 1 non-binding +1s, and no 0 or -1. Vote thread link: https://mail-archives.apache.org/mod_mbox/incubator-brooklyn-dev/201507.mbox/%3CCABQFKi1WapCMRUqQ93E7Qow5onKgL3nyG3HW9Cse7vo%2BtUChRQ%40mail.gmail.com%3E @@ -124,6 +134,6 @@ Thanks to everyone that tested our release and voted. We will shortly begin a vote on the incubator-general list. -Thanks, -[Release manager name] +Thanks. + {% endhighlight %}
