Adición de una integración de herramientas utilizando la consola

Puede añadir integraciones de herramientas a la cadena de herramientas utilizando la consola.

1. En la consola IBM Cloud, haga clic en el icono de menú > Automatización de la plataforma > Cadenas de herramientas.
2. En la página Cadenas de herramientas, pulse una cadena de herramientas para abrir su página Visión general. Como alternativa, en la página Detalles de la app, pulse el nombre de la cadena de herramientas.
3. Para ver una lista de integraciones de herramientas que se pueden añadir, haz clic en Añadir.
4. Pulse en la integración de herramientas que desee añadir.
5. Introduzca la información necesaria para configurar la integración de la herramienta.
6. Pulse Crear integración para añadir la integración de la herramienta en su cadena de herramientas.

Adición de una integración de herramientas con la API

Puede añadir integraciones de herramientas a la cadena de herramientas con la API.

1. Obtener una señal portadora de IAM. De forma alternativa, si utiliza un SDK, obtenga una clave de API de IAM y establezca las opciones de cliente utilizando variables de entorno.

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

2. Busque el ID de la cadena de herramientas en la que desea crear la integración de herramientas.

3. Busque el valor de tool_type_id que corresponde a la integración de herramientas que desea añadir.

4. Añadir la integración de la herramienta dentro de la cadena de herramientas prevista.

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

La tabla siguiente lista y describe cada una de las variables que se utilizan en los pasos anteriores.

Adición de una integración de herramientas con Terraform

Puede añadir integraciones de herramientas a la cadena de herramientas con Terraform.

1. Para instalar la CLI de Terraform y configurar el plug-in de proveedor de IBM Cloud para Terraform, siga la guía de aprendizaje Cómo empezar con Terraform en IBM Cloud®.

2. Cree un archivo de configuración de Terraform denominado main.tf. En este archivo, añade la configuración para crear instancias de recursos utilizando el lenguaje de configuración de HashiCorp (HCL). Para obtener más información sobre cómo utilizar este idioma de configuración, consulte la documentación de Terraform.

   El ejemplo siguiente crea una integración de herramientas de Delivery Pipeline utilizando el recurso ibm_cd_toolchain_tool_pipeline, donde toolchain_id es un GUID que representa la cadena de herramientas en la que crear la integración de herramientas.

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

   Para obtener más información sobre los recursos de integración de herramientas, consulte la lista completa de recursos de integración de herramientas soportados en IBM Cloud Terraform Registry.

3. Inicialice la CLI de Terraform.

   terraform init
   

4. Cree un plan de ejecución de Terraform. Este plan resume todas las acciones que se deben ejecutar para crear la integración de herramientas.

   terraform plan
   

5. Aplica el plan de ejecución de Terraform. Terraform realiza todas las acciones necesarias para crear la integración de herramientas.

   terraform apply
   

Actualización de una integración de herramientas utilizando la consola

Si pospuso la configuración de la integración de una herramienta al crear una cadena de herramientas, aparecerá un botón Configurar en su ficha. Si ha configurado la integración de una herramienta al crear una cadena de herramientas, puede actualizar los parámetros de configuración mediante la consola.

1. En la consola IBM Cloud, haga clic en el icono de menú > Automatización de la plataforma > Cadenas de herramientas.
2. En la página Cadenas de herramientas, haz clic en la cadena de herramientas que contenga la integración de la herramienta que deseas actualizar para abrir su página Descripción general. Como alternativa, en la página Detalles de la app, pulse el nombre de la cadena de herramientas.
3. Si necesita configurar una integración de herramienta por primera vez, en su tarjeta, pulse Configurar.
4. Cuando haya terminado de configurar la integración de la herramienta, pulse Guardar integración.
5. Si necesita actualizar la configuración de una integración de herramientas, pulse el icono Acciones > Configurar.
6. Cuando haya terminado de configurar los ajustes, pulse Guardar integración.

Actualización de una integración de herramientas con la API

Si ha configurado la integración de una herramienta al crear una cadena de herramientas, puede actualizar los parámetros de configuración mediante la API.

1. Obtener una señal portadora de IAM. De forma alternativa, si utiliza un SDK, obtenga una clave de API de IAM y establezca las opciones de cliente utilizando variables de entorno.

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

