Skip to main content

Artifact Bundles (Nexus Repository 2)

Nexus Repository 2

Artifact bundles are groups of related components that are all related by the same groupId, artifactId, and version (GAV) coordinate. They are used by projects that wish to upload components to the Central Repository. Bundles must contain the following POM elements:

  • modelVersion

  • groupId

  • artifactId

  • packaging

  • name

  • version

  • description

  • url

  • licenses

  • scm

    • url

    • connection

Creating an Artifact Bundle from a Maven Project

Artifact bundles are created with the Maven Repository Plugin. For more information about the Maven Repository plugin, see

Sample POM Containing all Required Bundle Elements lists a project’s POM that satisfies all of the constraints that are checked by the Maven

Repository plugin. The following POM contains a description and a URL, SCM information, and a reference to a license. All of this information is required before a component bundle can be published to the Maven Central repository.

Sample POM Containing all Required Bundle Elements

<project xmlns=""
  <description>A Sample Project</description>
      <name>The Apache Software License, Version 2.0</name>

To create a bundle from a Maven project, run the repository:bundle-create goal. This goal will check the POM to see if it complies with the standards for publishing a bundle to a public repository. It will then bundle all of the components generated by a particular build.

To build a bundle that only contains the standard, unclassified component from a project, run mvn repository:bundle-create.

To generate a bundle that contains more than one component, run mvn javadoc:jar source:jar repository:bundle-create:

~/examples/sample-project$ mvn javadoc:jar source:jar repository:bundle-create
[INFO] Scanning for projects...
[INFO] Searching repository for plugin with prefix: 'javadoc'.
[INFO] ------------------------------------------------------------------------
[INFO] Building sample-project
[INFO] task-segment: [javadoc:jar, source:jar, repository:bundle-create]
[INFO] ------------------------------------------------------------------------
[INFO] [javadoc:jar {execution: default-cli}]
Loading source files for package com.sonatype.sample...
Constructing Javadoc information...
Standard Doclet version 1.6.0_15
Building tree for all the packages and classes...
[INFO] Preparing source:jar
[INFO] No goals needed for project - skipping
[INFO] [source:jar {execution: default-cli}]


Running com.sonatype.sample.AppTest
Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.03 sec
Results :
Tests run: 1, Failures: 0, Errors: 0, Skipped: 0
[INFO] [jar:jar {execution: default-jar}]
[INFO] Building jar: ~/temp/sample-project/target/sample-project-1.0.jar
[INFO] [repository:bundle-create {execution: default-cli}]
[INFO] The following files are marked for inclusion in the repository bundle:
0.) Done
1.) sample-project-1.0.jar
2.) sample-project-1.0-javadoc.jar
3.) sample-project-1.0-sources.jar
Please select the number(s) for any files you wish to exclude, or '0' when \
you're done. Separate the numbers for multiple files with a comma (',').
[INFO] Building jar: ~/temp/sample-project/target/sample-project-1.0-bundle.jar
[INFO] ------------------------------------------------------------------------
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 11 seconds
[INFO] Finished at: Sat Oct 10 21:24:23 CDT 2009
[INFO] Final Memory: 36M/110M
[INFO] ------------------------------------------------------------------------

Once the bundle has been created, there will be a bundle JAR in the target directory. As shown in the following command output, the bundle JAR contains a POM, the project’s unclassified component, the javadoc component, and the sources component:

~/examples/sample-project$ cd target
~/examples/sample-project/target$ jar tvf sample-project-1.0-bundle.jar
0 Sat Oct 10 21:24:24 CDT 2009 META-INF/
98 Sat Oct 10 21:24:22 CDT 2009 META-INF/MANIFEST.MF
1206 Sat Oct 10 21:23:46 CDT 2009 pom.xml
2544 Sat Oct 10 21:24:22 CDT 2009 sample-project-1.0.jar
20779 Sat Oct 10 21:24:18 CDT 2009 sample-project-1.0-javadoc.jar
891 Sat Oct 10 21:24:18 CDT 2009 sample-project-1.0-sources.jar

Uploading an Artifact Bundle

To upload a component bundle to Nexus Repository Manager Pro, you have to have a repository target for the project configured as described in Managing Repository Targets.

Once that is done, select Staging Upload from the Build Promotion section of the main menu. This will load the Staging Upload tab. Choose Artifact Bundle from the Upload Mode drop-down. The Staging Upload panel will switch to the form shown in Figure 11.24, “Uploading an Artifact Bundle”. Click on Select Bundle to Upload… and then select the JAR that was created with the Maven repository plugin used in the previous sections. Once a bundle is selected, click on Upload Bundle.


Figure 11.24. Uploading an Artifact Bundle

After a successful upload, a dialog displays the name of the created staging repository in a URL that links to the content of the repository. To view the staging repository, click on the Staging Repositories link in the Build Promotion section of the menu. You should see that the Staging Artifact Upload created and closed a new staging repository as shown in Figure 11.25, “Staging Repository Created from Artifact Bundle Upload”. This repository contains all of the components contained in the uploaded bundle. It allows you to promote or drop the components contained in a bundle as a single unit.


Figure 11.25. Staging Repository Created from Artifact Bundle Upload

Once the staging repository is closed, you can promote it to a Build Promotion Profile or release it to the target repository of the staging profile as documented in Managing Staging Repositories.