Jenkins支持創(chuàng)建流水線。它使用一種基于Groovy的流水線領(lǐng)域特定語(yǔ)言(Pipeline DSL)的簡(jiǎn)單腳。

而這些腳本，通常名字叫Jenkinsfile。它定義了一些根據(jù)指定參數(shù)執(zhí)行簡(jiǎn)單或復(fù)雜的任務(wù)的步驟。流水線創(chuàng)建好后，可以用來構(gòu)建代碼，或者編排從代碼提交到交付過程中所需的工作。

流水線包括步驟(Step)，節(jié)點(diǎn)(Node)和階段(Stage)。流水線執(zhí)行在節(jié)點(diǎn)上。節(jié)點(diǎn)是Jenkins安裝的一部分。流水線通常包含多個(gè)階段。一個(gè)階段包含多個(gè)步驟。流水線上手指南(jenkins.io/doc/pipelin…

對(duì)于我們本文中的應(yīng)用，其基本的部署流程是這樣的：

開發(fā)者更新工作區(qū)

Jenkins收到通知

Jenkins克隆工作區(qū)

Jenkins創(chuàng)建一個(gè)Docker鏡像

Jenkins運(yùn)行測(cè)試

Jenkins將鏡像推到Docker Hub

應(yīng)用位于倉(cāng)庫(kù)中的webapp目錄。應(yīng)用會(huì)借助Couchbase的Java SDK，使用一個(gè)到Couchbase數(shù)據(jù)庫(kù)的連接，保存一個(gè)簡(jiǎn)單的JSON文檔。應(yīng)用同時(shí)包含一個(gè)測(cè)試，以驗(yàn)證數(shù)據(jù)庫(kù)是否包含持久化的文檔。

特別感謝@alexsotob在Jenkins配置上對(duì)我的幫助。

讓我們開始吧！

下載并安裝Jenkins

從jenkins.io下載Jenkins。這里使用的是Jenkins 2.21。

先把Jenkins啟動(dòng)起來：

JENKINS_HOME=~/.jenkins java -jar ~/Downloads/jenkins-2.21.war --httpPort=9090

復(fù)制代碼

這條命令指定了Jenkin家目錄的路徑。家目錄下面存放了所有的配置信息。同時(shí)指定了Jenkins的監(jiān)聽端口。這里指定的是9090端口。

啟動(dòng)Jenkins會(huì)在中終端中看到如下消息：

Jenkins initial setup is required. An admin user has been created and a password generated.

Please use the following password to proceed to installation:

(譯文：Jenkins需要初始化的設(shè)置。我們已經(jīng)為你創(chuàng)建好了一個(gè)管理員用戶生成好了密碼。請(qǐng)使用下面密碼繼續(xù)安裝。)

3521fbc3d40448efa8942f8e464b2dd9

This may also be found at: /Users/arungupta/.jenkins/secrets/initialAdminPassword

(譯文：這個(gè)密碼的內(nèi)容同時(shí)也可以在`/Users/arungupta/.jenkins/secrets/initialAdminPassword`中找到。)

復(fù)制代碼

復(fù)制一下終端中顯示的密碼，這個(gè)密碼會(huì)用來解鎖Jenkins。

在瀏覽器中輸入localhost:9090訪問Jenkins，然后粘貼密碼：

點(diǎn)擊Next進(jìn)入下一步：

創(chuàng)建第一個(gè)如圖所示的管理員用戶：

點(diǎn)擊Save and Finish繼續(xù)。

點(diǎn)擊Install suggested plugins：

然后就會(huì)安裝好一批默認(rèn)的插件：

(很奇怪Ant和Subversion是默認(rèn)的插件。)

然后會(huì)彈出登陸框：

輸入之前創(chuàng)建好的用戶名和密碼。

最后Jenkins就可以使用了。

不得不說，要安裝好一個(gè)簡(jiǎn)單的Jenkins所需要的步驟不少。真的有必要需要這么多步驟才能開始使用Jenkins嗎？能不能有一個(gè)更簡(jiǎn)單，更傻瓜，更偷懶的方式來開始使用Jenkins呢？希望能遵守管理優(yōu)先原則(Convention-over-Configuration)然后提供一個(gè)預(yù)先配置好的一鍵安裝包。

創(chuàng)建Jenkins作業(yè)

讓我們?cè)贘enkins中創(chuàng)建一個(gè)用來運(yùn)行流水線的作業(yè)。

在Jenkins重啟之后，他會(huì)顯示一個(gè)登陸界面。輸入之前創(chuàng)建的用戶名和密碼。這會(huì)把你帶回到Installing Plugins/Upgrade頁(yè)面。點(diǎn)擊頁(yè)面左上角的Jenkins圖標(biāo)，可看到主控制面板：

點(diǎn)擊create new job，作業(yè)的名字取做docker-jenkins-pipeline，類型選Pipeline。

點(diǎn)擊OK按鈕。

