Jenkins流水線將制品發(fā)布到Nexus存儲庫
在本指南中，我們將使用Jenkins作為持續(xù)集成服務(wù)器，并使用Nexus Repository 作為構(gòu)建存儲庫。
本指南的目的是創(chuàng)建一個工作流，我們可以在該工作流中通過Maven和CI服務(wù)器來構(gòu)建，存儲，管理和監(jiān)視已編譯的制品。
在開始之前，請確保您已經(jīng)啟動并運行了Jenkins。如果您尚未設(shè)置Jenkins，請復(fù)制以下命令并在啟用Docker的主機(jī)上運行它。
docker run -d --name jenkins-ci -p 8080:8080 jenkins/jenkins:lts在本地/遠(yuǎn)程計算機(jī)上配置了Jenkins容器后，請瀏覽器打開URL。
http:///your-ip-addr:8080在首頁，Jenkins將詢問您管理員密碼，您可以通過在終端中運行以下提到的命令來找到該密碼。
docker exec -i jenkins-ci cat /var/jenkins_home/secrets/initialAdminPassword
b5102c8d9fa245dbb0b8da03f504d3a5請按照指導(dǎo)的步驟完成配置。安全保存用戶名和密碼，以備將來使用。
安裝Nexus制品庫
Nexus是一個存儲庫管理器，可讓您存儲和檢索工件。它使您能夠?qū)?gòu)建的工件托管在私有且安全的存儲庫中。
您始終可以使用以下命令獲取Nexus Docker映像：
$ 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在默認(rèn)端口8081上運行 sonatype/nexus。請遵循以下命令：
$ docker run -d --name nexus_repo -p 8081:8081 sonatype/nexus3在新創(chuàng)建的Docker容器中啟動Nexus服務(wù)通常需要1-2分鐘。如果您希望按照日志查看Nexus是否已啟動并準(zhǔn)備就緒，請運行以下命令：
$ docker logs nexus_repo -f在日志中，您會看到一條消息：Started Sonatype Nexus OSS 3.20.1-01這意味著您的Nexus Repository Manager可以使用了?，F(xiàn)在轉(zhuǎn)到瀏覽器并打開。
http://your-ip-addr:8081找到“ 登錄” 選項，如下所示：
默認(rèn)用戶名是admin，您需要運行以下命令來獲取密碼：
$ docker exec -i nexus_repo cat /nexus-data/admin.password
502ace93-5450-4f0d-97d2-9b3b3a88d149就是這樣。您的Nexus Repository Manager可以隨時使用。下一步是創(chuàng)建一個新的存儲庫。
在Nexus中創(chuàng)建存儲庫
在這一步中，您將在Nexus中創(chuàng)建一個Maven托管存儲庫，您的Jenkins將在其中上載“構(gòu)建”工件。
步驟1：按照以下步驟創(chuàng)建托管存儲庫，并將其命名 maven-nexus-repo，將在本指南中使用。
從列表中選擇 maven2，如下所示：
步驟2：在“ 創(chuàng)建存儲庫”頁面上。
- 輸入名稱為 maven-nexus-repo。
- 在版本策略中，選擇工件的類型。
- 在“ 托管” 部分 下的“ 部署策略”中，選擇“ 允許重新部署”。它將允許您多次部署應(yīng)用程序。
步驟3：要創(chuàng)建新用戶，請轉(zhuǎn)到 信息中心>服務(wù)器管理員和配置>用戶>創(chuàng)建用戶。選擇 恰好是默認(rèn)領(lǐng)域的本地用戶類型：
在“ 創(chuàng)建用戶”頁面中。
- ID：輸入所需的ID；在我們的案例中，它是Jenkins用戶。
- 名字：輸入所需的名字；就我們而言，就是Jenkins。
- 姓：輸入所需的名字；在我們的例子中是用戶。
- 電子郵件：輸入您的電子郵件地址。
- 狀態(tài)：從下拉菜單中選擇 有效。
- 角色：確保將nx-admin 角色授予 用戶。
至此，我們完成了Nexus Repository Manager的設(shè)置部分。讓我們轉(zhuǎn)到Jenkins在此處設(shè)置Nexus。
在Jenkins中安裝和配置Nexus插件
在這里，您將為Jenkins中的Nexus安裝并配置一些插件。為此，請轉(zhuǎn)到Jenkins，然后轉(zhuǎn)到 信息中心>管理Jenkins>管理插件>可用， 然后搜索并安裝 Nexus Artifact Uploader 插件。
在Jenkins中添加Nexus Repository Manager的用戶憑據(jù)。轉(zhuǎn)到 儀表板>憑證>系統(tǒng)>全局憑證（不受限制），如下所示：
接下來，將Maven設(shè)置為托管工具。轉(zhuǎn)到 儀表板>管理Jenkins>全局工具配置， 然后找到 Maven。在此部分下，單擊“ Maven安裝” 按鈕并添加 Maven，如下所示：
另外，您也可以將Maven二進(jìn)制文件直接安裝到/var/jenkins_home目錄中的容器中。
創(chuàng)建一條Jenkins流水線
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";
}
}
}
}
}
}讓我們逐一分解上述參數(shù)：
- NEXUS_VERSION：在這里，我們必須提及Nexus的確切版本，可以是nexus2或nexus3。在我們的情況下，它是的最新版本nexus3。
- NEXUS_PROTOCOL：對于本指南，我們使用了HTTP協(xié)議，但是，在正式生產(chǎn)的情況下，您將必須使用HTTPS。
- NEXUS_URL：添加您的IP地址和端口號，以運行Nexus。確保您添加的Nexus實例詳細(xì)信息沒有提及協(xié)議，例如https或http。
- NEXUS_CREDENTIAL_ID：輸入您先前在Jenkins中創(chuàng)建的用戶ID，在本例中為 nexus-user-credentials。
- Git項目：在階段階段，我們使用了https://github.com/javaee/cargotracker。
在完成管道設(shè)置的過程中，是時候開始Build我們的項目了。轉(zhuǎn)到JenkinsNexus項目作業(yè)頁面，然后單擊立即構(gòu)建。由于這是您的第一個構(gòu)建，因此將需要一些時間。
一旦構(gòu)建成功，在Jenkins控制臺輸出中，您將看到類似以下內(nèi)容：
而在Nexus Repository Manager中，您會看到類似以下內(nèi)容：
對于任何組織而言，一種系統(tǒng)地分發(fā)項目工件的方法都是至關(guān)重要的。借助Jenkins Pipeline和Nexus Repository Manager，您可以集中管理制品，從而最終減少了重新生成構(gòu)建時間以及切換CI工具的工作。
Nexus還可以配置有AWS S3和Google Cloud Storage等云存儲服務(wù)，從而為您提供了更多的自由度和交付應(yīng)用程序，而無任何存儲麻煩。
