Conectando-se ao Event Notifications no console

Configure Event Notifications para enviar eventos críticos de cadeias de ferramentas e instâncias de integração de ferramentas:

1. Se você já possui uma cadeia de ferramentas e deseja adicionar essa integração de ferramenta a ela, no console do IBM Cloud, clique no ícone de menu ( ) > Automação de Plataforma > Cadeias de Ferramentas. Na página Cadeias de ferramentas, clique na cadeia de ferramentas para abrir a sua página de Visão geral.

   a. Clique em Incluir ferramenta.

   b. Na seção Integrações de ferramentas, clique em Event Notifications.

2. Digite o nome que você deseja exibir para esta integração de ferramentas no cartão do Event Notifications em sua cadeia de ferramentas. Este nome é usado para identificar a integração da ferramentas em sua cadeia de ferramentas.

3. Selecione a instância do Event Notifications à qual conectar a cadeia de ferramentas.

4. Clique em “Criar integração” para adicionar a integração da ferramenta Event Notifications à sua cadeia de ferramentas.

5. Na página “Visão geral” da sua cadeia de ferramentas, no cartão “ IBM Cloud ferramentas ”, clique em “ Event Notifications ”.

Conectando-se ao Event Notifications com a API

É possível incluir a integração da ferramenta Event Notifications em sua cadeia de ferramentas usando a API.

1. Obtenha um token de acesso do IAM Como alternativa, se você estiver usando um SDK, obtenha uma chave API do IAM e configure as opções do cliente usando variáveis de ambiente.

   export CD_TOOLCHAIN_AUTH_TYPE=iam && \
   export CD_TOOLCHAIN_APIKEY={iam_api_key} && \
   export CD_TOOLCHAIN_URL={base_url}
   

2. Consulte o ID da cadeia de ferramentas na qual você deseja criar sua integração de ferramenta.

3. Especifique eventnotifications como tool_type_id.

4. Especifique o tool_parameters a seguir que é necessário pela integração de ferramenta:

   • name: o nome usado para identificar a integração da ferramenta Event Notifications.
   • instance-crn: o Cloud Resource Name (CRN) da instância de serviço Event Notifications.

5. Adicione a integração da ferramenta à cadeia de ferramentas pretendida.

   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();
   

A tabela a seguir lista e descreve cada uma das variáveis usadas nas etapas anteriores.

Incluindo uma integração de ferramenta com o Terraform

É possível incluir a integração da ferramenta Event Notifications em sua cadeia de ferramentas usando o Terraform.

IBM Cloud É necessária a versão do provedor 1.53.0 Terraform ou posterior para adicionar uma integração de ferramenta usando o Terraform.

1. Para instalar a interface de linha de comando (CLI) do Terraform e configurar o plug-in do provedor IBM Cloud para o Terraform, siga o tutorial disponível em Introdução ao Terraform em IBM Cloud®.

2. Crie um arquivo de configuração do Terraform que seja denominado main.tf. Neste arquivo, adicione a configuração para criar instâncias de recursos usando a Linguagem de Configuração do HashiCorp (HCL). Para obter mais informações sobre como usar essa linguagem de configuração, consulte a Documentação do Terraform

   O exemplo a seguir cria uma integração de ferramenta Delivery Pipeline usando o recurso ibm_cd_toolchain_tool_pipeline, em que toolchain_id é um GUID que representa a cadeia de ferramentas na qual criar a integração de ferramenta.

   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}"
     }
   }
   

   Para obter mais informações sobre recursos de integração de ferramentas, consulte a lista completa de recursos de integração de ferramentas suportados no IBM Cloud Terraform Registry.

3. Inicialize a CLI do Terraform.

   terraform init
   

4. Crie um plano de execução do Terraform. Este plano resume as ações que devem ser executadas para criar a integração de ferramenta

   terraform plan
   

5. Aplique o plano de execução do Terraform. O Terraform toma as ações necessárias para criar a integração de ferramenta

   terraform apply
   

A tabela a seguir lista e descreve cada uma das variáveis usadas nas etapas anteriores.