コンソールから Event Notifications に接続する

ツールチェーンおよびツール統合インスタンスからクリティカル・イベントを送信するように Event Notifications を構成します。

1. ツールチェーンをお持ちで、そこにこのツールの統合を追加する場合は、 IBM Cloud コンソールから、 メニュー アイコン（ ） > [Platform Automation ] > [Toolchains ] の順にクリックしてください。 「ツールチェーン」ページで、ツールチェーンをクリックしてその「概要」ページを開きます。

   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. tool_type_id として eventnotifications を指定します。

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 プロバイダーのバージョン 1.53.0 以降が必要です。これにより、Terraform を使用してツール統合を追加できます。

1. Terraformのコマンドラインインターフェース（CLI）をインストールし、Terraform用の IBM Cloud プロバイダープラグインを設定するには、 Terraform の使い始め 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
   

以下の表では、前のステップで使用された各変数をリストして説明します。