使用工具鏈

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

開放式工具鏈可在 IBM Cloud® 上找到。 您可以在日常的開發、部署及營運工作中,使用工具鏈來提高生產力。 設定工具鏈之後,即可新增、刪除或配置工具整合,以及管理對工具鏈的存取權。 如需使用工具整合的相關資訊,請參閱 使用工具整合

管理對工具鏈的存取權

您可以使用 Identity and Access Management (IAM) 服務來管理使用者對資源群組中工具鏈的存取權。 如需使用 IAM 管理存取控制的相關資訊,請參閱管理使用者對資源群組中工具鏈的存取權

具有工具鏈存取權的使用者可能會被計算為 IBM Cloud® Continuous Delivery 服務的授權使用者。 如需如何計算授權使用者數目的相關資訊,請參閱方案限制與使用

組織工具鏈

您可以將標籤新增至工具鏈,以便加以組織,並且之後可以輕鬆地找到工具鏈。 標籤是您指派給工具鏈的標籤,以方便在工具鏈清單中過濾工具鏈。

  1. 在IBM Cloud控制台中,點選選單圖示漢堡圖示>平台自動化>工具鏈
  2. 在「工具鏈」頁面中,找到您要為其新增標籤的工具鏈,然後點擊 「新增標籤」
  3. 輸入您要新增至工具鏈之標籤的名稱。 您可以新增多個標籤,並以逗點區隔。
  4. 按一下儲存

如需標籤的相關資訊,請參閱使用標籤

檢視工具鏈與應用程式、叢集和服務的連線

您可以檢視您的工具鏈與 Kubernetes 叢集及服務之間的連線。

  1. 在IBM Cloud控制台中,點選選單圖示漢堡圖示>平台自動化>工具鏈
  2. 在「工具鏈」頁面中,點選某個工具鏈以開啟其「概覽」頁面。 或者,在您的應用程式「應用程式詳細資訊」頁面上,點擊工具鏈名稱。
  3. 選取連線標籤,然後選取要檢視的應用程式、叢集或服務。

刪除工具鏈

您可以刪除工具鏈。 當您刪除工具鏈時,也會刪除屬於該工具鏈的所有工具整合。 此刪除操作無法撤銷。

刪除 Delivery Pipeline 工具整合時,也會刪除相關的 Delivery Pipeline。

當您刪除 GitHub 或 Git Repos and Issue Tracking 上的工具整合時,相關的儲存庫並不會從 GitHub 或 Git Repos and Issue Tracking 中被刪除。 您必須手動移除儲存庫。

使用主控台刪除工具鏈

  1. 在IBM Cloud控制台中,點選選單圖示漢堡圖示>平台自動化>工具鏈
  2. 在「工具鏈」頁面中,點選某個工具鏈以開啟其「概覽」頁面。 或者,在您的應用程式「應用程式詳細資訊」頁面上,點擊工具鏈名稱。
  3. 點擊「動作」選單,然後選擇「刪除」。 刪除工具鏈會移除其所有工具整合,這樣可能會刪除那些整合所管理的資源。
  4. 鍵入工具鏈名稱,然後按一下刪除,來確認刪除作業。

從 CLI 刪除工具鏈 (測試版)

  1. 使用 IBM Cloud CLI 登入 IBM Cloud。

    ibmcloud login
    

    如果登入失敗,請執行 ibmcloud login --sso 指令再試一次。 當您使用聯合 ID 登入時,需要 --sso 參數。 如果您使用此選項,請跳至 CLI 輸出中列出的鏈結,以產生一次性密碼。

  2. 選用。 列出目標帳戶、地區及資源群組中的所有工具鏈,以識別您要刪除的實例。

    ibmcloud dev toolchains
    
  3. 執行 ibmcloud dev toolchain-delete 指令來刪除工具鏈。

    ibmcloud dev toolchain-delete TOOLCHAIN-NAME
    

下表列出並說明先前步驟中使用的每一個變數。

用於從 CLI 中刪除工具鏈的變數
變數 說明
TOOLCHAIN_NAME 您要刪除的工具鏈名稱。

