Jenkins自動化網頁應用程式佈署與測試

– 7 分鐘閱讀

Jenkins 是網頁應用程式專案自動化流程管理的利器。透過建立上游工作流程，程式碼異動時能自動觸發佈署至伺服器，並串接下游工作流程執行測試與產生報告。此流程確保程式碼佈署與測試自動化，快速反應程式碼變更並及時發現問題。引數化管道工作流程則提供彈性，可依不同需求設定引數，例如佈署路徑或測試型別，打造更客製化的自動化流程。文章接下來將逐步說明如何在 Jenkins 中設定具體的工作流程，包含程式碼簽出、佈署、測試等步驟，並以計算器網頁應用程式為例，示範如何將這些步驟整合到 Jenkins Pipeline 中，實作完整的 CI/CD 流程。

網頁應用程式專案管理的Jenkins工作流程

在管理網頁應用程式專案時，建立一個自動化的工作流程是非常重要的。這個工作流程可以幫助我們自動化從程式碼變更到佈署和測試的整個過程。下面，我們將介紹如何使用Jenkins建立一個管理網頁應用程式專案的工作流程。

建立上游工作流程

首先，我們需要建立一個上游工作流程（upstream job），這個工作流程會在程式碼變更時自動觸發。這個工作流程的主要任務是將最新的程式碼佈署到伺服器上。

  flowchart TD
    A[程式碼變更] --> B[觸發上游工作流程]
    B --> C[提取最新程式碼]
    C --> D[佈署到伺服器]
    D --> E[觸發下游工作流程]

內容解密：

上游工作流程的主要步驟包括提取最新的程式碼、佈署到伺服器和觸發下游工作流程。這個工作流程可以幫助我們自動化佈署的過程，確保最新的程式碼可以快速地佈署到伺服器上。

建立下游工作流程

下游工作流程（downstream job）會在上游工作流程完成後自動觸發。這個工作流程的主要任務是執行測試並將測試報告傳送給相關人員。

  flowchart TD
    A[上游工作流程完成] --> B[觸發下游工作流程]
    B --> C[提取最新測試程式碼]
    C --> D[執行測試]
    D --> E[生成測試報告]
    E --> F[傳送測試報告]

內容解密：

下游工作流程的主要步驟包括提取最新的測試程式碼、執行測試、生成測試報告和傳送測試報告。這個工作流程可以幫助我們自動化測試的過程，確保測試報告可以快速地傳送給相關人員。

引數化管道工作流程

引數化管道工作流程（parameterized pipeline job）可以幫助我們自定義工作流程的引數。這個功能可以讓我們根據不同的需求定義不同的工作流程引數。

  flowchart TD
    A[定義引數] --> B[建立引數化管道工作流程]
    B --> C[觸發工作流程]
    C --> D[執行工作流程]

內容解密：

引數化管道工作流程的主要步驟包括定義引數、建立引數化管道工作流程和觸發工作流程。這個功能可以幫助我們自定義工作流程的引數，讓我們可以根據不同的需求定義不同的工作流程引數。

圖表翻譯：

這些圖表展示瞭如何使用Jenkins建立一個管理網頁應用程式專案的工作流程。上游工作流程負責佈署最新的程式碼，下游工作流程負責執行測試並將測試報告傳送給相關人員。引數化管道工作流程可以幫助我們自定義工作流程的引數，讓我們可以根據不同的需求定義不同的工作流程引數。

建立Jenkins工作以管理Web應用程式專案

在本章中，我們將探討如何建立Jenkins工作以管理Web應用程式專案。具體來說，我們將建立一個管道工作，以構建和佈署計算器Web應用程式。

步驟1：建立管道工作

首先，登入Jenkins儀錶板，點選“新建專案”選單。輸入工作名稱，例如BuildAndDeployCalculatorWebApplicationPipeline，並選擇“管道”選項。點選“確定”按鈕。

步驟2：組態工作引數

在工作組態頁面中，選擇“本專案是引數化的”核取方塊。建立兩個引數：一個字串引數用於儲存計算器.html檔案的目錄路徑，另一個選擇引數用於定義要執行的Selenium測試組。

步驟3：組態原始碼管理

選擇“輪詢SCM”核取方塊，並組態輪詢時間表，如前幾章所述。在管道編輯器中，撰寫管道指令碼。使用Snippet Generator生成指令碼程式碼，並將其放置在管道指令碼編輯器中。

步驟4：實作簽出計算器Web應用程式倉函式庫階段

在管道指令碼中，實作簽出計算器Web應用程式倉函式庫階段，如下所示：

