Release to Maven Central

Prerequisites

GPG

Setup

Follow this tutorial.

Troubleshooting

• No route to host: probably an IPv6 issue. List available servers with gpg-connect-agent --dirmngr 'keyserver --hosttable' and pick one with IPv4, or use ipv4.pool.sks-keyservers.net.
• Inappropriate ioctl for device: GPG_TTY=$(tty); export GPG_TTY does the trick (source https://github.com/pstadler/keybase-gpg-github/issues/11).
• if you have multiple set up keys, make sure to (at least temporarily) define the one needed for the release as the default key, as documented here

SSH

Make sure you created an SSH key and added it to your Github account (see https://help.github.com/articles/adding-a-new-ssh-key-to-your-github-account/).

OSSRH/Maven settings

Make sure your OSSRH JIRA account is properly set up in ~/.m2/settings.xml (see https://github.com/liquigraph/liquigraph/blob/master/deploy-settings.xml).

Release

First steps

Generate the maven plugin site (see the Zsh script in liquigraph-maven-plugin). This script assumes the project is at version XXX-SNAPSHOT and XXX is about to be released.

Once executed, update the Github pages repository (liquigraph.github.io) with liquigraph-maven-plugin/target/site (this last step can be done after the release if you move the site folder into some location outside the project tree).

Release it!

Just run:

1. mvn release:prepare -Prelease-sign-artifacts (SCM label is liquigraph-$VERSION, which should be automatically set) and
2. mvn release:perform -Prelease-sign-artifacts
3. then go to https://oss.sonatype.org/ and validate the release:
   • go to staging repositories and locate Liquigraph
   • verify that all the artifacts are present and close the release
   • then release it!

Next steps

• Edit the release notes (check previous examples for some kind of consistency)
• Update the online documentation
  • do not forget to update the maven plugin pages
  • if the schema has changed, do not forget to add the new version and update the examples
• Update the Homebrew recipes (both in https://github.com/Homebrew/homebrew-core and https://github.com/liquigraph/homebrew-liquigraph)
• Announce on Twitter, slack.neo4j.com (#using-liquigraph- and #share-your-project) and https://community.neo4j.com/