Jenkins 工作原理設定與觸發機制

– 8 分鐘閱讀

Jenkins 工作的設定包含認證管理、分支設定和建置觸發器等多個導向。認證管理允許 Jenkins 使用 Windows 認證管理器中的認證進行驗證。分支設定則可指定 Jenkins 從特定分支下載程式碼。建置觸發器提供多種方式啟動工作，例如遠端觸發、輪詢 SCM 或根據特定事件觸發。此外，Jenkins 也支援在其他專案建置後觸發特定工作，並可根據相依工作的狀態設定觸發條件。定時任務觸發則允許使用者使用 Cron 表示式定義工作執行的時間表，實作例行性任務的自動化。

Jenkins 工作原理與設定

在 Jenkins 中，工作（Job）是指一系列的任務，例如編譯程式碼、執行測試、佈署應用程式等。瞭解工作的設定和運作原理是使用 Jenkins 的關鍵。

認證管理

Jenkins 可以從 Windows 認證管理器中取得使用者的認證，如此一來，即使在 Repository URL 欄位中沒有選擇認證，Jenkins 仍然可以使用存放在 Windows 認證管理器中的認證進行驗證。如果從 Windows 認證管理器中移除認證，Jenkins 將會出現驗證錯誤，除非在 Credentials 下拉選單中選擇了正確的認證。

分支設定

Jenkins 預設會從 master 分支中尋找變更並下載程式碼。如果您想要 Jenkins 從不同的分支中尋找變更和下載程式碼，則需要在「Branches to Build」欄位中指定新的分支名稱。

建置觸發器

Jenkins 提供了多種設定來控制何時啟動工作。其中包括：

  • 遠端觸發建置（例如從指令碼）：您可以從外部實體（如 Git 倉函式庫）觸發 Jenkins 工作。
  • 輪詢原始碼倉函式庫：Jenkins 可以按照指定的時間間隔檢查原始碼倉函式庫中的變更，並在發現變更時觸發工作。
  • 從 SCM 在特定事件觸發 Jenkins 工作：與其讓 Jenkins 持續輪詢 SCM 以尋找變更，您可以設定 SCM 在特定事件（如合併請求被接受時）觸發工作。

遠端觸發工作

如果您想要使用第二個選項（從 SCM 在特定事件觸發 Jenkins 工作），則需要勾選「Trigger Build Remotely (e.g. From Scripts)」選項。每個 Jenkins 工作都有一個用於遠端觸發的 URL，格式如下：

JENKINS_URL/job/<工作名稱>/build?token=<TOKEN名稱>

其中：

  • JENKINS_URL 是用於存取 Jenkins 的 URL。
  • <工作名稱> 是 Jenkins 工作的名稱（注意，這應該是工作名稱而不是顯示名稱）。
  • <TOKEN名稱> 是用於觸發工作的存取令牌。

例如，如果您的 Jenkins URL 是 http://example.com/jenkins，工作名稱是 MyFirstJenkinsJob，而存取令牌是 abcd123456890，則遠端觸發 URL 將是：

http://example.com/jenkins/job/MyFirstJenkinsJob/build?token=abcd123456890

這些設定和功能使得 Jenkins 能夠根據不同的需求和事件自動化工作流程，提高了開發和佈署的效率。

在其他專案建置後觸發建置

當您想要在其他專案建置完成後觸發某個工作（Job），可以選擇此選項。這種機制與工作之間的相依性有關，例如，一個工作可能使用由另一個工作建立的工件（Artifacts）。如果您的工作依賴於玄貓建立的工件，那麼您應該選擇此選項，並在「監視的專案」欄位中新增「CompileJavaApplication」的名稱，以便當「CompileJavaApplication」完成其執行並提供必要的工件給您的工作時，觸發您的工作。

您可以根據相依工作的狀態組態何時觸發此工作以及何時不觸發，使用以下三個選項：

  • 僅在建置穩定時觸發：如果選擇此選項，則只有當相依的工作是穩定的時候，才會觸發此工作。穩定意味著建置執行成功。
  • 即使建置不穩定也觸發：如果選擇此選項，即使相依的工作建置是不穩定的，也會觸發此工作。不穩定的建置意味著雖然建置可以完成其任務，但有一些發布者（Publishers）會將其報告為不穩定。例如，如果一個建置正在編譯一個應用程式，並且Junit發布者被組態為發布單元測試的報告，而編譯是成功的，但單元測試失敗，那麼Junit發布者會將此建置標記為不穩定。
  • 即使建置失敗也觸發：如果選擇此選項，即使相依的工作建置失敗或破損，也會觸發此工作。失敗或破損的建置意味著一個或多個建置步驟失敗，且建置無法完成其任務。

定期建置

此選項允許您在特定的時間間隔觸發建置，例如每日、每月、每週等。它提供了一種類別似於Windows中的工作排程器或UNIX系統中的cron job的功能。然而，在我的意見中，定期觸發工作並不遵循CI/CD原則，因為CI/CD期望在程式碼變化時立即對軟體建置給出反饋，而不是在一週或一個月後。

內容解密：

上述內容描述了Jenkins中如何組態工作之間的相依性和觸發機制。瞭解這些選項可以幫助您更好地控制工作的執行順序和時機，從而實作更流暢的CI/CD流程。

圖表翻譯：

  graph LR
    A[工作A] -->|相依|> B[工作B]
    B -->|觸發|> C[工作C]
    C -->|執行|> D[結果]
    style A fill:#f9f,stroke:#333,stroke-width:4px
    style B fill:#f9f,stroke:#333,stroke-width:4px
    style C fill:#f9f,stroke:#333,stroke-width:4px
    style D fill:#f9f,stroke:#333,stroke-width:4px

