在主控台中連接至 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. 查閱您要在其中建立工具整合的工具鏈 ID。

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.1.x 1.53.0 或更高版本。

1. 若要安裝 Terraform 指令行介面 (CLI) 並配置 Terraform 的 IBM Cloud 提供者外掛程式，請遵循 在 IBM Cloud® 的指導教學。

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 登錄中受支援工具整合資源的完整清單。

3. 起始設定 Terraform CLI。

   terraform init
   

4. 建立 Terraform 執行計劃。 此計劃彙總必須執行以建立工具整合的動作。

   terraform plan
   

5. 套用 Terraform 執行計畫。 Terraform 會採取必要的動作來建立工具整合。

   terraform apply
   

下表列出並說明先前步驟中使用的每一個變數。