Repository: qpid-proton Updated Branches: refs/heads/master 9e5db4183 -> 15e930557
NO-JIRA: initial update of release process checklist Project: http://git-wip-us.apache.org/repos/asf/qpid-proton/repo Commit: http://git-wip-us.apache.org/repos/asf/qpid-proton/commit/15e93055 Tree: http://git-wip-us.apache.org/repos/asf/qpid-proton/tree/15e93055 Diff: http://git-wip-us.apache.org/repos/asf/qpid-proton/diff/15e93055 Branch: refs/heads/master Commit: 15e9305570ea3f37c5ba3920b9dbfecf29642a5d Parents: 9e5db41 Author: Robert Gemmell <[email protected]> Authored: Wed Aug 5 13:01:59 2015 +0100 Committer: Robert Gemmell <[email protected]> Committed: Wed Aug 5 13:05:06 2015 +0100 ---------------------------------------------------------------------- RELEASE.md | 63 ++++++++++++++++++++++++++++++++++++--------------------- 1 file changed, 40 insertions(+), 23 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/qpid-proton/blob/15e93055/RELEASE.md ---------------------------------------------------------------------- diff --git a/RELEASE.md b/RELEASE.md index e3ed8bf..d0fb810 100644 --- a/RELEASE.md +++ b/RELEASE.md @@ -1,26 +1,43 @@ -###Building a release for vote: +### Building a release for vote: -1. git checkout <branch> where <branch> is whatever branch you intend to release from - - this *should* be able to be any branch, ref, tag, etc -2. run bin/release.sh <VERSION> <TAG>, e.g. bin/release.sh 0.9 0.9-rc1 -3. run git push origin ... as described # when exactly should this happen? -4. cd into some scratch directory -5. run ~/proton/bin/export.sh -6. run sign qpid-proton-... -7. run tar -xzf qpid-proton-... -8. cd qpid-proton-... -9. mvn deploy -Papache-release -DskipTests=true -10. https://repository.apache.org/index.html#stagingProfiles -11. close the repo... -12. upload/send email +1. Grab a clean checkout for safety. +2. Run: "git checkout ${BRANCH}" to switch to a branch of the intended release point. +3. Run: "bin/release.sh ${VERSION} ${TAG}", e.g. bin/release.sh 0.10 0.10-rc1. + - This will create a detached-HEAD state, manipulate the versions, and then create the tag. +4. Run: "git push origin ${TAG}" as directed by the script. + - This can be deferred until later if desired, following archive creation and testing etc. +5. Run: "bin/export.sh $PWD ${TAG}" to create the qpid-proton-${TAG}.tar.gz release archive. +6. Create signature and checksums for the archive: + - e.g "gpg --detach-sign --armor qpid-proton-${TAG}.tar.gz" + - e.g "sha1sum qpid-proton-${TAG}.tar.gz > qpid-proton-${TAG}.tar.gz.sha" + - e.g "md5sum qpid-proton-${TAG}.tar.gz > qpid-proton-${TAG}.tar.gz.md5" +7. Deploy the Java binaries to a staging repo: + - Run: "tar -xzf qpid-proton-${TAG}.tar.gz" + - Run: "cd qpid-proton-${VERSION}.tar.gz" + - Run: "mvn deploy -Papache-release -DskipTests=true" +8. Close the staging repo: + - Log in at https://repository.apache.org/index.html#stagingRepositories + - Find the new 'open' staging repo just created and select its checkbox. + - Click the 'close' button, provide a description, e.g "Proton ${TAG}" and close the repo. + - Wait a few seconds, hit the 'refresh' button and confirm the repo is now 'closed'. + - Click on the repo and find its URL listed in the summary. +9. Commit artifacts to dist dev repo in https://dist.apache.org/repos/dist/dev/qpid/proton/${TAG} dir. +10. Send email, provide links to dist dev repo and the staging repo. -###After a vote succeeds: -1. bump the master/branch version to 0.x-SNAPSHOT -2. tag rc with final name -3. rename artifacts -4. commit artifacts to qpid-dist -5. update latest link -6. release java stuff from nexus -7. update qpid-site with release content -8. update development roadmap +### After a vote succeeds: + +1. Bump the master/branch version to next 0.x-SNAPSHOT if it wasnt already. +2. Tag the RC with the final name/version. +3. Commit the artifacts to dist release repo in https://dist.apache.org/repos/dist/release/qpid/proton/${RELEASE} dir: + - Rename the files to remove the RC suffix. + - Fix filename within .sha and .md5 checksums or regenerate. +4. Update the 'latest' link in https://dist.apache.org/repos/dist/release/qpid/proton/. +5. Release the staging repo: + - Log in at https://repository.apache.org/index.html#stagingRepositories + - Find the 'closed' staging repo representing the RC select its checkbox. + - Click the 'Release' button and release the repo. +6. Give the mirrors some time to distribute things. +7. Update the website with release content. +8. Update development roadmap. +9. Send release announcement email. --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
