Ajout d'une intégration d'outils à l'aide de la console

Vous pouvez ajouter des intégrations d'outils à votre chaîne d'outils à l'aide de la console.

1. Dans la console IBM Cloud, cliquez sur l' Menu > Automatisation de la plateforme > Chaînes d'outils.
2. Sur la page Chaînes d'outils, cliquez sur une chaîne d'outils afin d'ouvrir sa page Vue d'ensemble. Sinon, sur la page Détails de l'application de votre application, cliquez sur le nom de la chaîne d'outils.
3. Pour afficher la liste des intégrations d'outils à ajouter, cliquez sur Ajouter.
4. Cliquez sur une intégration d'outils à ajouter.
5. Entrez les informations requises pour configurer l'intégration d'outils.
6. Cliquez sur Créer une intégration pour ajouter l'intégration d'outils à votre chaîne d'outils.

Ajout d'une intégration d'outils à l'API

Vous pouvez ajouter des intégrations d'outils à votre chaîne d'outils à l'aide de l'API.

1. Obtenez un jeton bearer IAM. Sinon, si vous utilisez un SDK, obtenez une clé d'API IAM et définissez les options 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. Recherchez l'ID de la chaîne d'outils dans laquelle vous souhaitez créer votre intégration d'outils.

3. Recherchez la tool_type_id valeur qui correspond à l'intégration d'outils que vous souhaitez ajouter.

