Conexión a Event Notifications en la consola

Configure Event Notifications para enviar sucesos críticos desde cadenas de herramientas e instancias de integración de herramientas:

1. Si dispone de una cadena de herramientas y desea añadirle esta integración, desde la consola de IBM Cloud, haga clic en el icono de menú ( ) > Automatización de la plataforma > Cadenas de herramientas. En la página Cadenas de herramientas, pulse la cadena de herramientas para abrir su página Visión general.

   a. Pulse Añadir herramienta.

   b. En la sección Integraciones de herramientas, pulse Event Notifications.

2. Escriba el nombre que desea visualizar para esta integración de herramientas en la tarjeta Event Notifications de la cadena de herramientas. Este nombre se utiliza para identificar la integración de herramientas en la cadena de herramientas.

3. Seleccione la instancia de Event Notifications a la que conectar la cadena de herramientas.

4. Haz clic en Crear integración para añadir la integración de la herramienta Event Notifications a tu cadena de herramientas.

5. En la página de Resumen de su Toolchain, en la tarjeta de herramientas IBM Cloud, haga clic en Event Notifications.

Conectar a Event Notifications con la API

Puede añadir la integración de herramientas de Event Notifications a la cadena de herramientas utilizando la API.

1. Obtener una señal portadora de IAM. De forma alternativa, si utiliza un SDK, obtenga una clave de API de IAM y establezca las opciones de cliente utilizando variables de entorno.

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

2. Busque el ID de la cadena de herramientas en la que desea crear la integración de herramientas.

3. Especifique eventnotifications como tool_type_id.

4. Especifique los siguientes tool_parameters que son necesarios para la integración de herramientas:

   • name: el nombre que se utiliza para identificar la integración de herramientas de Event Notifications.
   • instance-crn: el nombre de recurso de nube (CRN) de la instancia de servicio de Event Notifications.

5. Añadir la integración de la herramienta dentro de la cadena de herramientas prevista.

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

La tabla siguiente lista y describe cada una de las variables que se utilizan en los pasos anteriores.

Adición de una integración de herramientas con Terraform

Puede añadir la integración de herramientas de Event Notifications a la cadena de herramientas utilizando Terraform.

IBM Cloud Se requiere la versión Terraform 1.53.0 provider o posterior para añadir una integración de herramientas mediante Terraform.

1. Para instalar la interfaz comando línea de comandos (CLI) de Terraform y configurar el complemento del proveedor de IBM Cloud para Terraform, sigue el tutorial Primeros pasos con Terraform en IBM Cloud®.

2. Cree un archivo de configuración de Terraform denominado main.tf. En este archivo, añade la configuración para crear instancias de recursos utilizando el lenguaje de configuración de HashiCorp (HCL). Para obtener más información sobre cómo utilizar este idioma de configuración, consulte la documentación de Terraform.

   El ejemplo siguiente crea una integración de herramientas de Delivery Pipeline utilizando el recurso ibm_cd_toolchain_tool_pipeline, donde toolchain_id es un GUID que representa la cadena de herramientas en la que crear la integración de herramientas.

   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 obtener más información sobre los recursos de integración de herramientas, consulte la lista completa de recursos de integración de herramientas soportados en IBM Cloud Terraform Registry.

3. Inicialice la CLI de Terraform.

   terraform init
   

4. Cree un plan de ejecución de Terraform. Este plan resume las acciones que deben ejecutarse para crear la integración de herramientas.

   terraform plan
   

5. Aplica el plan de ejecución de Terraform. Terraform realiza las acciones necesarias para crear la integración de herramientas.

   terraform apply
   

La tabla siguiente lista y describe cada una de las variables que se utilizan en los pasos anteriores.