Aggiunta di DevOps Insights alla tua toolchain

Integrazione di DevOps Insights tramite console

Puoi aggiungere DevOps Insights a qualsiasi toolchain selezionandolo dal catalogo di integrazioni degli strumenti.

1. Dalla console IBM Cloud, fare clic sull'icona Menu Automazione piattaforma > Toolchains.
2. Seleziona la tua toolchain.
3. Fai clic su Add tool.
4. Seleziona il tile DevOps Insights.
5. Fai clic su Crea integrazione.
6. Nella pagina Panoramica della Toolchain, sulla scheda degli strumentiIBM Cloud, fare clic su DevOps Insights per visualizzare il dashboard DevOps Insights.

Integrazione di DevOps Insights con l'API

1. Ottenere un token portatore IAM. In alternativa, se si utilizza un SDK, ottenere una chiave API IAM e impostare le opzioni del client utilizzando le variabili d'ambiente.

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

2. Determinare la regione e l'ID della catena di strumenti a cui si vuole aggiungere l'integrazione dello strumento DevOps Insights.

3. Aggiungere l'integrazione dello strumento DevOps Insights alla catena di strumenti.

   curl -X POST \
     {base_url}/toolchains/{toolchain_id}/tools \
     -H 'Authorization: Bearer {token}' \
     -H 'Accept: application/json` \
     -H 'Content-Type: application/json' \
       -d '{
       "tool_type_id": "draservicebroker",
       "name": "{tool_integration_name}"
     }'
   

   const CdToolchainV2 = require('@ibm-cloud/continuous-delivery/cd-toolchain/v2');
   ...
   (async () => {
      const toolchainService = CdToolchainV2.newInstance();
      const draPrototypeModel = {
         toolchainId: {toolchain_id},
         toolTypeId: 'draservicebroker',
         name: {tool_integration_name}
      };
      const draTool = await toolchainService.createTool(draPrototypeModel);
   })();
   

   import (
   	   "github.com/IBM/continuous-delivery-go-sdk/cdtoolchainv2"
   )
   ...
   toolchainClientOptions := &cdtoolchainv2.CdToolchainV2Options{}
   toolchainClient, err := cdtoolchainv2.NewCdToolchainV2UsingExternalConfig(toolchainClientOptions)
   createDraToolOptions := toolchainClient.NewCreateToolOptions({toolchain_id}, "draservicebroker")
   createDraToolOptions.SetName({tool_integration_name})
   draTool, response, err := toolchainClient.CreateTool(createDraToolOptions)
   

   from ibm_continuous_delivery.cd_toolchain_v2 import CdToolchainV2
   ...
   toolchain_service = CdToolchainV2.new_instance()
   dra_tool = toolchain_service.create_tool(
      name = {tool_integration_name},
      toolchain_id = {toolchain_id},
      tool_type_id = "draservicebroker"
   )
   

   import com.ibm.cloud.continuous_delivery.cd_toolchain.v2.CdToolchain;
   import com.ibm.cloud.continuous_delivery.cd_toolchain.v2.model.*;
   ...
   CdToolchain toolchainService = CdToolchain.newInstance();
   CreateToolOptions createDraToolOptions = new CreateToolOptions.Builder()
      .name({tool_integration_name})
      .toolchainId({toolchain_id})
      .toolTypeId("draservicebroker")
      .build();
   Response<ToolchainToolPost> response = toolchainService.createTool(createDraToolOptions).execute();
   ToolchainToolPost draTool = response.getResult();
   

La tabella seguente elenca e descrive le variabili utilizzate nei passaggi precedenti.

Per ulteriori informazioni sull'integrazione dello strumento DevOps Insights, vedere Aggiunta di DevOps Insights.

Integrazione di DevOps Insights con Terraform

1. Per installare la CLI di Terraform e configurare il plug-in del provider IBM Cloud per Terraform, seguire il tutorial per Iniziare con Terraform su IBM Cloud.

2. Individuare il file Terraform (ad esempio, main.tf) che contiene il blocco di risorse per la toolchain a cui si vuole aggiungere l'integrazione dello strumento DevOps Insights. In questo file, aggiungere la configurazione per creare l'integrazione dello strumento.

   L'esempio seguente crea la catena di strumenti se non esiste, quindi aggiunge l'integrazione dello strumento DevOps Insights usando la risorsa ibm_cd_toolchain_tool_devopsinsights

   data "ibm_resource_group" "group" {
     name = "default"
   }
   
   resource "ibm_cd_toolchain" "cd_toolchain" {
     name              = "my toolchain"
     resource_group_id = data.ibm_resource_group.group.id
   }
   
   resource "ibm_cd_toolchain_tool_devopsinsights" "cd_toolchain_tool_insights" {
     toolchain_id = ibm_cd_toolchain.cd_toolchain.id
   }
   

   Per ulteriori informazioni su ibm_cd_toolchain_tool_devopsinsights, vedere i dettagli di riferimento degli argomenti nella Documentazione del Registro di Terraform.

3. Inizializzare la CLI di Terraform.

   terraform init
   

4. Creare un piano di esecuzione di Terraform. Questo piano riassume tutte le azioni da eseguire per aggiungere l'integrazione dello strumento DevOps Insights alla catena di strumenti.

   terraform plan
   

5. Applicare il piano di esecuzione di Terraform. Terraform esegue tutte le azioni necessarie per aggiungere l'integrazione dello strumento DevOps Insights alla catena di strumenti.

   terraform apply
   

Per ulteriori informazioni sull'uso di Terraform con Continuous Delivery, vedere Impostazione di Terraform per Continuous Delivery.