使用控制台从模板创建工具链

您可以使用模板作为 "创建工具链的起点，其中包括一组特定的工具集成。 根据使用的模板，您可以创建具有一组特定工具集成的工具链，或者创建可以向其中添加工具集成的空工具链。 了解有关如何使用 IBM Cloud Garage Method中的模板的更多信息。

1. 登录到 IBM Cloud。

2. 从IBM Cloud控制台，单击菜单图标>平台自动化>工具链。

3. 在“工具链”页面，单击“创建工具链”。

4. 在创建工具链页面，单击工具链模板。

5. 复查您要创建的工具链的图。 该图按生命周期阶段显示工具链中的每一个工具集成。

   有一些工具链模板具有工具集成的多个实例。 例如，IBM Cloud Public 上的“使用 Kubernetes 和 Helm开发和测试微服务”工具链模板包含四个 GitHub 实例和四个 Delivery Pipeline实例。

   以下图像中的图是示例。 创建工具链时，该图显示属于工具链的每一个工具集成。

   {: caption="*

6. 复查工具链设置的缺省信息：

   • 工具链的名称在 IBM Cloud 中起到标识符的作用。 如果要使用其他名称，请更改工具链的名称。
   • 要在其中创建工具链的区域。 如果要使用其他区域，请从可用区域列表中选择该区域。
   • 创建工具链的资源组。 如果要使用不同的资源组，请从可用资源组列表中选择。
   • 源存储库的提供者，例如 GitHub、GitLab 或 Bitbucket。 如果要使用其他源提供者，请从可用存储库列表中进行选择。

7. 在“工具集成”部分中，选择要为工具链配置的每一个工具集成。 有些工具集成无需进行配置。 有关配置工具集成的更多信息，请参阅配置工具集成。

   组成工具链的许多工具集成需要私钥才能向 Continuous Delivery 服务进行认证。

   私钥是可以密码，认证令牌，API 密钥或证书形式提供的凭证。 例如，将 Delivery Pipeline 工具集成添加到工具链时，必须以 API 密钥的形式提供私钥。

   a. 在“工具集成”部分中，单击 Delivery Pipeline。

   b. 单击 新建 以创建 IBM Cloud® API 密钥。

   c. 单击 确定 以应用新的 API 密钥。

   每个用户最多可以有 20 个 API 密钥。

   d. 单击 确定 以创建 API 密钥而不保存密钥的安全副本。

   e. 要安全地保存 API 密钥，以便您可以在其他工具链工作流程中再次使用该 API 密钥:

   • 选中 将此密钥保存在密钥库中以供复用 复选框以与 Key Protect 或 Secrets Manager 密钥库集成。
   • 如果您没有 Key Protect 或 Secrets Manager的现有实例，请指定该实例的名称和私钥。
   • 单击 确定 以应用新的 API 密钥。

   f. 要验证是否已成功创建 Key Protect 或 Secrets Manager 实例，请转至 IBM Cloud® 资源列表 并展开 服务 折叠标记。 要查看 API 密钥，请从菜单栏中单击 管理> 访问权 (IAM)，然后选择 IBM Cloud® API 密钥。

   （例如， 您创建并复制到密钥项目的 API 密钥现在可在“创建工具链”页面上使用。 需要私钥的任何工具集成都会显示一个密钥图标。 单击密钥图标以打开“私钥选取器”对话框，以从一个或多个 Key Protect 或 Secrets Manager 实例检索私钥。

8. 单击创建。 此时将自动运行数个步骤，以设置工具链。 根据您选择的工具链模板，设置的工具集成有所不同。 例如，在 IBM Cloud Public 上创建“使用 Kubernetes 和 Helm”工具链开发和测试微服务时，将运行以下步骤:

   • 将创建工具链。
   • 如果已配置 Delivery Pipeline，那么会创建并触发管道。
   • 如果配置了Event Notifications，工具链将被设置为向您指定的Event Notifications服务发送事件通知。
   • 如果已配置 Sauce Labs，那么会设置工具链以向管道添加 Sauce Labs 测试作业。
   • 如果已配置 PagerDuty，那么会设置工具链，以向指定的 PagerDuty 服务发送警报通知。
   • 如果已配置 Slack，那么会设置工具链，以向指定的 Slack 通道发送有关部署状态的通知。
   • 如果已配置源代码工具集成（如 GitHub），那么样本 GitHub 存储库会克隆到 GitHub 帐户。

   You can now distribute event notifications by using the Event Notifications tool integration. IBM Cloud Event Notifications is the preferred method for distributing notifications to PagerDuty and other communication channels such as Slack, email, SMS, push notifications, webhook, Microsoft® Teams, ServiceNow, and IBM Cloud Functions. 有关使用 Event Notifications的更多信息，请参阅 为工具链启用事件通知。

使用控制台从应用程序创建工具链

可以通过应用程序来创建工具链。 工具链可以支持持续开发、部署、监视等操作，并且与应用程序相关联。 每个应用程序可以与一个工具链相关联。 当您将更改推送到工具链的 GitHub 存储库时，管道会自动构建和部署应用程序。

1. 如果您使用IBM CloudPublic 来创建应用程序，它将被配置为从一个新的GitHubrepo 持续交付，该 repo 中填充了应用程序的启动代码。

2. 在工具链配置页面上，复查您即将创建的工具链的图。 该图按生命周期阶段显示工具链中的每一个工具集成。

3. 复查工具链设置的缺省信息。 工具链的名称在 IBM Cloud 中起到标识符的作用。 如果要使用其他名称，请更改工具链的名称。

4. 在“工具集成”部分中，选择要为工具链配置的每一个工具集成。 有些工具集成无需进行配置。 有关配置工具集成的更多信息，请参阅配置工具集成。

5. 单击创建。 此时将自动运行数个步骤，以设置工具链。 例如，当您在 IBM Cloud Public 上通过应用程序创建工具链时，会运行以下步骤：

   • 将创建工具链。
   • 如果已配置 Delivery Pipeline，那么会创建并触发管道。
   • 如果已配置 GitHub，那么样本 GitHub 存储库会克隆到 GitHub 帐户。

使用应用程序接口创建工具链

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. 查找要在其中创建工具链的资源组的标识。

3. 选择要在其中创建工具链的区域。

4. 创建工具链实例

   curl -X POST \
     "{base_url}/toolchains" \
     -H 'Authorization: Bearer {token}' \
     -H 'Content-Type: application/json' \
       -d '{
       "name": "{toolchain_name}",
       "resource_group_id": "{resource_group_id}"
     }'
   

   const CdToolchainV2 = require('@ibm-cloud/continuous-delivery/cd-toolchain/v2');
   const toolchainService = CdToolchainV2.newInstance();
   ...
   (async() => {
      const toolchainPrototypeModel = {
         description: {toolchain_description},
         name: {toolchain_name},
         resourceGroupId: {resource_group_id}
      };
      const response = await toolchainService.createToolchain(toolchainPrototypeModel);
   })();
   

   import (
   	   "github.com/IBM/continuous-delivery-go-sdk/cdtoolchainv2"
   )
   ...
   toolchainClientOptions := &cdtoolchainv2.CdToolchainV2Options{}
   toolchainClient, err := cdtoolchainv2.NewCdToolchainV2UsingExternalConfig(toolchainClientOptions)
   createToolchainOptions := toolchainClient.NewCreateToolchainOptions({toolchain_name}, {resource_group_id})
   createToolchainOptions.SetDescription({toolchain_description})
   toolchain, response, err := toolchainClient.CreateToolchain(createToolchainOptions)
   

   from ibm_continuous_delivery.cd_toolchain_v2 import CdToolchainV2
   ...
   toolchain_service = CdToolchainV2.new_instance()
   toolchain = toolchain_service.create_toolchain(
      description = {toolchain_description},
      name = {toolchain_name},
      resource_group_id = {resource_group_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();
   CreateToolchainOptions createToolchainOptions = new CreateToolchainOptions.Builder()
      .description({toolchain_description})
      .name({toolchain_name})
      .resourceGroupId({resource_group_id})
      .build();
   Response<ToolchainPost> response = toolchainService.createToolchain(createToolchainOptions).execute();
   ToolchainPost toolchain = response.getResult();
   

下表列出并描述了先前步骤中使用的每个变量。

有关使用 API 创建工具链的更多信息，请参阅 IBM Cloud API 文档中的 创建工具链。

使用 Terraform 创建工具链

1. 要安装 Terraform CLI 并为 Terraform 配置 IBM Cloud 提供程序插件，请遵循 IBM Cloud® 上的 Terraform 入门 的教程。

2. 创建名为 "main.tf 的 Terraform 配置文件。 在此文件中，添加配置以使用 HashiCorp 配置语言创建工具链。 有关使用此配置语言的更多信息，请参阅 Terraform 文档。

   以下示例使用 ibm_cd_toolchain 资源创建工具链。

   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
   }
   

   有关 ibm_cd_toolchain 的更多信息，请参阅 Terraform Registry 文档中的参数参考详细信息。

3. 初始化 Terraform CLI。

   terraform init
   

4. 创建 Terraform 执行计划。 此计划汇总了为创建工具链而必须运行的所有操作。

   terraform plan
   

5. 应用 Terraform 执行计划。 Terraform 将执行所有必需的操作来创建工具链。

   terraform apply