You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@twill.apache.org by ch...@apache.org on 2015/02/19 03:33:05 UTC
incubator-twill git commit: Update release guide.
Repository: incubator-twill
Updated Branches:
refs/heads/site 6c42a9b8d -> fe3bd5d39
Update release guide.
Project: http://git-wip-us.apache.org/repos/asf/incubator-twill/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-twill/commit/fe3bd5d3
Tree: http://git-wip-us.apache.org/repos/asf/incubator-twill/tree/fe3bd5d3
Diff: http://git-wip-us.apache.org/repos/asf/incubator-twill/diff/fe3bd5d3
Branch: refs/heads/site
Commit: fe3bd5d3988dd2fff2c4efd9d080e49e56b4586d
Parents: 6c42a9b
Author: Terence Yim <ch...@apache.org>
Authored: Wed Feb 18 18:33:01 2015 -0800
Committer: Terence Yim <ch...@apache.org>
Committed: Wed Feb 18 18:33:01 2015 -0800
----------------------------------------------------------------------
src/site/markdown/ReleaseGuide.md | 58 ++++++++++++++++++++++------------
1 file changed, 37 insertions(+), 21 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-twill/blob/fe3bd5d3/src/site/markdown/ReleaseGuide.md
----------------------------------------------------------------------
diff --git a/src/site/markdown/ReleaseGuide.md b/src/site/markdown/ReleaseGuide.md
index b3782fe..801ac20 100644
--- a/src/site/markdown/ReleaseGuide.md
+++ b/src/site/markdown/ReleaseGuide.md
@@ -49,35 +49,46 @@ mvn release:prepare
1. Create a new release branch:
```
- git branch -a branch-[RELEASE_VERSION]
+ git checkout -b branch-[RELEASE_VERSION]
```
The `[RELEASE_VERSION]` is something like `0.5.0`.
+
+1. Update the project version:
+
+ ```
+ mvn versions:set -DgenerateBackupPoms=false -DnewVersion=[RELEASE_VERSION]-incubating
+ git commit . -m "Prepare for release [RELEASE_VERSION]-incubating"
+ ```
1. Create a new signed tag for the release:
+ ```
+ git tag -s v[RELEASE_VERSION]-incubating -m 'Releasing [RELEASE_VERSION]-incubating' -u [SIGN_KEY_ID]
```
- git tag -s v[RELEASE_VERSION]-incubating -m 'Releasing [RELEASE_VERSION]-incubating'
- ```
+
1. Push both the new branch and the tag:
```
- git push origin release/[RELEASE_VERSION]
- git push origin v[RELEASE_VERSION]
+ git push origin branch-[RELEASE_VERSION]
+ git push origin v[RELEASE_VERSION]-incubating
```
+
1. Run `gpg-agent` to save the number of times that you have to type in your GPG password
when building release artifacts. You can run `gpg -ab` to confirm the agent is running and
cached your password correctly. Alternatively, if you don't want to run GPG agent, you can
specify your GPG password through `-Dgpg.passphrase=[GPG_PASSWORD]` when running Maven.
+
1. Build the source tarball and publish stage artifacts to the staging repo:
```
- mvn clean package -DskipTests -P hadoop-2.0 &&
- mvn package -DskipTests -P hadoop-2.3 &&
- mvn deploy -DskipTests -P hadoopp-2.3 -P apache-release
+ mvn clean package -DskipTests -P hadoop-2.0 &&
+ mvn package -DskipTests -P hadoop-2.3 &&
+ mvn deploy -DskipTests -P hadoop-2.3 -P apache-release
```
The source tarball could be found in `target/twill-[RELEASE_VERSION]-incubating-source-release.tar.gz`
after the above command completed successfully.
-1. Compute the MD5 and SHA512 of the source release tarball.
+
+1. Compute the MD5 and SHA512 of the source release tarball.
```
cd target
@@ -85,48 +96,53 @@ mvn release:prepare
shasum -a 512 twill-[RELEASE_VERSION]-incubating-source-release.tar.gz > twill-[RELEASE_VERSION]-incubating-source-release.tar.gz.sha512
```
1. Checkin the source release tarball, together with the signature, md5 and sha512 files to `dist.apache.org/repos/dist/dev/incubator/twill/[RELEASE_VERSION]-incubating-rc1/src/`
+
1. Create a `CHANGES.txt` file to describe the changes in the release and checkin the file to `dist.apache.org/repos/dist/dev/incubator/twill/[RELEASE_VERSION]-incubating-rc1/CHANGES.txt`
+
1. Go to [https://repository.apache.org](https://repository.apache.org) and close the staging repository.
+
1. Create a vote in the dev mailing list and wait for 72 hours for the vote result. Here is a tempalte of the email:
```
Subject: [VOTE] Release Apache Twill-[RELEASE_VERSION]-incubating [rc1]
=======================================================================
-
+
Hi all,
This is to call for a vote on releasing Apache Twill [RELEASE_VERSION]-incubating, release candidate 1. This
is the [Nth] release for Twill.
-
+
The source tarball, including signatures, digests, etc can be found at:
https://dist.apache.org/repos/dist/dev/incubator/twill/[RELEASE_VERSION]-incubating-rc1/src
-
+
The tag to be voted upon is v[RELEASE_VERSION]-incubating:
https://git-wip-us.apache.org/repos/asf?p=incubator-twill.git;a=shortlog;h=refs/tags/v[RELEASE_VERSION]-incubating
-
+
The release hash is [ref]
https://git-wip-us.apache.org/repos/asf?p=incubator-twill.git;a=commit;h=[ref]
-
+
The Nexus Staging URL:
https://repository.apache.org/content/repositories/orgapachetwill-[stageid]
-
+
Release artifacts are signed with the following key:
[URL_TO_SIGNER_PUBLIC_KEY]
-
+
KEYS file available here:
https://dist.apache.org/repos/dist/dev/incubator/twill/KEYS
-
+
For information about the contents of this release see:
https://dist.apache.org/repos/dist/dev/incubator/twill/[RELEASE_VERSION]-incubating-rc1/CHANGES.txt
-
+
Please vote on releasing this package as Apache Twill [RELEASE_VERSION]-incubating
-
+
The vote will be open for 72 hours.
-
+
[ ] +1 Release this package as Apache Twill [RELEASE_VERSION]-incubating
[ ] +0 no opinion
[ ] -1 Do not release this package because ...
-
+
Thanks,
Terence
```
+
+1. After the vote passed in the dev mailing list. Create a vote in the `general@` mailing list for the IPMC to vote on the release.