前言1.Jenkins架構(gòu)原理回顧

在前面一篇《CI&CD落地實踐2-Jenkins環(huán)境搭建&常見使用技巧》中，我們介紹了Jenkins的架構(gòu)原理：

Jenkins是一種典型的Master-Slave主從架構(gòu)。該架構(gòu)包括一個Master（主）節(jié)點和多個Slave（從）節(jié)點。Jenkins的Master-Slave架構(gòu)提供了可擴展性和靈活性，允許用戶添加更多節(jié)點來提高Jenkins的處理能力，同時保持構(gòu)建和管理過程的可靠性。

Master節(jié)點：Jenkins的核心是Master節(jié)點，包含Jenkins的核心功能和管理界面，并與所有Slave節(jié)點通信，調(diào)度和分配作業(yè)。主要的作業(yè)配置信息，如構(gòu)建工作流程、觸發(fā)器和構(gòu)建器、節(jié)點和視圖信息，以及連接外部系統(tǒng)的應用程序都存儲在Jenkins Master節(jié)點中。Agent節(jié)點：也稱slave節(jié)點，是通過Jenkins Agent（代理）連接到Master節(jié)點的計算機，它們執(zhí)行來自Master節(jié)點的作業(yè)并將結(jié)果返回給Master節(jié)點。2.為什么要部署分布式環(huán)境？

在Jenkins的分布式環(huán)境中，有以下幾個好處：

(相關(guān)資料圖)

增加伸縮性：Jenkins的分布式環(huán)境中可以添加多個節(jié)點，將負載分散到不同的節(jié)點上，從而增加伸縮性。如果對Jenkins的使用量有要求，可以先添加一些節(jié)點，然后在需要的時候再添加更多節(jié)點。提高性能：在集中式環(huán)境中，Jenkins會變得擁擠，當多個任務同時運行時，會導致性能下降。在分布式環(huán)境中，任務可以在不同的節(jié)點上運行，因此可以大大提高性能。支持多種操作系統(tǒng)：Jenkins分布式環(huán)境可以在多種操作系統(tǒng)上運行，如Windows，Linux等，在不同的操作系統(tǒng)上運行構(gòu)建可以更好的測試、驗證和分發(fā)。更好的可靠性：在一個節(jié)點發(fā)生故障時，其他節(jié)點可以繼續(xù)運行任務，從而保證每個任務都能成功運行，增加了整個系統(tǒng)的可靠性。更好的安全性：在分布式環(huán)境中，不同的節(jié)點可以采用不同的方式進行認證和授權(quán)，從而大大提高了Jenkins的安全性。

總之，Jenkins分布式環(huán)境可以提供更好的性能、伸縮性、可靠性和安全性，使得整個系統(tǒng)更加高效、穩(wěn)定和安全。

3.分布式環(huán)境建設計劃

其實驅(qū)使我搭建分布式環(huán)境倒不是因為伸縮性不足、性能低下等方面的原因，而是我在一次Jenkins配置Maven項目、編譯后端springboot項目時，老是報Maven依賴庫錯誤的問題，最終導致編譯不過，嘗試了很多方法都沒有解決。但該項目在我本地的IDEA中是可以正常編譯通過的，于是我想了一個曲線救國的方案，就是在另一臺Windows機器上，搭建一套和我本機一模一樣的環(huán)境，將我本機的Maven倉庫整體打包復制過去，然后再安裝一個Jenkins，作為從節(jié)點使用。

當前我只在一個單節(jié)點服務器上安裝了Jenkins，計劃在一臺Linux系統(tǒng)機器上安裝Jenkins作為從節(jié)點1，在另一臺Windows系統(tǒng)機器上安裝Jenkins作為從節(jié)點2。

節(jié)點	主機	系統(tǒng)	用途
Master 主節(jié)點	192.168.1.20	CentOS 7	分配、調(diào)度任務
Slave 從節(jié)點1	192.168.1.122	CentOS 7	編譯前端項目
Slave 從節(jié)點2	192.168.1.188	Win 10	編譯后端項目

一、添加Linux從節(jié)點1.從節(jié)點環(huán)境配置① 從節(jié)點安裝Jenkins

