Automatically sending artifacts from Jenkins to a repository manager: the quickest (and not so dirty) way
In order to store artifacts in a repository at the end of a successful build some plugins are available in the Jenkins update centre. The configuration of these plugins is sometimes tricky, the documentation poor or not updated and some of them are tested (and work) only against one of the available Open Source and commercial build artifact repository managers and fail against others. A quick and not so dirty general way to complete this action is described in this post. This solution works fine against Apache Archiva, but it should work fine with Artifactory or Nexus as well.
You need to add a Invoke top-level Maven target as latest build step for the build job you're running to build your Java application/library and configure it the following way:
Maven version: any Maven version you need (you can use the default for your Jenkins instance or one among the different releases that you may have set up for it).
Goals: deploy:deploy-file -Dfile=<application_root>\target\<artifact_name>.jar -DpomFile=<application_root>\pom.xml -DrepositoryId=<artifact_repository_id> -Durl=<artifact_repository_url>
where
Settings file: Settings file in filesystem and the path to the settings.xml to use
Global Settings file: Settings file in filesystem and the path to the settings.xml file to use
The settings file could belong to a different Maven installation but accessible by Jenkins. If authentication is required to access the Archiva repository the settings file to use should contain the authentication credentials. You need to add a new <server> tag to the list of servers (<servers> tag):
<servers>
...
<server>
<id>repoId</id>
<username>username</username>
<password>password</password>
</server>
...
</servers>
repoId is the id to be used as value for the repositoryId argument of the deploy-file Maven goal.
Finally, in order to skip the deploy of the artifact just in case one of the previous build steps (build, unit tests, code coverage, static analysis, whatever) should fail you should add a conditional step (you need the Conditional Build Step plugin (https://wiki.jenkins-ci.org/display/JENKINS/Conditional+BuildStep+Plugin) for this) as well. The following snapshots show the final configuration:
You need to add a Invoke top-level Maven target as latest build step for the build job you're running to build your Java application/library and configure it the following way:
Maven version: any Maven version you need (you can use the default for your Jenkins instance or one among the different releases that you may have set up for it).
Goals: deploy:deploy-file -Dfile=<application_root>\target\<artifact_name>.jar -DpomFile=<application_root>\pom.xml -DrepositoryId=<artifact_repository_id> -Durl=<artifact_repository_url>
where
- application_root is the root of the Java application/library in the build job workspace
- artifact_name is the choosen name for the artifact
- artifact_repository_id is the ID of the Archiva repository inside the Maven settings.xml file to use (let's go back on this later in this post)
- artifact_repository_url is the HTTP URL of the destination Archiva repository.
Settings file: Settings file in filesystem and the path to the settings.xml to use
Global Settings file: Settings file in filesystem and the path to the settings.xml file to use
The settings file could belong to a different Maven installation but accessible by Jenkins. If authentication is required to access the Archiva repository the settings file to use should contain the authentication credentials. You need to add a new <server> tag to the list of servers (<servers> tag):
<servers>
...
<server>
<id>repoId</id>
<username>username</username>
<password>password</password>
</server>
...
</servers>
repoId is the id to be used as value for the repositoryId argument of the deploy-file Maven goal.
Finally, in order to skip the deploy of the artifact just in case one of the previous build steps (build, unit tests, code coverage, static analysis, whatever) should fail you should add a conditional step (you need the Conditional Build Step plugin (https://wiki.jenkins-ci.org/display/JENKINS/Conditional+BuildStep+Plugin) for this) as well. The following snapshots show the final configuration:
Comments
Post a Comment