콘솔에서 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 제공자 버전 1.53.0 이상이어야만 Terraform을 사용하여 도구 통합을 추가할 수 있습니다.

1. Terraform 명령줄 인터페이스(CLI)를 설치하고 Terraform용 IBM Cloud 프로바이더 플러그인을 구성하려면, IBM Cloud® 에 있는 ‘Terraform 시작하기’ 튜토리얼을 따르십시오.

2. 이름이 main.tf인 Terraform 구성 파일을 작성하십시오. 이 파일에서 HCL( HashiCorp Configuration Language)을 사용하여 리소스 인스턴스를 생성하는 구성을 추가하십시오. 이 구성 언어 사용에 대한 자세한 정보는 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
   

다음 표에서는 이전 단계에서 사용된 각 변수를 나열하고 설명합니다.