SO业务编排>> releaser>> 返回
项目作者： introproventures

项目描述 ：
Sonatype Nexus Artifact Repository Releaser Starter Maven Project
高级语言：
项目地址: git://github.com/introproventures/releaser.git
创建时间： 2017-09-24T04:03:51Z
项目社区：https://github.com/introproventures/releaser
开源协议：Apache License 2.0
下载


Nexus Releaser

Summary

It’s a minimal a reference example for setting up your project to deploy to Maven Central with staging release to Nexus Sonatype repository https://oss.sonatype.org/

This project is based on these instructions from: https://github.com/davidcarboni/releaser

Using Nexus Releaser

There are two files of interest in this project:

  • pom.xml - a POM file that meets Maven Central requirements and defines a deployment configuration
  • settings.xml - a Maven user settings file that defines release deployment configuration

These are set up initially to test with a local Nexus instance, but also contain the Sonatype OSS repository information, commented out.

You’ll also need to follow the instructions for setting up a Sonatype Jira account and creating a ticket here: http://central.sonatype.org/pages/ossrh-guide.html#create-a-ticket-with-sonatype

GPG key generation

Here’s a terse summary of the GPG commands you’ll need to generate and publish a key for signing your artifacts. For the full version, see https://docs.sonatype.org/display/Repository/How+To+Generate+PGP+Signatures+With+Maven

  1. # is GPG installed?
  2. gpg --version 
  4. # Generate a key. If in doubt, accept defaluts. I'd recommend a 3072-bit key:
  5. gpg --gen-key
  7. # Check what was generated:
  8. gpg --list-keys
  9. gpg --list-secret-keys
  10. # You should see:
  11. # pub nnnnA/FFFFFFFF YY-MM-DD
  12. # ... etc ...
  13. # make a note of FFFFFFFF - this is your key ID
  15. # Check for sub keys:
  16. gpg --edit-key FFFFFFFF
  17. # If any "sub" key says "usage: S", refer to the URL above for instructions on deleting it.
  19. # Publish key:
  20. gpg --keyserver hkp://pool.sks-keyservers.net --send-keys FFFFFFFF

Test with a local Nexus instance

Try running with a local Nexus instance to get the hang of it:

  • Map docker machine host port 8081 to guest container port 8081 in VirtualBox machine instance network settings.
  • Run Nexus Docker image with binding the exposed port 8081 to the host: docker run -d -p 8081:8081 --name nexus sonatype/nexus:oss
  • Test Nexus instance is running: curl http://localhost:8081/nexus/service/local/status
  • Check instance logs with docker logs nexus
  • open http://localhost:8081/nexus
  • the default Nexus deployment username and password are already set in the example Maven settings.xml in the root of this project.
  • if you do practice releases, note that the tags created by the release plugin will get pushed to your remote so you’ll need to delete them after practice runs. Deleting remote tags isn’t obvious so here’s a post that explains how: http://nathanhoad.net/how-to-delete-a-remote-git-tag.

The summary is:

  1.  git tag -d 0.0.1
  2.  git push origin :refs/tags/0.0.1

Deploy artifact locally

Run mvn clean deploy to build and deploy your project in local Maven repository

Maven Nexus release POM configuration

The standard Maven plugin used by a Release Process is the maven-release-plugin – the configuration for this plugin is minimal:

  1. <plugin>
  2.    <groupId>org.apache.maven.plugins</groupId>
  3.    <artifactId>maven-release-plugin</artifactId>
  4.    <version>2.4.2</version>
  5.    <configuration>
  6.       <tagNameFormat>@{project.version}</tagNameFormat>
  7.       <autoVersionSubmodules>true</autoVersionSubmodules>
  8.       <releaseProfiles>releases</releaseProfiles>
  9.    </configuration>
  10. </plugin>

What is important here is that the releaseProfiles configuration will actually force a Maven profile – the releases profile – to become active during the Release process.

