Release procedure

Making a Release

Checklist

1. Update the README file with important information.

2. Update the NEWS and CHANGES files with important information.

3. Update the acinclude.m4 file with version information.

Preparing the Release

repos="https://svn.apache.org/repos/asf/couchdb"

svn cp $repos/trunk $repos/branches/Y.Y.x -m 'branching Y.Y.x'
svn cp $repos/branches/Y.Y.x $repos/tags/Y.Y.Y -m 'tagging Y.Y.Y'
svn export $repos/tags/Y.Y.Y export

You must then use the export directory to prepare the release.

To build the source for distribution you should then run the following command:

./bootstrap && ./configure && make distsign

If everything was successful you should see the following files sitting in the export directory ready for distribution:

• apache-couchdb-Y.Y.Y.tar.gz

• apache-couchdb-Y.Y.Y.tar.gz.asc

• apache-couchdb-Y.Y.Y.tar.gz.md5

• apache-couchdb-Y.Y.Y.tar.gz.sha

Upload these to your public_html directory on people.apache.org and make sure they are world readable.

Calling a Vote

Call a vote on the couchdb-dev mailing list:

• example couchdb-dev vote

• example couchdb-dev vote results

Update these links to most recent vote after it has been archived.

Making the Release

• Copy the release directory to /www/www.apache.org/dist/couchdb on people.apache.org.

• Update http://couchdb.apache.org/downloads.html

• Wait for all changes to be synced to public mirrors.

• Make a release announcement to the announce@apache.org, user@couchdb.apache.org, and dev@couchdb.apache.org mailing lists:

  • example release announcement

• Make a ticket in the infrastructure JIRA for new release options in the CouchDB JIRA.

  • If the currently released version is 0.1.0, JIRA should have options for 0.1.1, 0.2.0, and 0.3.0.

Useful Resources

• http://www.apache.org/dev/release.html

• http://incubator.apache.org/guides/releasemanagement.html#best-practice