按照如圖所示對(duì)流水線進(jìn)行配置：

這里我們使用了本地的倉(cāng)庫(kù)。你當(dāng)然也可以選擇托管在Github上的倉(cāng)庫(kù)。另外，這個(gè)倉(cāng)庫(kù)可以配置一個(gè)git鉤子或者定時(shí)的輪詢器來觸發(fā)流水線的運(yùn)行。點(diǎn)擊Save按鈕來保存配置。

讓Jenkins進(jìn)行構(gòu)建

在啟動(dòng)這個(gè)作業(yè)之前，Couchbase數(shù)據(jù)庫(kù)需要顯式地進(jìn)行啟動(dòng)：

docker run -d --name db -p 8091-8093:8091-8093 -p 11210:11210 arungupta/oreilly-couchbase:latest

復(fù)制代碼

這個(gè)問題會(huì)在編號(hào)9的問題(github.com/arun-gupta/… http://localhost:8091 來訪問Couchbase。點(diǎn)擊Data Bucket標(biāo)簽頁(yè)可以看到創(chuàng)建的名為books的Bucket。

點(diǎn)擊Build Now你應(yīng)該看見下圖類似的輸出：

看起來一切正常。

讓我們來試著理解下背后發(fā)生了什么。

Jenkinsfile描述了流水線是如何構(gòu)建的。從整體看它有四個(gè)階段 – 打包、創(chuàng)建Docker鏡像、運(yùn)行應(yīng)用和運(yùn)行測(cè)試。每一個(gè)階段在Jenkins的控制面板都是以一個(gè)方框顯示的。每一個(gè)階段花費(fèi)的總體時(shí)間顯示在每一個(gè)方框中間。

然后我們?cè)囍斫饷恳粋€(gè)階段都做了什么事情。

打包：應(yīng)用的的源碼位于webapp目錄下。而這一條Maven命令：

mvn clean package -DskipTests

復(fù)制代碼

用來創(chuàng)建應(yīng)用的JAR包。注意Maven項(xiàng)目也包含測(cè)試，但是這里被故意通過-DskipTests忽略了。

通常，測(cè)試會(huì)分開放在一個(gè)下游的項(xiàng)目中(github.com/arun-gupta/… JAR(譯者注：Fat JAR是把項(xiàng)目所有類文件、資源文件和依賴打包在一起的JAR)文件并且包含所有的依賴。

創(chuàng)建Docker鏡像：應(yīng)用的Docker鏡像是使用webapp目錄下的Dockerfile來構(gòu)建的。這個(gè)鏡像僅僅包含一個(gè)Fat JAR，可以通過java -jar來運(yùn)行。

每一個(gè)鏡像都使用構(gòu)建編號(hào)打上了標(biāo)簽：

${env.BUILD_NUMBER}

復(fù)制代碼

運(yùn)行應(yīng)用：運(yùn)行應(yīng)用需要運(yùn)行應(yīng)用的Docker容器。數(shù)據(jù)庫(kù)容器的IP地址可以通過下面這條命令來查到：

docker inspect

復(fù)制代碼

數(shù)據(jù)庫(kù)容器和應(yīng)用容器同時(shí)運(yùn)行在默認(rèn)的bridge網(wǎng)絡(luò)中。這可以讓兩個(gè)容器來互相溝通。也可以在swarm模式的集群中運(yùn)行流水線，這需要?jiǎng)?chuàng)建并且使用覆蓋網(wǎng)絡(luò)。

運(yùn)行測(cè)試：測(cè)試可以使用如下命令來進(jìn)行：

mvn test

復(fù)制代碼

如果測(cè)試通過，鏡像會(huì)被推送到Docker Hub。不管測(cè)試是否成功，運(yùn)行結(jié)構(gòu)都能捕獲到。同時(shí)我們顯示了try/catch/finally塊在Jenkinsfile中的使用。如果測(cè)試通過了，那鏡像就會(huì)推送到Docker Hub中。在我們這個(gè)例子中，它被推送到了這里(hub.docker.com/r/arungupta…

待辦事項(xiàng)

把測(cè)試移到一個(gè)下游的項(xiàng)目中

使用Git鉤子或者輪詢來觸發(fā)流水線

自動(dòng)化數(shù)據(jù)庫(kù)的啟動(dòng)與停止

用Swarm模式下的Docker引擎集群來運(yùn)行流水線

增加額外的配置來將鏡像推送到bintray

另外一個(gè)痛點(diǎn)找不到關(guān)于全局變量語(yǔ)法的文檔。只有在:/job/docker-jenkins-pipeline/pipeline-syntax/globals能找到相關(guān)內(nèi)容。這一點(diǎn)點(diǎn)戳。

“不是不可能，只是還沒有實(shí)現(xiàn)(twitter.com/agentdero/s… #sadpanda

總結(jié)

以上是生活随笔為你收集整理的java中搭建流水线,部署流水线搭建小记：Docker、Jenkins、Java 和 Couchbase的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。