使用 API 刪除工具鏈

  1. 取得 IAM 持有人記號。 或者,如果您使用 SDK,請 取得 IAM API 金鑰,並使用環境變數來設定用戶端選項。

    export CD_TOOLCHAIN_AUTH_TYPE=iam && \
    export CD_TOOLCHAIN_APIKEY={iam_api_key} && \
    export CD_TOOLCHAIN_URL={base_url}
    
  2. 刪除您要移除的工具鏈。

    curl -X DELETE \
      "{base_url}/toolchains/{toolchain_id}" \
      -H 'Authorization: Bearer {token}'
    
    const CdToolchainV2 = require('@ibm-cloud/continuous-delivery/cd-toolchain/v2');
    const toolchainService = CdToolchainV2.newInstance();
    ...
    (async() => {
       const response = await toolchainService.deleteToolchain({
          toolchainId: {toolchain_id}
       });
    })();
    
    import (
    	   "github.com/IBM/continuous-delivery-go-sdk/cdtoolchainv2"
    )
    ...
    toolchainClientOptions := &cdtoolchainv2.CdToolchainV2Options{}
    toolchainClient, err := cdtoolchainv2.NewCdToolchainV2UsingExternalConfig(toolchainClientOptions)
    deleteToolchainOptions := toolchainClient.NewDeleteToolchainOptions({toolchain_id})
    response, err := toolchainClient.DeleteToolchain(deleteToolchainOptions)
    
    from ibm_continuous_delivery.cd_toolchain_v2 import CdToolchainV2
    ...
    toolchain_service = CdToolchainV2.new_instance()
    response = toolchain_service.delete_toolchain(
       toolchain_id = toolchain_id
    )
    
    import com.ibm.cloud.continuous_delivery.cd_toolchain.v2.CdToolchain;
    import com.ibm.cloud.continuous_delivery.cd_toolchain.v2.model.*;
    ...
    CdToolchain toolchainService = CdToolchain.newInstance();
    DeleteToolchainOptions deleteToolchainOptions = new DeleteToolchainOptions.Builder()
       .toolchainId({toolchain_id})
       .build();
    Response<Void> response = toolchainService.deleteToolchain(deleteToolchainOptions).execute();
    

下表列出並說明先前步驟中使用的每一個變數。

用於使用 API 刪除工具鏈的變數
變數 說明
{base_url} 工具鏈 API 端點 URL,例如 https://api.us-south.devops.cloud.ibm.com/toolchain/v2。 如需更多關於此端點 URL 的資訊,包括值清單,請參閱 端點 URL
{iam_api_key} 您的 IAM API 金鑰。
{token} 一個有效的 IAM 承載者憑證。
{toolchain_id} 您要刪除的工具鏈的 ID。

使用 Terraform 刪除工具鏈

  1. 找出包含現有工具鏈之 resource 區塊的 Terraform 檔案 (例如,main.tf)。 如需搭配使用 Terraform 與工具鏈的相關資訊,請參閱 使用 Terraform 建立工具鏈

    下列範例中的 resource 說明現有工具鏈。

    data "ibm_resource_group" "group" {
      name = "default"
    }
    resource "ibm_cd_toolchain" "cd_toolchain" {
      name              = "my toolchain"
      resource_group_id = data.ibm_resource_group.group.id
    }
    
  2. 從 Terraform 檔案中移除 resource 區塊。

  3. 起始設定 Terraform CLI。

    terraform init
    
  4. 建立 Terraform 執行計劃。 此計劃彙總必須執行以刪除工具鏈的所有動作。

    terraform plan
    
  5. 套用 Terraform 執行計畫。 Terraform 會採取所有必要的動作來刪除工具鏈。

    terraform apply
    

管理不同地區的替代工具鏈

您可以使用 Terraform 配置語言定義工具鏈,然後在兩個區域中套用和維護工具鏈定義:具有活動管道的主要區域和具有空閒管道的備用區域。 如果您使用Git Repos and Issue Tracking,您也可以 將Git儲存庫從主要區域鏡像 到備用區域。 維護主要和備用工具鏈以及Git儲存庫可提供更快的故障轉移和冗餘。 如果主要區域出現問題,它還能確保平穩運作。 透過在 Terraform 中編碼工具鏈,您可以更新工具鏈並將變更套用到兩個區域。

有關使用 Terraform 的更多信息,請參閱 為Continuous Delivery設定 Terraform