2. Busque el ID de la cadena de herramientas donde existe la integración de herramientas.

3. Utilizando el ID de la cadena de herramientas, busque el ID de la integración de herramientas.

4. Actualice la integración de herramientas dentro de la cadena de herramientas de destino.

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

La tabla siguiente lista y describe cada una de las variables que se utilizan en los pasos anteriores.

Actualización de una integración de herramientas con Terraform

Si has configurado la integración de una herramienta al crear una cadena de herramientas, puedes actualizar los parámetros de configuración con Terraform.

1. Instale la CLI de Terraform y configure el plugin de proveedor de IBM Cloud para Terraform siguiendo la guía de aprendizaje de Iniciación a Terraform en IBM Cloud.

2. Utilice el archivo de configuración de Terraform que ha utilizado para crear la integración de herramientas. Si la integración de herramientas no se ha creado con Terraform, ejecute terraform import para evitar crear otra integración de herramientas. Para obtener más información sobre cómo utilizar este idioma de configuración, consulte la documentación de Terraform.

   El ejemplo siguiente actualiza el nombre de una integración de herramientas Delivery Pipeline existente utilizando el recurso ibm_cd_toolchain_tool_pipeline, donde toolchain_id es un GUID que representa la cadena de herramientas donde existe la integración de herramientas.

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

   Para obtener más información sobre los recursos de integración de herramientas, consulte la lista completa de recursos de integración de herramientas soportados en IBM Cloud Terraform Registry.

3. Inicialice la CLI de Terraform.

   terraform init
   

4. Cree un plan de ejecución de Terraform. Este plan resume todas las acciones que deben ejecutarse para modificar la integración de herramientas.

   terraform plan
   

5. Aplica el plan de ejecución de Terraform. Terraform realiza todas las acciones necesarias para modificar la integración de herramientas.

   terraform apply
   

Supresión de una integración de herramientas utilizando la consola

Puede suprimir integraciones de herramientas de la cadena de herramientas utilizando la consola. Si suprime una integración de herramientas de la cadena de herramientas, la supresión no se puede deshacer.

1. En la consola IBM Cloud, haga clic en el icono de menú > Automatización de la plataforma > Cadenas de herramientas.
2. En la página Cadenas de herramientas, pulse una cadena de herramientas para abrir su página Visión general. Como alternativa, en la página Detalles de la app, pulse el nombre de la cadena de herramientas.
3. En la integración de herramientas que desea suprimir, pulse el icono Acciones > Suprimir.
4. Confirme la acción pulsando Suprimir.

Supresión de una integración de herramientas con la API

Puede suprimir integraciones de herramientas de la cadena de herramientas con la API. Si suprime una integración de herramientas de la cadena de herramientas, la supresión no se puede deshacer.

1. Obtener una señal portadora de IAM. De forma alternativa, si utiliza un SDK, obtenga una clave de API de IAM y establezca las opciones de cliente utilizando variables de entorno.

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

2. Busque el ID de la cadena de herramientas donde existe la integración de herramientas.

3. Utilizando el ID de la cadena de herramientas, busque el ID de la integración de herramientas.

4. Suprima la integración de herramientas dentro de la cadena de herramientas de destino.

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

La tabla siguiente lista y describe cada una de las variables que se utilizan en los pasos anteriores.

Supresión de una integración de herramientas con Terraform

Puede suprimir integraciones de herramientas de la cadena de herramientas con Terraform. Si suprime una integración de herramientas de la cadena de herramientas, la supresión no se puede deshacer.

1. Para instalar la CLI de Terraform y configurar el plug-in de proveedor de IBM Cloud para Terraform, siga la guía de aprendizaje Cómo empezar con Terraform en IBM Cloud.

2. Utilice el archivo de configuración de Terraform que ha utilizado para crear la integración de herramientas. Comente o elimine el recurso de integración de herramientas del archivo de configuración.

3. Inicialice la CLI de Terraform.

   terraform init
   

4. Cree un plan de ejecución de Terraform. Este plan resume todas las acciones que se deben ejecutar para suprimir la integración de herramientas.

   terraform plan
   

5. Aplica el plan de ejecución de Terraform. Terraform realiza todas las acciones necesarias para suprimir la integración de herramientas.

   terraform apply