Intégrer DevOps Insights en utilisant la console

Vous pouvez ajouter DevOps Insights à n'importe quelle chaîne d'outils en sélectionnant cette dernière dans le catalogue des intégrations d'outils.

1. Dans la console IBM Cloud, cliquez sur l' Menu > Automatisation de la plateforme > Chaînes d'outils.
2. Sélectionnez votre chaîne d'outils.
3. Cliquez sur Ajouter un outil.
4. Sélectionnez la vignette DevOps Insights.
5. Cliquez sur Créer une intégration.
6. Sur la page Présentation de la chaîne d'outils, sur la carte Outils IBM Cloud, cliquez sur DevOps Insights pour afficher votre tableau de bord DevOps Insights.

Intégrer DevOps Insights à l'API

1. Obtenir un jeton de porteur IAM. Si vous utilisez un SDK, vous pouvez également obtenir une clé API IAM et définir les options du client à l'aide de variables d'environnement.

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

2. Déterminez la région et l'ID de la chaîne d'outils à laquelle vous souhaitez ajouter l'intégration d'outils DevOps Insights

3. Ajoutez l'intégration des outils DevOps Insights à la chaîne d'outils.

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

Le tableau suivant énumère et décrit chacune des variables utilisées dans les étapes précédentes.

Pour plus d'informations sur l'intégration de l'outil DevOps Insights, voir Ajouter DevOps Insights.

Intégrer DevOps Insights avec Terraform

1. Pour installer l'interface de ligne de commande de Terraform et configurer le plug-in IBM Cloud Provider pour Terraform, suivez le tutoriel d'initiation à Terraform sur IBM Cloud.

2. Localisez le fichier Terraform (par exemple, main.tf) qui contient le bloc de ressources pour la chaîne d'outils à laquelle vous souhaitez ajouter l'intégration d'outils DevOps Insights Dans ce fichier, ajoutez la configuration pour créer l'intégration de l'outil.

   L'exemple suivant crée la chaîne d'outils si elle n'existe pas, puis ajoute l'intégration de l'outil DevOps Insights en utilisant la ressource 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
   }
   

   Pour plus d'informations sur ibm_cd_toolchain_tool_devopsinsights, voir les détails de la référence des arguments dans la documentation du registre Terraform.

3. Initialisez l'interface de ligne de commande de Terraform.

   terraform init
   

4. Créez un plan d'exécution Terraform. Ce plan résume toutes les actions qui doivent être exécutées pour ajouter l'intégration de l'outil DevOps Insights à la chaîne d'outils.

   terraform plan
   

5. Appliquer le plan d'exécution Terraform. Terraform prend toutes les mesures nécessaires pour ajouter l'intégration de l'outil DevOps Insights à la chaîne d'outils.

   terraform apply
   

Pour plus d'informations sur l'utilisation de Terraform avec Continuous Delivery, voir Configuration de Terraform pour Continuous Delivery.