You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 50 Next »

This page describes how to make a release of Whirr. It is based on a combination of the guide for Tapestry (thanks to the Tapestry team for sharing this!), and the Hadoop release process.

See also How To Contribute for more background on building Whirr.

First time as a release manager.

  1. Generate PGP code signing keys
  2. Ensure that your PGP signing keys are available in: http://svn.apache.org/repos/asf/incubator/whirr/dist/KEYS More details can be found here.
  3. Copy the new KEYS file to the release folder /www/www.apache.org/dist/incubator/whirr on people.apache.org

If you are not already a member of the Web Of Trust (WOT) it would be a good idea to do so. (contact one of the prior release managers, e.g. Tom, Patrick, etc...). You can read more about key signing here.

You need to be a member of the "incubator" unix group on people.apache.org. Ask for help on the incubator general@ list. Here's an example http://bit.ly/9Wkdzg

While the project is still in the incubator you will also need permissions (whirr deployer role) on Nexus. You should be able to see the Staging Repositories in the left panel and if this is not possible ask the INFRA guys to give you the needed permissions (e.g. INFRA-3482).

Ensure that you have setup your ssh keys on people.apache.org, otherwise you'll have to enter your login password a number of times (best use ssh-agent for this as well). A good overview of this process can be found here (ssh-copy-id and ssh-agent in particular)

Create a Release Series Branch

This only needs doing if this is the first release in a series (X.Y.0).

  • Update CHANGES.txt in trunk to replace Trunk (unreleased changes) with Release X.Y.0 - YYYY-MM-DD. Commit: 
    svn commit -m "Preparing for release X.Y.Z-incubating"
  • Create a branch for the release series: 
    svn copy https://svn.apache.org/repos/asf/incubator/whirr/trunk \
https://svn.apache.org/repos/asf/incubator/whirr/branches/branch-X.Y -m "Branching for X.Y releases"
  • Add back Trunk (unreleased changes) to CHANGES.txt in trunk.
  • Bump the version number in trunk (the update-versions script mangles the whitespace in the root XML element): 
    for file in $(find . -name pom.xml); do
  sed -i "" -e "s/0.1.0-incubating-SNAPSHOT/0.2.0-incubating-SNAPSHOT/" $file;
done
  • Bump the version in src/site/confluence/whirr-in-5-minutes.confluence.
  • Commit these changes to trunk.
  • Checkout the release branch 
    svn checkout https://svn.apache.org/repos/asf/incubator/whirr/branches/branch-X.Y

Update the Release Branch

The version number in the release branch ends in -SNAPSHOT, but we need to remove this for the release. For example, 0.1.0-incubating-SNAPSHOT needs to be changed to 0.1.0-incubating.

for file in $(find . -name pom.xml); do
  sed -i "" -e "s/0.1.0-incubating-SNAPSHOT/0.1.0-incubating/" $file;
done

Run Tests

Run all the unit and integration tests (which means you should have cloud credentials to run on a cloud provider) with the following:

mvn clean verify -Pintegration -DargLine='-Dwhirr.test.provider=<cloud-provider> -Dwhirr.test.identity=<cloud-provider-user> -Dwhirr.test.credential=<cloud-provider-secret-key>'

Generate the Release Notes

JIRA has the ability to generate release notes automatically (this is why it is so important to keep the fix version number accurate).

https://issues.apache.org/jira/secure/ConfigureReleaseNote.jspa?projectId=12311110

Manually check this list for accuracy! I've repeatedly seen closed bugs that were not fixed (i.e., duplicate) marked with a fix version, so that they incorrectly show up in this list. Find those, edit them to remove the fix release (only actually fixed bugs should have a fix release) and re-run the report.

Select the correct version, in HTML format.

Paste the notes to the top of src/site/xdoc/release-notes.xml. Check this into trunk and the branch.

Wrap the title ("Release Notes - Whirr - Version X.Y.Z-incubating") inside an <h1> element.

Build and Deploy Artifacts

Create a maven settings file ~/.m2/settings.xml with the following content:

<settings>
<servers>
<server>
     <id>apache.snapshots.https</id>
     <username>APACHE-ID</username>
     <password>APACHE-PASSWORD</password>
   </server>
   <server>
     <id>apache.staging.https</id>
     <username>APACHE-ID</username>
     <password>APACHE-PASSWORD</password>
   </server>
   <server>
     <id>apache.releases.https</id>
     <username>APACHE-ID</username>
     <password>APACHE-PASSWORD</password>
   </server>
</servers>
</settings>

Build the artifacts:

mvn site
mvn package assembly:assembly

The following command deploys the artifacts, checksums, and signatures (you will need to enter a GPG passphrase) to the Apache Staging repo.

mvn deploy -Ppackage -Pdeploy -Pjavadoc

If this step fails with an Access denied error check that you have the required permissions on Nexus. While the project is still in the incubator you will need to have a whirr deployer role attached to your account on Nexus. When you login you should be able to see the Staging Repositories in the left panel and if this is not possible ask the INFRA guys to give you the needed permissions (e.g. INFRA-3482).

Login to https://repository.apache.org using your Apache SVN credentials. Click on Staging on the left. Then click on org.apache.whirr in the list of repositories. In the panel below you should see an open repository that is linked to your username and IP. Select this repository and click Close. This will close the repository from future deployments and make it available for others to view.

Copy Release Artifacts

The artifacts that end up in the distribution directory are the source and binary distributions (along with their checksums and signatures), so they need to be copied from the Maven repo to the release directory on people.apache.org so folks can vote on them:

TODO: update the instructions, the artifacts should be placed in a subdirectory rather than all at the toplevel

