IBM Cloud Docs
配置 Delivery Pipeline

配置 Delivery Pipeline

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工具集成参数
参数 用途 Type Terraform 自变量 描述
名称 可选，可更新 字符串 名称 此工具集成的名称。