4. Ajouter l'intégration de l'outil au sein de la chaîne d'outils ciblée.

   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": "{tool_type_id}", "parameters": {tool_parameters} }' \
     "{base_url}/toolchains/{toolchain_id}/tools"
   

   const CdToolchainV2 = require('@ibm-cloud/continuous-delivery/cd-toolchain/v2');
   const toolchainService = CdToolchainV2.newInstance();
   ...
   (async() => {
      const toolPrototypeModel = {
         toolchainId: {toolchain_id},
         toolTypeId: {tool_type_id},
         name: {tool_name},
         parameters: {tool_parameters}
      };
      const response = await toolchainService.createTool(toolPrototypeModel);
   })();
   

   import (
   	   "github.com/IBM/continuous-delivery-go-sdk/cdtoolchainv2"
   )
   ...
   toolchainClientOptions := &cdtoolchainv2.CdToolchainV2Options{}
   toolchainClient, err := cdtoolchainv2.NewCdToolchainV2UsingExternalConfig(toolchainClientOptions)
   createToolOptions := toolchainClient.NewCreateToolOptions({toolchain_id}, {tool_type_id})
   createToolOptions.SetName({tool_name})
   createToolOptions.SetParameters({tool_parameters})
   tool, response, err := toolchainClient.CreateTool(createToolOptions)
   

   from ibm_continuous_delivery.cd_toolchain_v2 import CdToolchainV2
   ...
   toolchain_service = CdToolchainV2.new_instance()
   tool = toolchain_service.create_tool(
      name = {tool_name},
      toolchain_id = {toolchain_id},
      tool_type_id = {tool_type_id},
      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();
   CreateToolOptions createToolOptions = new CreateToolOptions.Builder()
      .name({tool_name})
      .parameters({tool_parameters})
      .toolchainId({toolchain_id})
      .toolTypeId({tool_type_id})
      .build();
   Response<ToolchainToolPost> response = toolchainService.createTool(createToolOptions).execute();
   ToolchainToolPost tool = response.getResult();
   

Le tableau suivant répertorie et décrit chacune des variables utilisées dans les étapes précédentes.

Ajout d'une intégration d'outils à Terraform

Vous pouvez ajouter des intégrations d'outils à votre chaîne d'outils 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. Créez un fichier de configuration Terraform nommé main.tf. Dans ce fichier, ajoutez la configuration permettant de créer des instances de ressources à l'aide du langage de configuration HashiCorp (HCL). Pour plus d'informations sur l'utilisation de ce langage de configuration, voir la documentation Terraform.

   L'exemple suivant crée une intégration d'outils Delivery Pipeline en utilisant la ressource ibm_cd_toolchain_tool_pipeline, où toolchain_id est un identificateur global unique qui représente la chaîne d'outils dans laquelle créer l'intégration d'outils.

   data "ibm_cd_toolchain" "cd_toolchain" {
     toolchain_id = {toolchain_id}
   }
   resource "ibm_cd_toolchain_tool_pipeline" "cd_pipeline" {
     toolchain_id = data.ibm_cd_toolchain.cd_toolchain.id
     parameters {
       name = "myPipeline"
     }
   }
   

   Pour plus d'informations sur les ressources d'intégration d'outils, voir la liste complète des ressources d'intégration d'outils prises en charge dans le Registre Terraform IBM Cloud.

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

   terraform init
   

4. Créez un plan d'exécution Terraform. Ce plan récapitule toutes les actions qui doivent être exécutées pour créer l'intégration d'outils.

   terraform plan
   

5. Appliquer le plan d'exécution Terraform. Terraform prend toutes les actions requises pour créer l'intégration d'outils.

   terraform apply
   

Mise à jour d'une intégration d'outils à l'aide de la console

Si vous avez reporté la configuration de l'intégration d'un outil lors de la création d'une chaîne d'outils, un bouton Configurer s'affiche sur sa fiche. Si vous avez configuré l'intégration d'un outil lors de la création d'une chaîne d'outils, vous pouvez mettre à jour les paramètres de configuration à l'aide de la console.

1. Dans la console IBM Cloud, cliquez sur l' Menu > Automatisation de la plateforme > Chaînes d'outils.
2. Sur la page Chaînes d'outils, cliquez sur la chaîne d'outils contenant l'intégration d'outil que vous souhaitez mettre à jour pour ouvrir sa page Présentation. Sinon, sur la page Détails de l'application de votre application, cliquez sur le nom de la chaîne d'outils.
3. Si vous devez configurer une intégration d'outils pour la première fois, depuis sa carte, cliquez sur Configurer.
4. Lorsque vous avez terminé la configuration de l'intégration d'outils, cliquez sur Sauvegarder l'intégration.
5. Si vous devez mettre à jour la configuration d'une intégration d'outils, cliquez sur l'icône Actions > Configurer.
6. Lorsque vous avez terminé la mise à jour des paramètres, cliquez sur Sauvegarder l'intégration.

Mise à jour d'une intégration d'outils avec l'API

Si vous avez configuré l'intégration d'un outil lors de la création d'une chaîne d'outils, vous pouvez mettre à jour les paramètres de configuration via l'API.

1. Obtenez un jeton bearer IAM. Sinon, si vous utilisez un SDK, obtenez une clé d'API IAM et définissez les options 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. Recherchez l'ID de la chaîne d'outils dans laquelle l'intégration d'outils existe.

3. A l'aide de l'ID de la chaîne d'outils, recherchez l'ID de l'intégration d'outils.

4. Mettez à jour l'intégration d'outils dans la chaîne d'outils ciblée.

   curl -X PATCH --location --header "Authorization: Bearer {iam_token}" \
     --header "Accept: application/json" \
     --header "Content-Type: application/merge-patch+json" \
     --data '{ "name": "{new_tool_name}", "parameters": {new_tool_parameters} }' \
     "{base_url}/toolchains/{toolchain_id}/tools/{tool_id}"
   

   const CdToolchainV2 = require('@ibm-cloud/continuous-delivery/cd-toolchain/v2');
   const toolchainService = CdToolchainV2.newInstance();
   ...
   (async() => {
      const toolPatchModel = {
         toolchainId: {toolchain_id},
         toolId: {tool_id},
         name: {new_tool_name},
         parameters: {new_tool_parameters}
      };
      const response = await toolchainService.updateTool(toolPatchModel);
   })();
   

   import (
   	   "github.com/IBM/continuous-delivery-go-sdk/cdtoolchainv2"
   )
   ...
   toolchainClientOptions := &cdtoolchainv2.CdToolchainV2Options{}
   toolchainClient, err := cdtoolchainv2.NewCdToolchainV2UsingExternalConfig(toolchainClientOptions)
   toolPatchModel := map[string]interface{}{
      "name": {new_tool_name},
      "parameters": {new_tool_parameters},
   }
   updateToolOptions := toolchainClient.NewUpdateToolOptions({toolchain_id}, {tool_id}, toolPatchModel)
   tool, response, err := toolchainClient.UpdateTool(updateToolOptions)
   

   from ibm_continuous_delivery.cd_toolchain_v2 import CdToolchainV2
   ...
   toolchain_service = CdToolchainV2.new_instance()
   tool = toolchain_service.update_tool(
      toolchain_id = {toolchain_id},
      tool_id = {tool_id},
      toolchain_tool_prototype_patch = {
         "name": {new_tool_name},
         "parameters": {new_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> toolchainToolPrototypePatch = new HashMap<>();
   toolchainToolPrototypePatch.put("name", {new_tool_name});
   toolchainToolPrototypePatch.put("parameters", {new_tool_parameters});
   UpdateToolOptions updateToolOptions = new UpdateToolOptions.Builder()
      .toolchainId({toolchain_id})
      .toolId({tool_id})
      .toolchainToolPrototypePatch(toolchainToolPrototypePatch)
      .build();
   Response<ToolchainToolPatch> response = toolchainService.updateTool(updateToolOptions).execute();
   ToolchainToolPatch tool = response.getResult();
   

Le tableau suivant répertorie et décrit chacune des variables utilisées dans les étapes précédentes.

Mise à jour d'une intégration d'outils avec Terraform

Si vous avez configuré l'intégration d'un outil lors de la création d'une chaîne d'outils, vous pouvez mettre à jour les paramètres de configuration à l'aide de Terraform.

1. Installez l'interface de ligne de commande Terraform et configurez le plug-in de fournisseur IBM Cloud pour Terraform en suivant le tutoriel Initiation à Terraform sur IBM Cloud.

2. Utilisez le fichier de configuration Terraform que vous avez utilisé pour créer l'intégration d'outils. Si votre intégration d'outils n'a pas été créée avec Terraform, exécutez terraform import pour éviter de créer une autre intégration d'outils. Pour plus d'informations sur l'utilisation de ce langage de configuration, voir la documentation Terraform.

   L'exemple suivant met à jour le nom d'une intégration d'outils Delivery Pipeline existante en utilisant la ressource ibm_cd_toolchain_tool_pipeline, où toolchain_id est un identificateur global unique qui représente la chaîne d'outils dans laquelle l'intégration d'outils existe.

   data "ibm_cd_toolchain" "cd_toolchain" {
     toolchain_id = {toolchain_id}
   }
   resource "ibm_cd_toolchain_tool_pipeline" "cd_pipeline" {
     toolchain_id = data.ibm_cd_toolchain.cd_toolchain.id
     parameters {
       name = "myUpdatedPipelineName"
     }
   }
   

   Pour plus d'informations sur les ressources d'intégration d'outils, voir la liste complète des ressources d'intégration d'outils prises en charge dans le Registre Terraform IBM Cloud.

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

   terraform init
   

4. Créez un plan d'exécution Terraform. Ce plan récapitule toutes les actions qui doivent être exécutées pour modifier l'intégration d'outils.

   terraform plan
   

5. Appliquer le plan d'exécution Terraform. Terraform effectue toutes les actions requises pour modifier l'intégration d'outils.

   terraform apply
   

Suppression d'une intégration d'outils à l'aide de la console

Vous pouvez supprimer des intégrations d'outils de votre chaîne d'outils à l'aide de la console. Si vous supprimez une intégration d'outils de votre chaîne d'outils, la suppression est irréversible.

1. Dans la console IBM Cloud, cliquez sur l' Menu > Automatisation de la plateforme > Chaînes d'outils.
2. Sur la page Chaînes d'outils, cliquez sur une chaîne d'outils afin d'ouvrir sa page Vue d'ensemble. Sinon, sur la page Détails de l'application de votre application, cliquez sur le nom de la chaîne d'outils.
3. Sur l'intégration d'outils que vous souhaitez supprimer, cliquez sur l'icône Actions > Supprimer.
4. Confirmez en cliquant sur Supprimer.

Suppression d'une intégration d'outils avec l'API

Vous pouvez supprimer des intégrations d'outils de votre chaîne d'outils à l'aide de l'API. Si vous supprimez une intégration d'outils de votre chaîne d'outils, la suppression est irréversible.

1. Obtenez un jeton bearer IAM. Sinon, si vous utilisez un SDK, obtenez une clé d'API IAM et définissez les options 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. Recherchez l'ID de la chaîne d'outils dans laquelle l'intégration d'outils existe.

3. A l'aide de l'ID de la chaîne d'outils, recherchez l'ID de l'intégration d'outils.

4. Supprimez l'intégration d'outils dans la chaîne d'outils ciblée.

   curl -X DELETE --location --header "Authorization: Bearer {iam_token}" \
     "{base_url}/toolchains/{toolchain_id}/tools/{tool_id}"
   

   const CdToolchainV2 = require('@ibm-cloud/continuous-delivery/cd-toolchain/v2');
   const toolchainService = CdToolchainV2.newInstance();
   ...
   (async() => {
      const response = await toolchainService.deleteTool({
         toolchainId: {toolchain_id},
         toolId: {tool_id}
      });
   })();
   

   import (
   	   "github.com/IBM/continuous-delivery-go-sdk/cdtoolchainv2"
   )
   ...
   toolchainClientOptions := &cdtoolchainv2.CdToolchainV2Options{}
   toolchainClient, err := cdtoolchainv2.NewCdToolchainV2UsingExternalConfig(toolchainClientOptions)
   deleteToolOptions := toolchainClient.NewDeleteToolOptions({toolchain_id}, {tool_id})
   response, err := toolchainClient.DeleteTool(deleteToolOptions)
   

   from ibm_continuous_delivery.cd_toolchain_v2 import CdToolchainV2
   ...
   toolchain_service = CdToolchainV2.new_instance()
   response = toolchain_service.delete_tool(
      toolchain_id = {toolchain_id},
      tool_id = {tool_id}
   )
   

   import com.ibm.cloud.continuous_delivery.cd_toolchain.v2.CdToolchain;
   import com.ibm.cloud.continuous_delivery.cd_toolchain.v2.model.*;
   ...
   CdToolchain toolchainService = CdToolchain.newInstance();
   DeleteToolOptions deleteToolOptions = new DeleteToolOptions.Builder()
      .toolchainId({toolchain_id})
      .toolId({tool_id})
      .build();
   Response<Void> response = toolchainService.deleteTool(deleteToolOptions).execute();
   

Le tableau suivant répertorie et décrit chacune des variables utilisées dans les étapes précédentes.

Suppression d'une intégration d'outils avec Terraform

Vous pouvez supprimer des intégrations d'outils de votre chaîne d'outils avec Terraform. Si vous supprimez une intégration d'outils de votre chaîne d'outils, la suppression est irréversible.

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. Utilisez le fichier de configuration Terraform que vous avez utilisé pour créer l'intégration d'outils. Mettez en commentaire ou supprimez la ressource d'intégration d'outils du fichier de configuration.

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

   terraform init
   

4. Créez un plan d'exécution Terraform. Ce plan récapitule toutes les actions qui doivent être exécutées pour supprimer l'intégration d'outils.

   terraform plan
   

5. Appliquer le plan d'exécution Terraform. Terraform effectue toutes les actions requises pour supprimer l'intégration d'outils.

   terraform apply