ssh people.apache.org
VERSION=X.Y.Z
mkdir ~/public_html/whirr-$VERSION-incubating-candidate-0
cd ~/public_html/whirr-$VERSION-incubating-candidate-0
for ext in "" .asc .md5 .sha1; do
  wget --no-check-certificate https://repository.apache.org/content/repositories/orgapachewhirr-[YOUR REPOSITORY ID]/org/apache/whirr/whirr/$VERSION-incubating/whirr-$VERSION-incubating-src.tar.gz$ext
done

Now we need to create the binary distribution checksums and signatures (since Maven doesn't currently do this - if anyone know how to fix this, then please let us know!):

VERSION=X.Y.Z
cd target
md5 whirr-$VERSION-incubating.tar.gz > whirr-$VERSION-incubating.tar.gz.md5
shasum whirr-$VERSION-incubating.tar.gz > whirr-$VERSION-incubating.tar.gz.sha1
gpg --armor --output whirr-$VERSION-incubating.tar.gz.asc --detach-sig whirr-$VERSION-incubating.tar.gz
scp -p whirr-$VERSION-incubating.tar.gz* people.apache.org:public_html/whirr-$VERSION-incubating-candidate-0

Sanity Check

Download the artifacts and try them out by running the quick start instructions, for example.

Commit and Tag

Commit changes to subversion, and tag:

svn commit -m "Preparing for release X.Y.Z-incubating"
svn copy https://svn.apache.org/repos/asf/incubator/whirr/branches/branch-X.Y https://svn.apache.org/repos/asf/incubator/whirr/tags/release-X.Y.Z-incubating -m "Whirr X.Y.Z-incubating release."

Run the Vote

Run the vote in parallel on the whirr-dev@ list and on the incubator general@ list (1 email).

Here is an example email:

To: "Whirr Developers List" <whirr-dev@incubator.apache.org>, "Incubator General" <general@incubator.apache.org>
Subject: [VOTE] Release Whirr version X.Y.Z-incubating

This is the first incubator release for Apache Whirr, version X.Y.Z-incubating. 

It fixes the following issues:
https://issues.apache.org/jira/secure/ReleaseNote.jspa?version=12315111&styleName=Html&projectId=12311110

*** Please download, test and vote by [3 working days after sending].

Note that we are voting upon the source (tag), binaries are provided for convenience.

Source and binary files:
http://people.apache.org/~[YOUR USERID]/whirr-X.Y.Z-incubating-candidate-0

Maven staging repo:
https://repository.apache.org/content/repositories/orgapachewhirr-[YOUR REPOSITORY ID]

The tag to be voted upon:
http://svn.apache.org/repos/asf/incubator/whirr/tags/release-0.1.0-incubating

Whirr's KEYS file containing PGP keys we use to sign the release:
http://svn.apache.org/repos/asf/incubator/whirr/dist/KEYS

Note that the Incubator PMC needs to vote upon the release after a
successful PPMC vote before any release can be made official.

The release needs 3 +1 votes from the IPMC.

Roll Out

Assuming the vote passes, the release can be rolled out as follows:

TODO the order should be fixed, it should be move the artifacts into place, wait for it to be mirrored, then push the site

Build and Deploy Site

mvn site-deploy

TODO: give more insight into what's happening in this stage. It failed for me and it wasn't clear what I should do, or where I might look, or what I should expect this stage to do.

TODO: give instructions on how to use the apache proxy to verify this is staged properly before it's been mirrored (you can setup your browser with the apache proxy to see the new/unmirrored content).

Move Artifacts into Place

ssh people.apache.org
cp -r ~/public_html/whirr-X.Y.Z-incubating-candidate-0 /www/www.apache.org/dist/incubator/whirr/whirr-X.Y.Z-incubating
cd /www/www.apache.org/dist/incubator/whirr
chgrp -R incubator whirr-X.Y.Z-incubating
chmod -R g+w whirr-X.Y.Z-incubating
rm stable
ln -s whirr-X.Y.Z-incubating stable
rm /www/www.apache.org/dist/incubator/whirr/whirr-0.1.0-*

The last line is to remove the previous version, since only the latest version should be in the dist directory (older versions are archived automatically).

Login to https://repository.apache.org, click on Staging on the left. Select the repository that you closed earlier, and click Release, using a description like "Apache Whirr 0.1.0-incubating artifacts". This will make the artifacts publicly available.

Wait 24 Hours

It takes up to 24 hours for all the mirrors to sync, so don't announce the new release just yet.

Announce the Release

TODO: Add a news section to the website.

Send an email to announce@apache.org (the from: address must be @apache.org). E.g.

To: announce@apache.org
Subject: [ANNOUNCE] Apache Whirr 0.1.0-incubating released

The Apache Whirr team is pleased to announce the release of Whirr
0.1.0-incubating from the Apache Incubator.

This is the first release of Apache Whirr, a set of libraries for
running cloud services such as Apache Hadoop, HBase, ZooKeeper, and
Cassandra.

The release is available here:
http://www.apache.org/dyn/closer.cgi/incubator/whirr/

The full change log is available here:
https://issues.apache.org/jira/browse/WHIRR/fixforversion/12315111

We welcome your help and feedback. For more information on how to
report problems, and to get involved, visit the project website at
http://incubator.apache.org/whirr/

The Apache Whirr Team

Update the incubator status file in https://svn.apache.org/repos/asf/incubator/public/trunk/site-author/projects/whirr.xml

Add the Next Release to JIRA

Add the next version number (e.g. 0.2.0-incubating after 0.1.0-incubating) to JIRA using this link: https://issues.apache.org/jira/secure/project/ManageVersions.jspa?pid=12311110.

In JIRA mark the released version as "released" on the "manage versions" page. Be sure to fill in a date if not already specified.

  • No labels