一、序言

Jenkins 是一款自動化構建工具，能夠基於 Maven 構建後端 Java 專案，也能夠基於 nodejs 構建前端 vue 專案，並且有視覺化 web 介面。

所謂自動化構建是按照一定的策略執行打包指令碼，相對於普通指令碼構建，Jenkins 有如下優勢：

• 構建佇列中能夠同時構建多個專案，包含前端和後端專案；
• 定時構建；
• 程式碼倉庫觸發構建（普通指令碼無法實現）；

Jenkins 體現一種專案管理思維：開發人員的貼心助理，集中精力專注於業務開發；儘早的實現程式碼整合（包含前後端）以便儘早發現問題；構建環境與開發環境隔離，為向生產環境遷移做好充足的準備。

構建過程全程自動化進行，無人工參與，配合 Docker 容易實現高效的專案部署與遷移。

二、安裝與使用

Jenkins 是一個工具，既然是一個工具，便有相應的替代方案，因此不需要花工作的時間琢磨這個工具是如何工作的，將精力放在如何利用 Jenkins 提高敏捷開發效率上更有意義。

實踐過程中，將專案的指令碼化構建用 shell 編寫成命令指令碼，並附加在專案中，即使不使用 Jenkins，通過執行 shell 指令碼也能夠實現專案的自動化構建。這麼做主要有如下考慮：

• 增強拓展性

即使沒有 Jenkins，專案也能完成構建，增加構建的拓展性

• 減少對 Jenkins 的依賴

讓 Jenkins 承擔實踐排程的角色，具體構建過程由標準化的指令碼來完成。

既然 shell 指令碼能夠完成自動化構建，那麼還需要用到 Jenkins 嗎，是否衝突？答案是不衝突。shell 指令碼配合 Jenkins 使用有兩大方面優勢：

• 使用 shell 指令碼必須登入目標伺服器，擁有相應的許可權後，方能執行 shell 指令碼，Jenkins 能夠實現在不登入目標伺服器的基礎上，使用一對賬號和密碼，管理視覺化的 Web 操作介面觸發構建事件。
• 按需構建，開發者在提交完程式碼後，向 Jenkins 伺服器傳送一個訊號，便可觸發構建。

（一）安裝

使用[傳送門]快捷安裝，啟動後使用安裝推薦外掛，內建國內外掛源，安裝速度較快。

1、檢視初始密碼

cat ~/.jenkins/secrets/initialAdminPassword

2、修改預設工作空間

預設工作空間路徑為~/.jnkins，執行 Jenkins 程式的使用者空間下，構建完成後的專案，如果要放在第三方容器中執行時，有可能會出現找不到路徑的情況，修改預設工作空間或者給予資源目錄可執行許可權都能解決此問題。

安裝完成之後，暫時啟動程式，先確認是否需要修改Jenkins_HOME變數，後續初始化以及外掛的安裝與此路徑有關。此變數修改方式有多種，顆粒度較大的是配置在 PATH 環境變數中，顆粒度較小的是配置在執行 Jenkins 專案的容器中。

修改 Tomcat 的配置檔案 context.xml，增加一行配置

<!-- 建立一個jenkins，並將其使用者空間設定為JENKINS_HOME -->
<Environment name="JENKINS_HOME" value="/home/jenkins" type=java.lang.String/>

注意：JENKINS_HOME預設值為啟動程序使用者對應的使用者空間，在啟動前修改後即變成新的路徑。

（二）使用

如果在配置遠端 APiToken 觸發不生效，請閱讀免密登入章節。

1、構建配置

用指令碼的方式構建 Jenkins 專案配置非常簡單，儘管內建了很多花裡胡哨的配置，這裡用不到，不需要關心。

只需要在構建中新增執行 shell 指令碼命令即可。附錄中列舉的環境配置統一在宿主機上完成，不在 Jenkins 服務內部配置，使用預設值即可。

2、新增專案

在宿主機上將待構建專案的原始碼克隆到本地，執行 shell 指令碼完成手動構建。在 Jenkins 管理工作臺新建一個同名的空專案，將克隆的原始碼整體複製到 Jenkins 的工作空間下，預設位置為/root/.jenkins/workspace，委託給 Jenkins 代為自動管理該專案。

（三）免密登入

使用 URL 觸發構建事件，需要配置免密登入，即在不需要輸入使用者名稱和密碼的情況下，通過遠端呼叫 shell 指令碼觸發構建事件，此 shell 指令碼本質上是 GET 的方式請求某個指定的路徑。操作過程如下：

（1）安裝外掛

