Arbess 是一款國產開源免費的 CI/CD 工具,支持免費私有化部署,輕量、簡潔易用。本文將詳細介紹流水線配置結束後,如何開啓流水線運行評審,以及釘釘通知評審人。
1、Arbess 安裝與配置
1.1 安裝
本文以CentOS操作系統為例。
- 下載,服務端安裝包含Agent安裝,CentOS安裝包下載地址:Arbess下載,點擊CentOS下載,下載完成後得到類似tiklab-arbess-x.x.x.rpm的文件。
- 安裝,上傳到服務器上,在文件同級目錄執行命令安裝。
rpm -ivh tiklab-arbess-x.x.x.rpm
- 啓動,系統默認安裝路徑為/opt目錄,進入/opt/tiklab-arbess/bin目錄下,執行./arbess start即可啓動成功。
啓動Arbess系統
使用 http://ip:9200 進行訪問。使用初始用户名密碼admin\123456登錄,首次登錄需要修改管理員密碼。成功登錄後展示Arbess首頁。
Arbess首頁
1.2 配置流水線
Arbess流水線採用可視化設計,實現Java項目自動化部署,在流水線中配置通用git代碼、構建安裝包並部署主機。創建流水線,進入流水線設計頁面進行操作。
- 添加通用git源碼任務
服務集成添加完畢之後,進入流水線設計,點擊新階段→源碼→通用git。需要填入任務名稱、Git版本、Git倉庫地址、分支、通用Git授權信息等。
添加源碼任務
|
字段 |
描述 |
|
任務名稱 |
任務名稱清晰地標識項目或對象。 |
|
Git版本 |
Arbess所在服務器Git安裝路徑。 |
|
Git倉庫地址
|
通用Git地址。 |
|
倉庫 |
選擇授權信息後點擊倉庫,程序會自動獲取憑證權限下的倉庫列表,管理者只需選擇需要配置的倉庫即可。 |
|
通用git服務 |
通用Git授權信息。 |
- 配置Maven構建任務
代碼掃描添加完畢之後,添加構建安裝包任務。根據代碼構建方式選擇Maven構建,點擊新階段→構建→Maven構建。輸入構建信息,輸入完成後,點擊空白處進行保存。
配置Maven構建任務
|
字段 |
描述 |
|
任務名稱 |
任務名稱清晰地標識項目或對象。 |
|
JDK版本 |
Arbess所在服務器JDK安裝路徑。 |
|
Maven版本 |
Arbess所在服務器Maven安裝路徑。 |
|
模塊地址 |
構建路徑,默認為${DEFAULT_CODE_ADDRESS},也可輸入絕對路徑。 |
|
執行命令 |
執行Maven構建的命令。 |
- 配置主機部署任務
點擊新階段→部署→主機部署。輸入部署信息,部署的內容可以使用變量,添加變量後使用${變量名稱}進行引用,輸入完成後,點擊空白處進行保存。
配置主機部署任務
|
字段 |
描述 |
|
任務名稱 |
任務名稱清晰地標識項目或對象。默認主機部署。 |
|
主機地址 |
部署主機遠程SSH認證憑證。 |
|
部署文件 |
需要部署的文件,可以寫絕對路徑,也可以寫泛路徑,泛路徑需要配合部署文件規則來匹配到部署文件。
|
|
部署文件匹配規則
|
文件匹配規則,支持正則表達式。
|
|
部署位置 |
部署遠程主機位置。
|
|
部署命令 |
文件部署命令。 |
至此流水線設計完畢,下面介紹流水線發佈審核配置。
2、消息配置
2.1 發送方式配置
配置流水線發佈通知釘釘,需要配置釘釘機器人Hook地址。在釘釘打開任意一個羣聊 --> 右上角新建機器人。
添加機器人
選擇自定義Webhook機器人。
添加機器人
輸入機器人名字,安全設置選擇加簽,需要保存生成的密鑰。
生成密鑰
點擊完成,進入下一步,展示WebHook地址,保存WebHook地址。
保存WebHook地址
獲取機器人Hook地址後,進入Arbess系統設置消息頁面,配置釘釘機器人Webhook地址和密鑰。
配置釘釘機器人
配置完成後,可點擊測試按鈕進行測試。
測試機器人
2.2 通知方案配置
配置完成後,配置通知方案。點擊需要配置的方案名稱,進入配置頁面。
配置通知方案
可同時開啓站內信、郵箱、APP、企業微信、釘釘消息通知。
通知方案
其中釘釘通知方案遵循Markdown文檔格式,可自行修改模版。
3、發佈審核
消息配置完成後,還需要開啓流水線發佈審核,進入流水線詳情,在流水線設置的評審,開啓當前流水線評審並配置評審人。
開啓流水線評審
流水線評審開啓後,在流水線設計頁面可提交評審。
提交評審
提交的評審在流水線發佈頁面顯示評審。
開始評審
點擊開始評審,會向釘釘發送消息通知。
消息通知
點擊消息通知的鏈接,可快速進入評審頁面。
評審不通過不允許運行流水線,評審通過之後,可以對流水線進行運行。
流水線評審
4、運行流水線
- 運行流水線
流水線評審通過後,可以對流水線進行執行。
完成評審
運行流水線
流水線運行同時,可以點擊相關流水線,查看運行實時日誌。
查看詳細日誌
至此,使用Arbess成功搭建流水線,開啓流水線發佈評審,並使用釘釘通知評審人進行評審。