The goal of this guide is to create a workflow where we can build, store, organize, and monitor the compiled artifacts by Maven through our CI server.
Before we begin, make sure that you already have Jenkins up and running. In case you haven't set up Jenkins yet, then copy the below command and run it on your Docker enabled host/machine.
$ docker run -d --name jenkins-ci -p 8080:8080 jenkins/jenkins:lts
http:///your-ip-addr:8080
$ docker exec -i jenkins-ci cat /var/jenkins_home/secrets/initialAdminPassword
b5102c8d9fa245dbb0b8da03f504d3a5
Follow the guided steps to finish the configuration. Save the username and password securely for future use.
Installing Sonatype Nexus Repository
$ docker pull sonatype/nexus3
Using default tag: latest
latest: Pulling from sonatype/nexus3
cb3c77f9bdd8: Pull complete
fd8daf2668d1: Pull complete
fd1ff82b00e8: Pull complete
2a05f7b573af: Pull complete
Digest: sha256:6570855dfbc3eb094fe5cbbacec87aa8b91d16394dab627177e1deeebb5ac8ee
Status: Downloaded newer image for sonatype/nexus3:latest
docker.io/sonatype/nexus3:latest
$ docker run -d --name nexus_repo -p 8081:8081 sonatype/nexus3
$ docker logs nexus_repo -f
Started Sonatype Nexus OSS 3.20.1-01
This means your Sonatype Nexus Repository Manager is ready to use. Now go to your browser and open:
http://your-ip-addr:8081
![NexusRepoSignIn](https://www.sonatype.com/hs-fs/hubfs/DevSecOpsDays.com%20master/Imported_Blog_Media/NexusRepoSignIn.png?width=1394&name=NexusRepoSignIn.png)
$ docker exec -i nexus_repo cat /nexus-data/admin.password
502ace93-5450-4f0d-97d2-9b3b3a88d149
And that's it. Your Sonatype Nexus Repository is ready to use. The next step is to create a new repository.
Create a repository in Sonatype Nexus Repository
Follow the below-mentioned steps to create a hosted repository, name it
maven-nexus-repo
, which you are going to use throughout this guide.![maven-nexus-repo](https://www.sonatype.com/hs-fs/hubfs/DevSecOpsDays.com%20master/Imported_Blog_Media/maven-nexus-repo.png?width=1406&name=maven-nexus-repo.png)
![Maven2recipe](https://www.sonatype.com/hs-fs/hubfs/DevSecOpsDays.com%20master/Imported_Blog_Media/Maven2recipe.png?width=1400&name=Maven2recipe.png)
On the Create Repository page:
- Enter the name as maven-nexus-repo
- In Version Policy, select the Mixed type of artifacts.
- Under the Hosted section, in Deployment policy, select Allow redeploy. It will allow you to deploy an application multiple times.
![AllowDeploy](https://www.sonatype.com/hs-fs/hubfs/DevSecOpsDays.com%20master/Imported_Blog_Media/AllowDeploy.png?width=1412&name=AllowDeploy.png)
To create a new user, go to Dashboard > Server Administrator and Configuration > User > Create user. Select Local user type which happens to be the default Realm:
![RepoUsers](https://www.sonatype.com/hs-fs/hubfs/DevSecOpsDays.com%20master/Imported_Blog_Media/RepoUsers.png?width=1406&name=RepoUsers.png)
- ID: Enter the desired ID; in our case, it is jenkins-user.
- First Name: Enter the desired first name; in our case, it is Jenkins.
- Last Name: Enter the desired second name; in our case, it is User.
- Email: Enter your email address.
- Status: Select Active from your drop-down menu.
- Roles: Make sure that you grant the nx-admin role to your user.
With this, we are through with the setup part of Sonatype Nexus Repository. Let us move to Jenkins to setup Sonatype Nexus Repository there.
Install and configure Sonatype Nexus Repository plugins in Jenkins
![Jenkins](https://www.sonatype.com/hs-fs/hubfs/DevSecOpsDays.com%20master/Imported_Blog_Media/Jenkins.png?width=1420&name=Jenkins.png)
![MavenInstallation](https://www.sonatype.com/hs-fs/hubfs/DevSecOpsDays.com%20master/Imported_Blog_Media/MavenInstallation.png?width=1410&name=MavenInstallation.png)
Alternatively, you can also install the Maven binary directly to your container on the /var/jenkins_home
directory.
Create a Jenkins Pipeline
![JenkinsNexus](https://www.sonatype.com/hs-fs/hubfs/DevSecOpsDays.com%20master/Imported_Blog_Media/JenkinsNexus.png?width=1428&name=JenkinsNexus.png)
pipeline {
agent {
label "master"
}
tools {
maven "Maven"
}
environment {
NEXUS_VERSION = "nexus3"
NEXUS_PROTOCOL = "http"
NEXUS_URL = "you-ip-addr-here:8081"
NEXUS_REPOSITORY = "maven-nexus-repo"
NEXUS_CREDENTIAL_ID = "nexus-user-credentials"
}
stages {
stage("Clone code from VCS") {
steps {
script {
git 'https://github.com/javaee/cargotracker.git';
}
}
}
stage("Maven Build") {
steps {
script {
sh "mvn package -DskipTests=true"
}
}
}
stage("Publish to Nexus Repository Manager") {
steps {
script {
pom = readMavenPom file: "pom.xml";
filesByGlob = findFiles(glob: "target/*.${pom.packaging}");
echo "${filesByGlob[0].name} ${filesByGlob[0].path} ${filesByGlob[0].directory} ${filesByGlob[0].length} ${filesByGlob[0].lastModified}"
artifactPath = filesByGlob[0].path;
artifactExists = fileExists artifactPath;
if(artifactExists) {
echo "*** File: ${artifactPath}, group: ${pom.groupId}, packaging: ${pom.packaging}, version ${pom.version}";
nexusArtifactUploader(
nexusVersion: NEXUS_VERSION,
protocol: NEXUS_PROTOCOL,
nexusUrl: NEXUS_URL,
groupId: pom.groupId,
version: pom.version,
repository: NEXUS_REPOSITORY,
credentialsId: NEXUS_CREDENTIAL_ID,
artifacts: [
[artifactId: pom.artifactId,
classifier: '',
file: artifactPath,
type: pom.packaging],
[artifactId: pom.artifactId,
classifier: '',
file: "pom.xml",
type: "pom"]
]
);
} else {
error "*** File: ${artifactPath}, could not be found";
}
}
}
}
}
}
- NEXUS_VERSION: Here, we have to mention the exact version of Nexus, which can be
nexus2
ornexus3
. In our case, it is latest version ofnexus3
. - NEXUS_PROTOCOL: For this guide we have used HTTP protocol, although, in case of production, you will have to use HTTPS.
- NEXUS_URL: Add your IP address and port number, where you are running Nexus. Make sure that you add Nexus instance details without mentioning protocols, i.e.,
https
orhttp
. - NEXUS_CREDENTIAL_ID: Enter the user ID, which you previously created in Jenkins, which in our case is
nexus-user-credentials
. - Project Git: Under stages, we used
https://github.com/javaee/cargotracker
Build
our project. Go to the JenkinsNexus project job page and click Build Now. As this is your first build, it is going to take some time, so sit tight.![BuildSuccess](https://www.sonatype.com/hs-fs/hubfs/DevSecOpsDays.com%20master/Imported_Blog_Media/BuildSuccess.png?width=1358&name=BuildSuccess.png)
![NexusRepoSuccess](https://www.sonatype.com/hs-fs/hubfs/DevSecOpsDays.com%20master/Imported_Blog_Media/NexusRepoSuccess.png?width=1408&name=NexusRepoSuccess.png)
Conclusion
Originally published on AppFleet
![Picture of Dmitriy Akulov](https://www.sonatype.com/hubfs/Dmitriy%20Akulov.png)
Written by Dmitriy Akulov
I like to work with servers and high availability systems, I manage projects and developers, contribute to open source and build big and complex services. Founder of PerfOps https://perfops.net/ Founder of Prospect One https://prospectone.io/ Founder of jsDelivr https://www.jsdelivr.com/
Related Resources
![Resource Center Finos Roughs 27](https://www.sonatype.com/hubfs/Resource%20Center%20Finos%20Roughs%2027.png)
![](https://www.sonatype.com/hubfs/GettyImages-1446878403-2.jpg)