It is in this process that the nexus-staging-maven-plugin is used to perform a deploy to the localhost-nexus-staging Nexus repository:

  1. <profiles>
  2.    <profile>
  3.       <id>releases</id>
  4.       <build>
  5.          <plugins>
  6.             <plugin>
  7.                <groupId>org.sonatype.plugins</groupId>
  8.                <artifactId>nexus-staging-maven-plugin</artifactId>
  9.                <version>1.6.7</version>
  10.                <executions>
  11.                   <execution>
  12.                      <id>default-deploy</id>
  13.                      <phase>deploy</phase>
  14.                      <goals>
  15.                         <goal>deploy</goal>
  16.                      </goals>
  17.                   </execution>
  18.                </executions>
  19.                <configuration>
  20.                   <serverId>localhost-nexus-staging</serverId>
  21.                   <nexusUrl>http://localhost:8081/nexus/</nexusUrl>
  22.                   <skipStaging>true</skipStaging>
  23.                </configuration>
  24.             </plugin>
  25.          </plugins>
  26.       </build>
  27.    </profile>
  28. </profiles>

The plugin is initially configured to perform the Release process without the staging mechanism (skipStaging=true).

If you perform release to a local Nexus OSS repository, you will need to skip staging with <skipStaging>true</skipStaging> tag in nexus-staging-maven-plugin <configuration>. Otherwise, you will get an error Nexus instance does not support staging workflow v2, i.e.:

  1.     <configuration>
  2.         <serverId>localhost-nexus-staging</serverId>
  3.         <nexusUrl>http://localhost:8081/nexus</nexusUrl>
  4.         <skipStaging>true</skipStaging>
  5.     </configuration>

For public Nexus releases, use the following configuration in nexus-staging-maven-plugin:

  1.     <configuration>
  2.         <serverId>sonatype-nexus-staging</serverId>
  3.         <nexusUrl>https://oss.sonatype.org/</nexusUrl>
  4.         <autoReleaseAfterClose>false</autoReleaseAfterClose>
  5.     </configuration>

Maven release process to Nexus repository

Let’s break apart the release process into small and focused steps. We are performing a Release when the current version of the project is a SNAPSHOT version – say 0.0.1-SNAPSHOT.

Ensure your artifact version is a -SNAPSHOT, then run the following:

  1. mvn release:clean

Cleaning a Release will:

delete the release descriptor (release.properties)
delete any backup POM files

  1. mvn release:prepare

Next part of the Release process is Preparing the Release; this will:

perform some checks – there should be no uncommitted changes and the project should depend on no SNAPSHOT dependencies
change the version of the project in the pom file to a full release number (remove SNAPSHOT suffix) – in our example – 0.0.1
run the project test suites
commit and push the changes
create the tag out of this non-SNAPSHOT versioned code
increase the version of the project in the pom – in our example – 0.0.2-SNAPSHOT
commit and push the changes

  1. mvn release:perform

The last part of the Release process is Performing the Release; this will:

checkout release tag from SCM
build and deploy released code
auto-sign artifacts with your gpg.passphrase from settings.xml
This step of the process relies on the output of the Prepare step – the release.properties.

For more options, including rolling back a release or cleaning up a failed release, see: http://maven.apache.org/maven-release/maven-release-plugin/

If you find that the release is deploying a SNAPSHOT version instead of the release artifact, it may be because the release process has changed since I first uploaded this project to Github. I’ve updated these instructions to match, so just check your release plugin configuration matches the example in this project.

Next steps

Once you’re set up with Sonatype, have deployed your artifacts and commented on your Jira ticket, you’ll need to follow these instructions in order to complete the process:

http://central.sonatype.org/pages/ossrh-guide.html

Here are the specific Maven instructions, including the nexus-staging-maven-plugin setup:

http://central.sonatype.org/pages/apache-maven.html

Credits

David Carboni https://github.com/davidcarboni/releaser

Baeldung http://www.baeldung.com/maven-release-nexus