Connessione a Event Notifications nella console

Configura Event Notifications per inviare eventi critici dalle toolchain e dalle istanze di integrazione dello strumento:

1. Se si dispone di una catena di strumenti e vi si aggiunge l'integrazione di questo strumento, dalla console IBM Cloud, fare clic sull'icona Menu Automazione piattaforma > Catene di strumenti. Nella pagina Toolchains, fai clic sulla toolchain per aprirne la pagina di panoramica. In alternativa, nella pagina della panoramica della tua applicazione, nella scheda di fornitura continua, fai clic su View toolchain. Fai quindi clic su Overview.

   a. Fai clic su Add tool.

   b. Nella sezione Integrazioni strumento, fai clic su Event Notifications.

2. Digitare il nome che si desidera visualizzare per questa integrazione di strumenti nella scheda Event Notifications della propria toolchain. Questo nome viene utilizzato per identificare l'integrazione dello strumento nella tua toolchain.

3. Seleziona l'istanza Event Notifications a cui connettere la toolchain.

4. Fare clic su Crea integrazione per aggiungere l'integrazione dello strumento Event Notifications alla propria toolchain.

5. Nella pagina Panoramica della tua toolchain, nella scheda IBM Cloud tools, fai clic su Event Notifications.

Connessione a Event Notifications con l'API

Puoi aggiungere l'integrazione dello strumento Event Notifications alla tua toolchain utilizzando l'API.

1. Ottieni un token di connessione IAM. In alternativa, se stai utilizzando un SDK, ottieni una chiave API IAM e imposta le opzioni client utilizzando le variabili di ambiente.

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

2. Cerca l'ID della toolchain in cui vuoi creare la tua integrazione dello strumento.

3. Specificare eventnotifications come tool_type_id.

4. Specifica i seguenti tool_parameters richiesti dall'integrazione dello strumento:

   • name: il nome utilizzato per identificare l'integrazione dello strumento Event Notifications.
   • instance-crn: il CRN (Cloud Resource Name) dell'istanza del servizio Event Notifications.

5. Aggiungi l'integrazione dello strumento nella toolchain di destinazione.

   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 seguente tabella elenca e descrive ciascuna delle variabili utilizzate nei passi precedenti.

Aggiunta di un'integrazione dello strumento con Terraform

Puoi aggiungere l'integrazione dello strumento Event Notifications alla tua toolchain utilizzando Terraform.

IBM Cloud È richiesta la versione del provider Terraform 1.53.0 o successiva per aggiungere un'integrazione dello strumento utilizzando Terraform.

1. Per installare la CLI (command - line interface) Terraform e configurare il plug-in del fornitore IBM Cloud per Terraform, segui l'esercitazione per Introduzione a Terraform su IBM Cloud®.

2. Creare un file di configurazione di Terraform chiamato 'main.tf. In questo file, aggiungere la configurazione per creare le istanze di risorsa utilizzando l'HCL (Configuration Language) HashiCorp. Per ulteriori informazioni sull'utilizzo di questa lingua di configurazione, consultare la documentazione Terraform.

   Il seguente esempio crea un'integrazione dello strumento Delivery Pipeline utilizzando la risorsa ibm_cd_toolchain_tool_pipeline, dove toolchain_id è un GUID che rappresenta la toolchain in cui creare l'integrazione dello strumento.

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

   Per ulteriori informazioni sulle risorse di integrazione dello strumento, vedi l'elenco completo delle risorse di integrazione dello strumento supportate in IBM Cloud Terraform Registry.

3. Inizializza la CLI Terraform.

   terraform init
   

4. Creare un piano di esecuzione Terraform. Questo piano riepiloga le azioni che devono essere eseguite per creare l'integrazione dello strumento.

   terraform plan
   

5. Applicare il piano di esecuzione di Terraform. Terraform intraprende le azioni richieste per creare l'integrazione dello strumento.

   terraform apply
   

La seguente tabella elenca e descrive ciascuna delle variabili utilizzate nei passi precedenti.