安裝Build Authorization Token Root Plugin外掛，如果已經存在，則忽略此步驟。此外掛的作用是給當前登入的使用者生成 Token，方便後續認證使用，一個使用者可以配置多個 token。

（2）專案配置

在指定的專案中新增 token 配置，專案可以複用一個 token 或者每個專案單獨設定一個 token，依據需要選擇。只有新增此配置之後，使用 token 觸發方能生效。

（3）客戶端使用

編寫指令碼，將指令碼分發給開發者，自動化構建便可以愉快的開始了。使用curl多引數時，&符號需要轉義。

curl {Jenkins URL}/buildByToken/build?job={專案名}\&token={token}

至此，CI/CD敏捷開發配置完畢。

三、觸發策略

構建事件可以按照不同的策略來定義，定時屬於被動觸發；URL 和鉤子程式屬於主動觸發。

（一）定時觸發

定時觸發有多種實現方案，使用 CentOS 伺服器內建的定時排程器是較為輕量的解決方式，實現原理是在指定的時間節點執行 shell 指令碼，其中 shell 指令碼便是專案構建的載體。如果單純希望定時構建專案，推薦使用此種解決方式，Jenkins 略顯笨重。

（二）URL 觸發

用指令碼模擬或者在瀏覽器訪問 URL 觸發構建事件。此種方式是開發中用的比較多的方式，按需構建的代表。軟體開發者在提交完程式碼後，主動觸發構建事件，這種方式構建效率較高。

Build Triggers

構建觸發器是指 Jenkins 收到某一訊號之後，立即開始構建指定的任務。

勾選【Trigger builds remotely】並設定【Authentication Token】

# 【服務字首】/job/【任務名】/build?token=【token】
JENKINS_URL/job/job-vue/build?token=TOKEN_NAME

通過使用 curl 指令碼即可觸發構建訊號。

（三）鉤子觸發

在程式碼倉庫完成鉤子程式配置，並且允許程式碼倉庫伺服器訪問 Jenkins 伺服器，鉤子程式會在開發者提交程式碼時觸發構建事件。

鉤子觸發看上去比較美，實際操作中有一定的前置條件：一是專案的構建時間不能過長；二是提交程式碼不能過於頻繁。

附錄、工具使用

1、語言設定

在【系統管理】>【外掛管理】中新增【locale】外掛。在【系統管理】>【全域性配置】中 locale 欄目下新增【en_US】，並勾選對所有使用者生效選項。

建議統一使用英文介面（可以修改為中文），在中英文混合下操作比較彆扭。

2、構建環境清單

3、環境配置

1、Maven Configuration

2、JDK

3、Git

4、Maven

5、NodeJS

4、任務配置

1、Source Code Management

原始碼管理是 Jenkins 工作的前提，即能夠獲取到任務原始碼，它是後續程式碼自動構建的前提。

原始碼託管在 GitHub，並且是私有倉庫，Jenkins 正確訪問 git 倉庫需要進行授權。

# 基於http使用者名稱和密碼授權
https://gitee.com/decsa/ucode-cms-vue.git
# 基於公鑰和私鑰匙授權
[email protected]:decsa/ucode-cms-vue.git

為了提高工作效率，促進團隊協作，這裡選用 ssh 認證。

ssh-keygen -t rsa -C "[email protected]"

將檔案【~/.ssh/id_rsa.pub】內字串拷貝至 GitHub 設定中，配置後即可免密拉取 GitHub 私有倉庫程式碼。

更多內容請檢視 [SSH 使用手冊]

2、Build Triggers

構建觸發器是指 Jenkins 收到某一訊號之後，立即開始構建指定的任務。

勾選【Trigger builds remotely】並設定【Authentication Token】

# 【服務字首】/job/【任務名】/build?token=【token】
JENKINS_URL/job/ruoyi-vue/build?token=TOKEN_NAME

通過在任一登陸的伺服器的瀏覽器或者使用 curl 指令碼即可出發任務的立即構建。

3、Build

後端專案通常使用 Maven 來構建，在下拉框中選擇【Invoke top-level Maven targets】，然後在 Goals 欄目中配置如下命令

clean install

經過此步驟，能夠在工作空間找到構建後的專案釋出包。

4、Post-build Actions

在任務構建完成之後出發此操作。通常使用 Docker 將專案釋出包構建成映象，然後釋出到映象倉庫中。可執行的映象釋出到映象倉庫之後，有兩種比較常用的後續方案與應用伺服器互動。

Jenkins 通過授權認證，登陸到目標應用伺服器，將對應的映象拉下來，然後使用指令碼啟動。

通過使用 k8s 容器服務，自動化管理任務映象釋出工作。

原文地址