所在服務器需要安裝Jenkins，版本最好與主節(jié)點Jenkins版本保持一致，安裝步驟參考前面的《Jenkins環(huán)境搭建&常見使用技巧》

② 從節(jié)點環(huán)境配置

需要安裝Git以及相關(guān)插件，如果是編譯前端項目，需要配置nodejs，如果是編譯后端項目，還需要安裝maven等。前端環(huán)境配置可以參考前面的一篇《Jenkins實現(xiàn)前端項目自動化構(gòu)建》

2.添加從節(jié)點① 創(chuàng)建從節(jié)點

入口：系統(tǒng)管理-節(jié)點管理-添加節(jié)點，填寫從節(jié)點名稱，選擇固定節(jié)點

② 填寫從節(jié)點信息Number of executors：執(zhí)行器數(shù)量，支持的最大job并發(fā)數(shù)，一般配置建議不超過當前節(jié)點電腦的CPU數(shù)量遠程工作目錄標簽：做調(diào)度策略時會用到用法：一般選擇第一個“Use this node as much as possible”（盡可能的使用這個節(jié)點）啟動方式：通過Java Web啟動代理

注意最后“節(jié)點屬性”，可以勾選“工具位置”提前指定該機器中的如JDK等工具的路徑。

剛添加好后的從節(jié)點處于不可用狀態(tài)，還需要進行一堆的配置：

③ 主節(jié)點配置代理

主節(jié)點：系統(tǒng)管理-全局安全配置-代理，指定一個代理端口（注意：從節(jié)點服務器防火墻一定要開放此端口）

④ 從節(jié)點連接主節(jié)點

在管理節(jié)點點擊查看新增的從節(jié)點詳情，會給出從節(jié)點如何連接主節(jié)點的提示：

在從節(jié)點上執(zhí)行：

# 下載agent.jarcurl -sO http://192.168.1.20:8080/jenkins/jnlpJars/agent.jar# 連接主節(jié)點java -jar agent.jar -jnlpUrl http://192.168.1.20:8080/jenkins/manage/computer/h122/jenkins-agent.jnlp -secret 5d40fefd1148aa3e1461eb53a7764f655c030a7859cfa648b2340ba019146a3d -workDir "/home/jenkins/workspace"

此時我的報錯了，提示42730端口不可用，也就是前面提到的從節(jié)點服務器防火墻一定要開放主節(jié)點中配置的代理端口

防火墻開通端口號

firewall-cmd --permanent --add-port 42730/tcpfirewall-cmd --reload

再次執(zhí)行連接命令后，連接成功

但是這種啟動方式會一直處于前臺運行，此時終端窗口無法再進行其他操作。因此，可以給它創(chuàng)建一個啟動腳本，使其后臺運行。

⑤ 創(chuàng)建啟動腳本

腳本內(nèi)容如下：

nohup java -jar agent.jar -jnlpUrl http://192.168.1.20:8080/jenkins/manage/computer/h122/jenkins-agent.jnlp -secret 5d40fefd1148aa3e1461eb53a7764f655c030a7859cfa648b2340ba019146a3d -workDir "/home/jenkins/workspace" 2>&1 >nohup.out  &

運行腳本

chmod +x start_agent.sh./start_agent.sh

3.測試構(gòu)建項目

在前面一篇《Jenkins實現(xiàn)前端項目自動化構(gòu)建》中，已經(jīng)在主節(jié)點成功構(gòu)建運行了前端項目，此時我們再次構(gòu)建該項目，看看它會不會在從節(jié)點運行。

當我點擊構(gòu)建時，該項目確實是通過我新建的從節(jié)點"h122"執(zhí)行構(gòu)建的

但出現(xiàn)了報錯"No such file or directory"，提示項目路徑不存在：

項目構(gòu)建報錯問題排查項目的配置：控制臺輸出日志：原本在master節(jié)點上運行時生成的工作目錄路徑：轉(zhuǎn)到slave從節(jié)點上運行時生成的工作目錄路徑：

經(jīng)過一番排查，終于找到了原因：

