配置 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. 在工具链中的 交付管道 卡上，单击交付管道以查看并配置该交付管道。 要了解配置管道的基础知识，请参阅构建和部署管道。

    如果您希望在将提交推送到 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. 配置部署作业。 在部署脚本字段中，包括以下命令：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 自变量 描述
名称 可选，可更新 字符串 名称 此工具集成的名称。