Release process

This page is useful for project admins with release permissions only.

1. Build and test

Ensure that everything is working properly.

mvn clean compile test verify

2. Set the release version

It must not be a snapshot. We can't release with pending changes, so commit.

mvn versions:set -DnewVersion="x.y.z"
git add .
git commit -m '[release] prepare for release x.y.z'

3. Deploy

This will build and push the result to Maven Central. Credentials are stored in a special $HOME/.m2/settings.xml file.

mvn -s /path/to/settings.xml -Prelease -Pcentral deploy

4. Release

Log into Maven Central and release. Click account (top right) and "View Deployments." Click "Publish."

5. Set the next development version

Use a snapshot version.

mvn versions:set -DnewVersion="x.y.Z-SNAPSHOT"
git add .
git commit -m '[release] prepare for next development iteration'