這個Mermaid圖表展示了工作之間的相依關係和觸發順序。當工作A完成後，會觸發工作B，然後工作B會觸發工作C，最後工作C執行並產生結果。這個過程體現了Jenkins中工作之間的相依性和觸發機制。

瞭解Jenkins中的定時任務觸發

在Jenkins中，定時任務觸發是一個強大的功能，允許您根據特定的時間表執行任務。這對於需要定期執行的任務，例如每日構建和佈署應用程式到測試環境，尤其有用。

Chron表示式格式

Chron表示式是一種用於定義時間表的格式，共有五個欄位，分別是：

  • 分鐘（MINUTE）：一小時內的分鐘（0-59）
  • 小時（HOUR）：一天中的小時（0-23）
  • 日期（DOM）：一個月中的日期（1-31）
  • 月份（MONTH）：一年中的月份（1-12）
  • 周幾（DOW）：一週中的周幾（0-6），其中0和7均代表星期日

寫入Chron表示式

如果您想要在每天的8:45觸發一個任務，您可以寫入以下的Chron表示式：

45 8 * * *

這個表示式告訴Jenkins在每天的8:45執行任務。

組態Jenkins的定時任務觸發

要組態Jenkins的定時任務觸發，您需要在Jenkins的使用者介面中找到「排程」欄位，並在其中寫入您的Chron表示式。例如，如果您想要Jenkins每5分鐘檢查一次程式碼變化，您可以寫入以下的Chron表示式：

H/5 * * * *

這個表示式告訴Jenkins每5分鐘檢查一次程式碼變化。

圖表翻譯：

  flowchart TD
    A[開始] --> B[組態Jenkins]
    B --> C[寫入Chron表示式]
    C --> D[設定排程]
    D --> E[觸發任務]

內容解密：

上述的Mermaid圖表展示了組態Jenkins的定時任務觸發的流程。首先，您需要開始組態Jenkins，然後寫入您的Chron表示式，接著設定排程，最後觸發任務。這個流程允許您根據特定的時間表執行任務，從而提高您的工作效率。

Jenkins 作業流程與監控

在 Jenkins 中，作業（Job）是用於定義和執行特定任務的基本單元。瞭解如何建立、組態和執行 Jenkins 作業是使用 Jenkins 的基礎。

作業組態

建立一個 Jenkins 作業後，可以組態其觸發器（Trigger）以定義何時執行作業。例如，可以設定作業每隔五分鐘檢查一次版本控制系統（SCM）是否有變化，如果有變化，則觸發作業的執行。

建立作業步驟

作業步驟（Build Step）是指在作業中執行的具體任務。可以新增多個步驟到一個作業中，這些步驟將按照新增的順序依次執行。例如，可以新增一個執行 Windows批次命令的步驟，或者執行其他建置工具的目標。

後置動作

後置動作（Post-Build Actions）允許您在作業完成後執行特定的動作。例如，可以設定在作業完成後傳送電子郵件通知。這些動作可以根據需要新增多個。

執行作業與檢視輸出

建立並儲存作業後，可以從 Jenkins儀錶板手動啟動它。啟動後，可以在「建置執行器狀態」部分檢視作業的執行狀態。完成後，可以檢視建置歷史記錄，包括每次建置的詳細日誌。

建置歷史記錄與控制檯輸出

透過點選「建置歷史記錄」連結，可以檢視所有已執行建置的記錄。選擇特定的建置記錄，可以檢視該建置的控制檯輸出，包括執行過程中的詳細日誌資訊。

圖示說明
  • 圖 10-18：展示了新增到單一作業中的多個建置步驟。
  • 圖 10-19：顯示了作業執行時的進度條。
  • 圖 10-20：展示了建置歷史記錄頁面，列出了所有已執行建置的記錄。
  • 圖 10-21：顯示了選定建置的控制檯輸出詳細日誌。

透過這些步驟和功能，Jenkins 提供了一個強大的平臺來自動化和管理軟體開發和佈署過程。

Jenkins 作為 CI/CD 領域的翹楚，其高度可定製化的工作流程設計對提升軟體交付效率至關重要。本文深入探討了 Jenkins 的核心功能，包括認證管理、分支設定、建置觸發器、工作流程協調以及監控機制。透過多維比較分析，可以發現 Jenkins 在靈活性方面表現出色，支援多種觸發方式和建置步驟，能滿足不同規模和複雜度的專案需求。然而，Jenkins 的設定複雜度較高，需要一定的學習成本，尤其對於 Chron 表示式和工作流程的協調，初學者可能需要額外投入時間。

技術限制深析顯示，雖然 Jenkins 提供了豐富的外掛生態，但也可能造成版本相容性和維護成本的上升。此外，Jenkins 的分散式建置能力雖能提升效率，但在大型專案中，如何有效管理和監控大量的建置節點仍是一項挑戰。對於資源有限的團隊，建議優先將 Jenkins 應用於核心專案的自動化建置和佈署，並逐步拓展其應用範圍。

展望未來，雲原生 CI/CD 工具的興起對 Jenkins 的市場地位帶來一定衝擊。然而，Jenkins 龐大的使用者基礎和成熟的社群生態使其仍具備相當的競爭力。玄貓認為，Jenkins 應持續強化其在雲原生環境下的整合能力，並簡化設定流程以降低使用門檻。隨著 DevOps 理念的普及，Jenkins 在可預見的未來仍將扮演重要的角色，其與其他工具的整合與協同發展將是未來的重要趨勢。

玄貓

玄貓

技術愛好者，專注於分享程式開發、雲端技術與 AI 應用的心得體會。