Release Process

Brooklyn is published to two locations:

Sonatype, for snapshots and for staging releases
Maven Central, for full (GA and milestone) releases

Brooklyn artifacts are generally downloaded from:

To publish:

a snapshot release:
- mvn deploy to Sonatype
- (optional) publish versioned docs to brooklyncentral.github.com project
a (milestone) release:
- same as above, but with some git versioning
- deploy to Sonatype, then release to Maven Central
- deploy a version branch to brooklyn-examples
- deploy (or update) versioned docs
a major release:
- same as above, and
- in addition to versioned examples, update brooklyn-examples master to match the current (stable) release
- in addition to versioned docs, publish full (front page) docs to brooklyncentral.github.com project
- bump the snapshot version in brooklyn master to the next release

Configuration

Your .m2/settings.xml must be configured with the right credentials for Sonatype

<servers>
...
    <server>
        <username> ... </username>
        <password> ... </password>
        <id>sonatype-nexus-snapshots</id>
    </server>
    <server>
        <username> ... </username>
        <password> ... </password>
        <id>sonatype-nexus-staging</id>
    </server>
...
</servers>

You must be configured to sign artifacts using PGP.

If this is the first time you have used Sonatype, the Sonatype - Maven Usage Guide is required reading.

The code snippets below use the following variables:

export BROOKLYN_DIR=/path/to/brooklyncentral-brooklyn
export EXAMPLES_DIR=/path/to/brooklyncentral-brooklyn-examples
export SITE_DIR=/path/to/brooklyncentral-brooklyncentral.github.com

export SNAPSHOT_VERSION=0.6.0-SNAPSHOT
export RELEASE_VERSION=0.6.0-M1

Preparing a Snapshot Release

Deploy to Sonatype

Execute the following:

mvn -Dbrooklyn.deployTo=sonatype -DskipTests clean install deploy

(Option) Publish snapshot docs.

(Only required if there have been significant changes to docs or java docs.)

cd $BROOKLYN_DIR/docs
git checkout master

if [ ! -f $SITE_DIR/index.html ] ; then echo "could not find docs in $SITE_DIR" ; exit 1 ; fi

# Build the docs
_scripts/build.sh || { echo "failed to build docs" ; exit 1 ; }

# Wipe any previous edition of the same version, replacing with new build.
rm -rf $SITE_DIR/v/$SNAPSHOT_VERSION
mkdir $SITE_DIR/v/$SNAPSHOT_VERSION
cp -r _site/* $SITE_DIR/v/$SNAPSHOT_VERSION/

# and push, causing GitHub to republish with updated /v/$SNAPSHOT_VERSION/
pushd $SITE_DIR
git add -A .
git commit -m "Updated version docs for version $SNAPSHOT_VERSION"
git push
popd

Preparing a (Milestone) Release

Prepare a Release Branch

cd $BROOKLYN_DIR
git checkout -b $RELEASE_VERSION
usage/scripts/change-version.sh $SNAPSHOT_VERSION $RELEASE_VERSION
git commit -a -m "Changed version to $RELEASE_VERSION"
git push -u upstream $RELEASE_VERSION

Deploy to Sonatype, and Close the repo.

mvn -Dbrooklyn.deployTo=sonatype -DskipTests clean install deploy

Go to oss.sonatype.org ... #stagingRepositories (again, need credentials)
'Close' the repo
Email the closed repo address to brooklyn-dev list, have people download and confirm it works.

Update the brooklyn-examples repo's version Branch

cd $EXAMPLES_DIR

pushd $BROOKLYN_DIR
git checkout $RELEASE_VERSION
popd

if [ ! -d simple-web-cluster ] ; then echo "wrong dir" ; exit 1 ; fi
git checkout master
git checkout -b $RELEASE_VERSION
rm -rf *
cp -r $BROOKLYN_DIR/examples/* .
rm -rf target
git add -A
git commit -m "branch for $RELEASE_VERSION"
git push -u origin $RELEASE_VERSION

Update the Versioned Docs

cd $BROOKLYN_DIR/docs
git checkout $RELEASE_VERSION

if [ ! -f $SITE_DIR/index.html ] ; then echo "could not find docs in $SITE_DIR" ; exit 1 ; fi

# Build the docs
_scripts/build.sh || { echo "failed to build docs" ; exit 1 ; }

# Wipe any previous edition of the same version, replacing with new build.
rm -rf $SITE_DIR/v/$RELEASE_VERSION
mkdir $SITE_DIR/v/$RELEASE_VERSION
cp -r _site/* $SITE_DIR/v/$RELEASE_VERSION/

# and push, causing GitHub to republish with updated /v/$RELEASE_VERSION/
pushd $SITE_DIR
git add -A .
git commit -m "Updated version docs for version $RELEASE_VERSION"
git push
popd

Preparing a Full Release

Complete all above steps.

Deploy to Maven Central

Confirm that the closed Sonatype repo has no errors
Return to Sonatype: Staging Repositories
'Release' the repo

Deploy the Examples master branch.

cd $EXAMPLES_DIR

pushd $BROOKLYN_DIR
git checkout $RELEASE_VERSION
popd

if [ ! -d simple-web-cluster ] ; then echo "wrong dir" ; exit 1 ; fi
git checkout master
rm -rf *
cp -r $BROOKLYN_DIR/examples/* .
rm -rf target
git add -A
git commit -m "Updated to $RELEASE_VERSION"
git push -u origin master

Update the brooklyn.io Front Page Version

cd $BROOKLYN_DIR/docs

pushd $SITE_DIR
# remove old root files, but not the previous version in /v/
if [ -f start/index.html ] ; then
  for x in * ; do if [[ $x != "v" ]] ; then rm -rf $x ; fi ; done
else
  echo IN WRONG DIRECTORY $SITE_DIR - export SITE_DIR to continue
  exit 1
fi
popd

# re-build for hosting at / rather than at /v/VERSION/
_scripts/build.sh --url "" || { echo "failed to build docs" ; exit 1 ; }

# copy to site dir
cp -r _site/* $SITE_DIR/

# and git push
pushd $SITE_DIR
git add -A .
git commit -m "Updated root docs for version $RELEASE_VERSION"
git push
popd

Announce

Email the Dev and Users mailing lists.
Tweet from @brooklyncentral

Update Snapshot Version

export NEW_SNAPSHOT_VERSION=0.7.0-SNAPSHOT

cd $BROOKLYN_DIR
git checkout master
usage/scripts/change-version.sh $SNAPSHOT_VERSION $NEW_SNAPSHOT_VERSION
git commit -a -m "Changed version to $NEW_SNAPSHOT_VERSION"
git push -u upstream master