RELEASING.md

How to release

A brief description of how to release/deploy GIB.

Note: Releases and SNAPSHOTs are deployed via nexus-staging-maven-plugin.

Prerequisites

• You must be a collaborator of GIB (or the owner)

• GPG

  • GnuPG download

  • Key is published

  • settings.xml contains something like:

    <profiles>
      <profile>
        <id>ossrh</id>
        <properties>
          <gpg.executable>C:\Program Files (x86)\GnuPG\bin\gpg.exe</gpg.executable>
          <gpg.keyname>your-key-fingerprint</gpg.keyname>
        </properties>
      </profile>
    </profiles>

• OSSRH access

  • OSSRH guide

  • permissions have been granted (may require a ticket by the GIB owner or another collaborator)

  • settings.xml contains something like:

    <servers>
      <server>
        <id>ossrh</id>
        <username>your-OSSRH-Jira-username</username>
        <password>your-OSSRH-Jira-password</password>
      </server>
    </servers>

Perform a release

• ℹ️ project/scm/developerConnection in pom.xml is set to https protocol (not ssh or git)
• mvn -Prelease,ossrh release:prepare
• mvn -Prelease,ossrh release:perform
• see also maven-release-plugin

Deploy a SNAPSHOT

• mvn -Prelease,ossrh clean deploy
• note: pom.xml is left untouched