【Jenkins】外掛套件:Credentials

  有的時候專案需要經過驗證才能進行管理,在 Jenkins 中使用 Credentials 通過驗證。

1、Jenkins 套件管理

  由 Jenkins 主畫面依序點選「管理 Jenkins」 → 「管理外掛程式」,進入「Jenkins 套件」管理頁面。

01:Jenkins_Plugin_Manager

1.1 安裝 Credentials plugin、SSH Credentials plugin

  點選「可用的」頁籤,輸入過濾條件「Credentials」,選取【CredentialsSSH Credentials】並按下【下載並於重新啟動後安裝】。

  • Credentials plugin:Username/Password、Certificate 基本驗證功能。
  • SSH Credentials plugin:SSH Private Key 驗證功能。
  • 兩者皆為 Git plugin 相依套件,安裝 Git plugin 時會一併安裝。
  • 套件安裝有【直接安裝】與【下載並於重新啟動後安裝】兩種選擇。【下載並於重新啟動後安裝】是比較安全的做法,可避免工作正在執行時套件被更新而造成錯誤。

02:Filter_Credentials_Plugin

  套件安裝過程中會將相依套件一併載入安裝,安裝完成後顯示「下載成功。下次啟動後就會生效。」。

  當套件與相依套件全部下載完成後,按下【當安裝完成且沒有工作正在執行時,重啟 Jenkins】重新啟動 Jenkins。

03:Credentials_Plugin_Install

2、Jenkins Credentials 管理

  由 Jenkins 主畫面依序點選「Credentials」(安裝 Credentials plugin 產生的選項) → 「System」 → 「Global credentials (unrestricted)」,進入「Jenkins Credentials」管理頁面。

04:Jenkins_Credentials_Manager

  按下【Add Credentials】進入「新增 Credentials」頁面。

05:Credentials_Kind_Scope

2.1 Credentials Kind

  Credentials Kind 有三種選項:「Username with password」(安裝 Credentials plugin 產生的選項)、「SSH Username with private key」(安裝 SSH Credentials plugin 產生的選項)、「Certificate」(安裝 Credentials plugin 產生的選項),使用下拉選單選擇不同的 Credentials Kind 來對應不同的驗證方式。

2.2 Credentials Scope

  Credentials Scope 有兩種選項:「Global (Jenkins, nodes, items, all child items, etc)」、「System (Jenkins and nodes only)」,使用下拉選單選擇不同的 Credentials Scope 來定義 Credentials 不同的存取範圍。

工作(Job)屬於 item 的一種,想要在工作中使用 Credentials 需要把 Credentials Scope 設定為 Global。

3、工作組態設定

  由 Jenkins 主畫面依序點選「Lab.Jenkins_VisualStudio」(前面新增的工作名稱) → 「組態」,進入「工作組態」設定頁面。

3.1 原始碼管理

  點選「原始碼管理」頁籤,選取【Git】,於「Credentials」下拉選單選擇 Credentials 對原始碼管理伺服器進行驗證,按下【儲存】儲存工作組態設定。

06:Job_Configure_Setting_Credentials

3.2 工作建置

  按下【馬上建置】,此時此項工作會使用 Credentials 與原始碼管理伺服器進行驗證,再使用 Git 由 Repository URL 取得檔案。

Credentials:在【2、Jenkins Credentials 管理】中設定,在【3.1 原始碼管理】中選擇。

07:Job_Build

4、Jenkins Credentials 快速新增

  由 Jenkins 主畫面依序點選「Lab.Jenkins_VisualStudio」(前面新增的工作名稱) → 「組態」,進入「工作組態」設定頁面。

  點選「原始碼管理」頁籤,選取【Git】,於「Credentials」旁按下【Add】 → 【Jenkins】,開啟「新增 Credentials」頁面。

與【2、Jenkins Credentials 管理】設定相同。

08:Job_Configure_Create_NewCredentials

嘗試將自己的理解寫成文字紀錄,資料來源均來自於網路。

如有理解錯誤、引用錯誤或侵權,請多加指正與告知,讓我有更多的進步與改進的空間,謝謝!