此項目原本是在主節(jié)點運行，我在主節(jié)點配置這個任務時，項目的路徑是寫死的：/home/jenkins/workspace/開普勒-前端，在主節(jié)點運行時確實有這個路徑，也能夠正常運行；但是我在配置從節(jié)點時設置的遠程工作目錄是：/home/jenkins/workspace，當從節(jié)點首次構(gòu)建項目時，也會生成一個workspace目錄，并在這個workspace目錄下創(chuàng)建以項目名稱“開普勒-前端”為名字的工作目錄，最后疊加在一起，從節(jié)點上該項目真正的工作目錄就是 /home/jenkins/workspace/workspace/開普勒-前端。而此時從節(jié)點匹配不到原本的"/home/jenkins/workspace/開普勒-前端"這個目錄，所以運行失敗。項目構(gòu)建報錯問題解決

解決方式有兩種：

一種是修改從節(jié)點配置，將遠程工作目錄路徑去掉一層workspace目錄；第二種是通過全局變量$WORKSPACE來聲明工作目錄；

全局變量

我用的是第二種，將構(gòu)建步驟中原本的"cd /home/jenkins/workspace/開普勒-前端"改為"cd $WORKSPACE"

再次構(gòu)建，構(gòu)建成功！

企微群也收到了構(gòu)建成功的消息通知：

二、添加Windows從節(jié)點1.從節(jié)點環(huán)境配置① 從節(jié)點安裝Jenkins

同樣是需要先在Windows電腦上提前安裝好Jenkins。

② 從節(jié)點環(huán)境配置

同樣需要安裝JDK、Git以及相關(guān)插件，如果是編譯前端項目，需要配置nodejs，如果是編譯后端項目，還需要安裝maven等。

2.添加從節(jié)點① 創(chuàng)建從節(jié)點

入口：系統(tǒng)管理-節(jié)點管理-添加節(jié)點，填寫從節(jié)點名稱，選擇固定節(jié)點

② 填寫從節(jié)點信息

同樣選擇“通過Java Web啟動代理”

在管理節(jié)點點擊查看新增的從節(jié)點詳情，會給出從節(jié)點如何連接主節(jié)點的提示：

③ 從節(jié)點連接主節(jié)點

在從節(jié)點上執(zhí)行：

curl -sO http://192.168.1.20:8080/jenkins/jnlpJars/agent.jarjava -jar agent.jar -jnlpUrl http://192.168.1.20:8080/jenkins/manage/computer/win188/jenkins-agent.jnlp -secret ed74e189c3cf7012fac65f0c9af7e091a1159d36ebbef8c581491fccff40a1b5 -workDir "C:\Users\chenjigang\.jenkins"

連接成功：

此時會在我們配置的自定義工作目錄下自動創(chuàng)建生成remoting內(nèi)部數(shù)據(jù)目錄

創(chuàng)建完成，從節(jié)點win188處于在線狀態(tài)：

3.指定項目運行節(jié)點配置Jenkins項目

比如我想為某個項目指定用這個從節(jié)點win188來運行，那么則可以在該項目配置-General中勾選“限制項目的運行節(jié)點”，并填寫標簽表達式，也就是前面我們填寫從節(jié)點時設置的標簽名稱“win188”

構(gòu)建該項目，可以看到，已經(jīng)通過win188這個從節(jié)點來運行：

報錯問題解決

但是在運行的時候報錯了，提示maven路徑不存在，原因是此項目原本是在主節(jié)點(Linux)上運行的，該臺機器上的maven目錄是/home/apache-maven-3.6.3，而換到了從節(jié)點(Windows)系統(tǒng)運行以后，maven路徑不一致。

需要在win188從節(jié)點配置中指定相關(guān)工具位置：

再次運行，構(gòu)建成功：

小結(jié)

以上就是Jenkins分別添加Linux從節(jié)點、Windows從節(jié)點以及構(gòu)建過程中出現(xiàn)報錯問題排查解決的全部過程。總體來說，不管Linux從節(jié)點還是Windows從節(jié)點，步驟基本一致。關(guān)鍵的是如何合理利用好這些節(jié)點，從而物盡其用，使其發(fā)揮出更大價值！

關(guān)鍵詞：