Connessione a Event Notifications nella console

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

1. Se disponi già di una toolchain e desideri integrarvi questo strumento, dalla console IBM Cloud, fai clic sull'icona del menu ( ) > Automazione della piattaforma > Toolchain. Nella pagina Toolchains, fai clic sulla toolchain per aprirne la pagina di panoramica.

   a. Fai clic su Add tool.

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

2. Digita il nome che desideri visualizzare per questa integrazione dello strumento nella scheda " Event Notifications " della tua catena di strumenti. 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. Fai clic su " Crea integrazione " per aggiungere l'integrazione con lo strumento Event Notifications alla tua catena di strumenti.

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 Per aggiungere un'integrazione di strumenti utilizzando Terraform è necessaria la versione Terraform 1.53.0 provider o successive.

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. Crea un file di configurazione Terraform denominato “ 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.