在控制台中连接到 Event Notifications

配置 Event Notifications 以从工具链和工具集成实例发送关键事件:

1. 若您已拥有工具链并需向其中添加此工具集成，请在控制 IBM Cloud 台中点击菜单图标 （ ）> 平台自动化 > 工具链。 在“工具链”页面上，单击某个工具链以打开其“概述”页面。

   a. 单击 “添加工具”。

   b. 在“工具集成”部分中，单击 Event Notifications。

2. 在工具链中的“Event Notifications”卡片上，输入您希望在此工具集成中显示的名称。 此名称用于标识工具链中的工具集成。

3. 选择要将工具链连接到的 Event Notifications 实例。

4. 点击“创建集成”，将 Event Notifications 工具集成添加到您的工具链中。

5. 在工具链的“概述”页面上的 IBM Cloud 工具 卡上，单击 Event Notifications。

使用 API 连接到 Event Notifications

您可以使用 API 将 Event Notifications 工具集成添加到工具链。

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. 将 eventnotifications 指定为 tool_type_id。

4. 指定工具集成所需的以下 tool_parameters:

   • name: 用于标识 Event Notifications 工具集成的名称。
   • instance-crn: Event Notifications 服务实例的云资源名称 (CRN)。

5. 在目标工具链中添加工具集成。

   curl -X POST --location --header "Authorization: Bearer {iam_token}" \
     --header "Accept: application/json" \
     --header "Content-Type: application/json" \
     --data '{ "name": "{tool_name}", "tool_type_id": "eventnotifications", "parameters": { "name": {event_notifications_tool_integration_name}, "instance-crn": {event_notifications_service_crn} } }' \
     "{base_url}/toolchains/{toolchain_id}/tools"
   

   const CdToolchainV2 = require('@ibm-cloud/continuous-delivery/cd-toolchain/v2');
   const toolchainService = CdToolchainV2.newInstance();
   ...
   (async() => {
      const toolParameters = {
         "name": {event_notifications_tool_integration_name},
         "instance-crn": {event_notifications_service_crn}
      }
      const toolPrototypeModel = {
         toolchainId: {toolchain_id},
         toolTypeId: "eventnotifications",
         name: {tool_name},
         parameters: toolParameters
      };
      const response = await toolchainService.createTool(toolPrototypeModel);
   })();
   

   import (
   	   "github.com/IBM/continuous-delivery-go-sdk/cdtoolchainv2"
   )
   ...
   toolchainClientOptions := &cdtoolchainv2.CdToolchainV2Options{}
   toolchainClient, err := cdtoolchainv2.NewCdToolchainV2UsingExternalConfig(toolchainClientOptions)
   toolParameters := map[string]interface{}{
      "name": {event_notifications_tool_integration_name},
      "instance-crn": {event_notifications_service_crn},
   }
   createToolOptions := toolchainClient.NewCreateToolOptions({toolchain_id}, "eventnotifications")
   createToolOptions.SetName({tool_name})
   createToolOptions.SetParameters(toolParameters)
   tool, response, err := toolchainClient.CreateTool(createToolOptions)
   

   from ibm_continuous_delivery.cd_toolchain_v2 import CdToolchainV2
   ...
   toolchain_service = CdToolchainV2.new_instance()
   tool_parameters = {}
   tool_parameters["name"] = {event_notifications_tool_integration_name}
   tool_parameters["instance-crn"] = {event_notifications_service_crn}
   tool = toolchain_service.create_tool(
      name = {tool_name},
      toolchain_id = {toolchain_id},
      tool_type_id = "eventnotifications",
      parameters = tool_parameters
   )
   

   import com.ibm.cloud.continuous_delivery.cd_toolchain.v2.CdToolchain;
   import com.ibm.cloud.continuous_delivery.cd_toolchain.v2.model.*;
   ...
   CdToolchain toolchainService = CdToolchain.newInstance();
   HashMap<String, Object> toolParameters = new HashMap<>();
   toolParameters.put("name", {event_notifications_tool_integration_name});
   toolParameters.put("instance-crn", {event_notifications_service_crn});
   CreateToolOptions createToolOptions = new CreateToolOptions.Builder()
      .name({tool_name})
      .parameters(toolParameters)
      .toolchainId({toolchain_id})
      .toolTypeId("eventnotifications")
      .build();
   Response<ToolchainToolPost> response = toolchainService.createTool(createToolOptions).execute();
   ToolchainToolPost tool = response.getResult();
   

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

添加与 Terraform 的工具集成

您可以使用 Terraform 将 Event Notifications 工具集成添加到工具链。

IBM Cloud 使用 Terraform 添加工具集成时，需要 Terraform 提供程序版本 1.53.0 或更高版本。

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

2. 创建一个名为 main.tf 的Terraform配置文件。 在此文件中，添加配置以使用 HashiCorp 配置语言 (HCL) 创建资源实例。 有关使用此配置语言的更多信息，请参阅 Terraform 文档。

   以下示例使用 ibm_cd_toolchain_tool_pipeline 资源创建 Delivery Pipeline 工具集成，其中 toolchain_id 是表示要在其中创建工具集成的工具链的 GUID。

   data "ibm_cd_toolchain" "cd_toolchain" {
     toolchain_id = {toolchain_id}
   }
   resource "ibm_cd_toolchain_tool_eventnotifications" "en_instance" {
     toolchain_id = data.ibm_cd_toolchain.cd_toolchain.id
     parameters {
       name = "{event_notifications_tool_integration_name}"
       instance_crn = "{event_notifications_service_crn}"
     }
   }
   

   有关工具集成资源的更多信息，请参阅 IBM Cloud Terraform Registry中受支持工具集成资源的完整列表。

3. 初始化 Terraform CLI。

   terraform init
   

4. 创建 Terraform 执行计划。 此计划总结了为创建工具集成而必须运行的操作。

   terraform plan
   

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

   terraform apply
   

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