Skip to content
Permalink
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
82 lines (60 sloc) 2.41 KB

Release Guide

The following walks through how we make a release.

Before releasing

Pop onto IRC and let folks know you are about to cut a release.

Also, pull master and make sure things build locally fine first.

Sonatype OSSRH Account

Hawtio relies on Sonatype OSSRH (OSS Repository Hosting) for releasing, so you need to have an account and be given the access right to the project.

If you haven't got it yet, follow this guide to acquire it: https://central.sonatype.org/pages/ossrh-guide.html

Once you get the account, set up your default Maven settings ($HOME/.m2/settings.xml) with the Sonatype credentials and GPG passphrase to use for releasing:

    <servers>
        <server>
            <id>oss-sonatype-staging</id>
            <username>myuser</username>
            <password>mypassword</password>
        </server>
        <server>
            <id>oss-sonatype-snapshots</id>
            <username>myuser</username>
            <password>mypassword</password>
        </server>
    </servers>

    <profiles>
        <profile>
            <id>release</id>
            <properties>
                <gpg.passphrase>mypassphrase</gpg.passphrase>
            </properties>
        </profile>
    </profiles>

Releasing

Use the two scripts for releasing a version of Hawtio:

  • deploy-release
./bin/deploy-release
Use this script to release a Hawtio version from the snapshot master branch.

Usage:
  deploy-release <release_version> <next_snapshot_version> [path to m2 settings file]
  • release-only
./bin/deploy-release
Use this script to release a Hawtio version from an existing tag.
It is normally used when a tag has been published to GitHub but
releasing it to OSSRH has failed for some reason.

Usage:
  release-only <release_version> [path to m2 settings file]

So, for example, if you want to release version 2.8.0 then normally all you need to do is run the following command:

./bin/deploy-release 2.8.0 2.9-SNAPSHOT

After releasing

Go to GitHub releases page and draft a new release based on the tag you have just released (e.g. hawtio-2.8.0) with release notes, then publish it.

Finally tweet the new release from @hawtio to let the community know!

You can’t perform that action at this time.