配置 Delivery Pipeline

DevOps Insights 將於 2026 年 8 月 31 日結束服務並停止運作。Continuous Delivery 將於 2027 年 2 月 12 日在以下地區停止運作：au-syd、ca-tor、us-east。 Code Risk Analyzer 也將於該日於所有地區停止提供服務。 若某個區域未實際使用這些功能，該區域中的功能可能會提前停用，並停止接受新的實例。 了解更多

Delivery Pipeline 會透過一系列擷取輸入並執行工作（例如建置、測試及部署）的階段，來自動進行專案的持續部署。

配置 Delivery Pipeline 來自動進行應用程式的持續建置、測試及部署：

  1. 如果您要在建立工具鏈時配置此工具整合，請按一下「可配置的整合」區段中的 Delivery Pipeline。 視您使用的範本而定，可能會有不同的欄位。 請檢閱預設欄位值，並在必要時變更那些設定。

  2. 若您已擁有工具鏈並欲將此工具整合至其中，IBM Cloud 請從控制台點擊選單圖示 （漢堡圖示 ）> 平台自動化 > 工具鏈。 在「工具鏈」頁面中，點擊您要新增 Delivery Pipeline 的工具鏈。

    a. 點擊「新增工具」。

    b. 在「工具整合」區段中，按一下 Delivery Pipeline。

  3. 指定新管線的名稱。

  4. 選取要建立的管線類型：

    • 經典版：提供一個易於使用的圖形化使用者介面，用於定義在公共共享基礎架構上執行的階段與工作，並支援在私有工作節點上執行個別階段。
    • Tekton：提供一個儀表板，可用於檢視在定義的 Kubernetes 叢集上執行 Tekton 管線的輸出，並支援配置管線定義儲存庫、管線觸發程式、管線執行位置和簡單密碼。

  5. 如果您打算使用該管線來部署使用者介面，且該管線屬於「經典」管線，請勾選「在『檢視應用程式』選單中顯示應用程式」核取方塊。 管線所建立的所有應用程式都會顯示在工具鏈之「概觀」頁面的檢視應用程式清單中。

  6. 按一下建立整合，以將 Delivery Pipeline 新增至您的工具鏈。

  7. 從工具鏈中，在 Delivery Pipeline 卡上，按一下 Delivery Pipeline 來檢視及配置它。 若要瞭解如何配置管線的基本觀念，請參閱建置及部署管線。

    若您希望在將提交推送到 GitHub 或 Git 儲存庫（repo）時，讓管道能自動執行，請依照以下步驟操作：

    a. 在定義管線的各階段之前，請先為您的工具鏈設定 GitHub 或 Git Repos and Issue Tracking。 管線階段需要儲存庫的 Git URL。 每個管線階段只能參照與您的工具鏈相關聯的 GitHub 或 Git 儲存庫中的其中一個。 如需配置 GitHub 的指示，請參閱 GitHub 一節。 如需配置 Git Repos and Issue Tracking 的指示，請參閱 Git Repos and Issue Tracking 一節。

    b. 使用 Webhook。 如果沒有 Webhook，您只能手動執行管線。 若要在鏈結至 GitHub 或 GitHub Enterprise 儲存庫時使用 Webhook，您需要管理者專用權。 若要鏈結至 Git Repos and Issue Tracking 儲存庫，您需要「主要」或「擁有者」專用權。

  8. 選用項目：如果您是在 IBM Cloud Public 上使用工具鏈，並且想要 Sauce Labs 對您的應用程式執行測試，請配置 Delivery Pipeline 來新增 Sauce Labs 測試工作。 如需配置測試工作的指示，請參閱在管線中配置 Sauce Labs 測試工作一節。

在管線中配置 Sauce Labs 測試工作

您需要可運作的管線，其中包含階段可建置及部署應用程式，然後才在管線中配置 Sauce Labs 測試工作。 您也必須為工具鏈配置 Sauce Labs。 如需如何配置 Sauce Labs 的指示，請參閱 Sauce Labs 一節。

配置 Delivery Pipeline 來新增 Sauce Labs 測試工作：

  1. 如果您沒有可部署您應用程式之測試版本的階段，請建立一個。

  2. 在此階段上，於部署工作之後新增測試工作。 將這些工作放在相同的階段中，它們即可存取一組相同的環境內容。

    測驗作業
    測驗作業

  3. 配置階段。 在環境內容標籤上，建立 CF_APP_NAME 內容。

    Sauce Labs 的使用者名稱和存取金鑰，在測試工作腳本中以 SAUCE_USERNAME 和 SAUCE_ACCESS_KEY 環境變數的形式提供。 當您撰寫測試時，必須使用這些環境變數向 Sauce Labs 進行鑑別。

  4. 配置部署工作。 在部署 Script 欄位中，納入下列指令：export CF_APP_NAME="$CF_APP"。 該指令會將應用程式名稱匯出為環境內容。

  5. 配置測試工作。

    「服務實例」、「目標」、「組織」和「空間」這幾個欄位會自動填入您正在使用的 Sauce Labs 使用者名稱、區域、組織和空間。

    a. 針對測試器類型，選取 Sauce Labs。

    b. 針對服務實例，請選擇您在為工具鏈設定 Sauce Labs 時所使用的 Sauce Labs 使用者名稱。

    若要查看您在為工具鏈設定 Sauce Labs 時所使用的使用者名稱和存取金鑰，請按一下「設定」。

    c. 在測試執行指令欄位中，輸入安裝測試所需相依關係的指令，然後執行測試。 例如，針對 Node.js 應用程式，您可以輸入下列指令：

    npm install
node_modules/grunt-cli/bin/grunt test:sauce:parallel

    d. 如果要在測試工作日誌中查看測試報告，請選取啟用測試報告勾選框，然後將「測試結果檔案型樣」設定為 test/*.xml。

  6. 按一下儲存。 只要執行管線，就會執行 Sauce Labs 測試。

使用 API 來配置 Delivery Pipeline

工具 Delivery Pipeline 整合支援下列配置參數，您可在 建立、讀取及 更新工具整合時，透過工具鏈 HTTP API 與 SDK 使用這些參數。

您必須在要求內文中以 pipeline 值指定 tool_type_id 內容。

Delivery Pipeline工具整合參數
參數 用法 類型 Terraform 引數 說明
名稱 選用，可更新 字串 名稱 此工具整合的名稱。