node {
    def mvnHome
    stage('簽出計算器Web應用程式倉函式庫') {
        git credentialsId: 'MyGithubCredentials', url: 'https://github.com/username/CalculatorWebApplication.git'
    }
}

步驟5：實作佈署Web應用程式階段

一旦應用程式碼被提取，您需要將Calculator.html檔案從$(Workspace)\src\main\webapp\複製到PathOfCalcualtorAppDeploymentDirectory引數中指定的路徑。

使用Snippet Generator生成Windows批次指令碼程式碼，並將其放置在管道指令碼編輯器中，內部佈署Web應用程式階段塊中，如下所示：

stage('佈署Web應用程式') {
    //...
}

這樣就完成了建立Jenkins工作以管理Web應用程式專案的過程。接下來，我們將繼續探討如何實作Selenium測試和佈署Web應用程式的詳細步驟。

圖表翻譯：

以下是管道工作流程的Mermaid圖表：

  flowchart TD
    A[建立管道工作] --> B[組態工作引數]
    B --> C[組態原始碼管理]
    C --> D[實作簽出計算器Web應用程式倉函式庫階段]
    D --> E[實作佈署Web應用程式階段]
    E --> F[執行Selenium測試]

這個圖表展示了管道工作流程的各個階段，從建立管道工作到執行Selenium測試。

佈署Web應用程式

在佈署Web應用程式的階段，我們需要將應用程式佈署到指定的目錄。以下是佈署階段的指令碼：

stage('Deploying Web Application') {
    bat """
        RMDIR %PathOfCalculatorAppDeploymentDirectory%
        MKDIR %PathOfCalculatorAppDeploymentDirectory%
        copy /y src\\webapp\\Calculator.html %PathOfCalculatorAppDeploymentDirectory%
    """
}

注意，我們使用了 %PathOfCalculatorAppDeploymentDirectory% 來代表佈署目錄的路徑。

測試Web應用程式

在測試Web應用程式的階段，我們需要呼叫另一個pipeline job，稱為 TestCalculatorWebApplicationPipeline。以下是測試階段的指令碼：

stage('Testing Calculator Web Application') {
    build job: 'TestCalculatorWebApplicationPipeline', parameters: [
        [$class: 'StringParameterValue', name: 'TestType', value: params.TypeOfTests]
    ]
}

在這個指令碼中，我們呼叫 TestCalculatorWebApplicationPipeline job，並傳遞一個引數 TestType，其值為 params.TypeOfTests。

建立測試pipeline job

現在，我們需要建立 TestCalculatorWebApplicationPipeline job。以下是建立job的步驟：

  1. 點選「New Item」選單，輸入job名稱 TestCalculatorWebApplicationPipeline，並選擇「Pipeline」選項。
  2. 點選「OK」按鈕。
  3. 選擇「This Project Is Parameterized」checkbox。
  4. 儲存job設定。

注意，建立job的過程需要按照Jenkins的使用進行。

從技術架構視角來看，本文介紹的Jenkins工作流程，透過上游和下游工作流程的串接，實作了網頁應用程式專案的自動化建置與佈署。此架構有效區分了程式碼佈署和測試流程，提升了整體效率，也便於針對不同階段進行客製化設定。然而，文中僅以 Calculator Web Application 為例，對於複雜的專案，此架構的彈性仍待商榷，例如多環境佈署、版本控制等議題未有深入探討。此外，文中提及引數化管道的使用，卻未詳細說明如何根據不同引數調整佈署和測試策略，這在實務應用中是至關重要的。

透過多維比較分析，相較於傳統手動佈署和測試，Jenkins 工作流程顯著提升了效率，並減少了人為錯誤。但同時也引入了新的技術挑戰，例如 Jenkins 伺服器的維護、pipeline 指令碼的撰寫和除錯等。對於規模較小的團隊，匯入 Jenkins 的成本效益需要仔細評估。技術限制深析則顯示，文中提供的指令碼範例過於簡化，缺乏錯誤處理機制和日誌記錄功能，在實際應用中需要進一步完善。

展望未來，隨著雲原生技術的發展，Jenkins 與 Kubernetes 等容器協調平臺的整合將成為趨勢，這將進一步提升佈署效率和資源利用率。同時，GitOps 等新興實務的應用，也有望簡化 Jenkins 工作流程的管理和維護。玄貓認為，Jenkins 雖已成為 CI/CD 領域的主流工具，但仍需持續關注新技術的發展，並積極探索更最佳化的實踐方案，才能在快速變化的技術環境中保持競爭力。對於追求效率和自動化的團隊，深入理解 Jenkins 的核心功能並結合自身業務需求進行客製化組態，將是提升軟體交付效能的關鍵所在。

玄貓

玄貓

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