Merge lp:~pbeaman/akiban-persistit/maven-central-release-script into lp:akiban-persistit

[Peter Beaman]

Add a script to assit with publishing releases to Maven Central.

The script requires a signing key and access to the Akiban Persistit account. We could automate the process further by hooking up the Nexus Maven Plugin, but by assembling a bundle jar automatically and carefully documenting the steps needed to publish, most of the effort of re-reading the documentation for every release has been removed.

When run, the script produces a file target/bundle.jar containing signed artifacts. Then it emits instructions on how to upload and deploy the release on Maven Central.

LBJ: NO_BUILD

[Nathan Williams (nwilliams)]

The first line is missing ! and it should be /bin/bash since you're using pushd/popd.

Would be nice to automate it the rest of the way with the nexus plugin, but this is better than nothing.

review: Needs Fixing

[Peter Beaman (pbeaman)]

Embarrassing. I tested it by calling "sh prepare-maven-central.sh" and never as an executable. My bad. Thanks.

[Nathan Williams (nwilliams)]

Not a problem. Looks good now!

review: Approve

[Akiban Build User (build-akiban)]

There were 2 failures during build/test:

* job persistit-build failed at build number 503: http://172.16.20.104:8080/job/persistit-build/503/

* view must-pass failed: persistit-build is red

review: Needs Fixing

[lp:~pbeaman/akiban-persistit/maven-central-release-script]

407. By Peter Beaman on 2012-12-03

Add missing license header

[Peter Beaman (pbeaman)]

Grrr. Add the missing license header.

=== added file 'src/etc/prepare-maven-central.sh'
--- src/etc/prepare-maven-central.sh	1970-01-01 00:00:00 +0000
+++ src/etc/prepare-maven-central.sh	2012-12-03 21:42:20 +0000
@@ -0,0 +1,51 @@
+#!/bin/bash
+#
+# Copyright © 2012 Akiban Technologies, Inc.  All rights reserved.
+# 
+# This program and the accompanying materials are made available
+# under the terms of the Eclipse Public License v1.0 which
+# accompanies this distribution, and is available at
+# http://www.eclipse.org/legal/epl-v10.html
+# 
+# This program may also be available under different license terms.
+# For more information, see www.akiban.com or contact [e-mail].
+# 
+# Contributors:
+# Akiban Technologies, Inc.
+#
+# 
+# See https://docs.sonatype.org/display/Repository/Sonatype+OSS+Maven+Repository+Usage+Guide
+#
+# Run this script from the base directory.
+#
+# Package and sign artifacts.  You will need a signing key in your gpg keyring. Follow
+# these instructions to set up gpg and generate a key-pair. You only need to do this once:
+#
+#    https://docs.sonatype.org/display/Repository/How+To+Generate+PGP+Signatures+With+Maven
+#
+# The gpg:sign will ask you to enter a passphrase to access your key chain.
+#
+mvn clean javadoc:jar package gpg:sign -Dmaven.test.skip=true
+#
+# Create a bundle jar.
+#
+pushd target
+jar cvf bundle.jar akiban-persistit*
+popd
+#
+# Note: the Nexus Maven Plugin can do this automatically, but for now we are still manual.
+#
+echo =======================================================================================================
+echo 1. Log in to your account on https://oss.sonatype.org/index.html#stagingRepositories
+echo 2. Click \"Staging Upload\"
+echo 3. Select Upload Mode \"Artifact Bundle\"
+echo 4. Click \"Select Bundle to Upload\"
+echo 5. Navigate to the file target/bundle.jar just created
+echo 6. Click \"Upload Bundle\"
+echo 7. Follow instructions in 
+echo
+echo    https://docs.sonatype.org/display/Repository/Sonatype+OSS+Maven+Repository+Usage+Guide#SonatypeOSSMavenRepositoryUsageGuide-8a.ReleaseIt
+echo
+echo to close and release the staging repository.
+echo =======================================================================================================
+