使用工具链

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 中删除工具链 (Beta)

  1. 使用 IBM Cloud CLI 登录到 IBM Cloud。

    ibmcloud login
    

    如果登录失败,请运行 ibmcloud login --sso 命令重试。 使用联合标识登录时需要 --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} 工具链应用程序接口端点 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