Skip to main content
Version: Release 23.3

Nexus Triggers

The Release Nexus trigger allows Release to interact with Sonatype Nexus repositories. It uses the Nexus Server REST API to communicate and fetch information from Nexus repositories.

A Nexus trigger periodically polls a Nexus server for new versions of a specific artifact. Later, triggers a release if a new version is published to the repository that is being watched.

Compatibility​

The Release Nexus trigger is compatible with Nexus 2 and Nexus 3.

Set up a Nexus server​

  1. In Release, from the navigation pane, under Nexus: Server, go to Configuration > Connections and click +.

  2. In the Title box, type the Nexus server name.

  3. In the URL box, type the server address.

  4. In the Username and Password boxes, type the server's username and password respectively.

  5. Click Save to save the server.

    Nexus Server

Add a Nexus trigger to a template​

  1. Add a trigger to the template, as described in Create a release trigger.

  2. In the Group Id box, type the artifact group ID.

  3. In the Artifact Id box, type the artifact ID.

  4. In the Version box, type the artifact version.

    Here, you can use LATEST (default), RELEASE, and snapshot versions (such as 1.0-SNAPSHOT). Specify LATEST to trigger on both release and snapshot versions of a particular artifact. With RELEASE, only release versions will be tracked. Triggering redeployments of release versions (such as 1.0.0) is not supported.

  5. In the Packaging box, optionally type the packaging type of the artifact (such as jar or war).

  6. In the Classifier box, optionally type the classifier of the artifact.

  7. In the Extension box, optionally type the artifact's extension.

  8. If you want to suppress errors when an artifact is not found for the given GAV coordinates, select Trigger On Initial Publish.

Note: Select this option when the artifact was never published to Nexus and you want to trigger a release on the initial publish.

  1. In the Username and Password boxes, type the username and password to connect to the server. If set, these will override the credentials defined in the Nexus server configuration.
  2. Save the trigger, as described in Create a release trigger.
note

The trigger requires a POM file to exist in the artifact directory. If you are using the Nexus Artifact Uploader plugin for Jenkins, note that it does not upload the POM file.

Output properties​

The output properties of the Nexus trigger are:

  • Artifact Version: Latest artifact version retrieved from the Nexus repository.
  • Artifact Base Version: Latest artifact base version retrieved from the Nexus repository. For releases, this is the same as the artifactVersion. For snapshots (such as 1.0-SNAPSHOT), it excludes the additional qualifiers.
  • Artifact Snapshot Build Number: Latest artifact snapshot build number retrieved from the Nexus repository.
  • Artifact Repository Path: Artifact path relative to the selected Nexus repository.

Manage triggers​

The Triggers management page displays an actionable list of all triggers that you have permissions to view and manage, and provides the entry point for creating new triggers. For details, see Triggers.