8.2. Release process

This is the procedure that should be followed for making an official JQM release.

8.2.1. Environment

The release environment must have:

  • PGP & the release private key
  • The Selenium setup (see Testing)
  • Internet access
  • Login & password to Sonatype OSSRH.

8.2.2. Update release notes

Add a chapter to the release notes & commit the file.

8.2.3. Checkout

Check out the branch master with git.

8.2.4. Full build & tests

There is no distinction between tests & integration tests in JQM so this will run all tests.

mvn clean install -Pselenium

8.2.5. Sonar snapshot

This will run all tests once again.

mvn sonar:sonar

Once done, take a snaphot in Sonar.

8.2.6. Release test

The release plug-in is (inside the pom.xml) parametrized to use a local git repository, so as to allow mistakes. During that step, all packages are bumped in version number, even if they were not modified.

mvn release:prepare -Darguments='-DskipTests'
mvn package

Then the test package must be test-deployed in a two-node configuration.

8.2.7. Release

This will upload the packages to the OSSRH staging repository.:

mvn release:perform -Darguments='-DskipTests'

8.2.7.1. OSSRH validation

Go to https://oss.sonatype.org/ and unstage the release. This will in time allow synchronization with Maven Central.

8.2.8. Git push

At this step, the release is done and the local git modifications can be pushed to the central git repository on GitHub.

Warning

when using GitHub for Windows, tags are not pushed during sync. Using the command line is compulsory.

git push origin --tags

8.2.9. GitHub upload

Create a release inside GitHub and upload the zip and tar.gz produced by the jqm-engine project.