Utilización de cadenas de herramientas

DevOps Insights Llegará al final de su vida útil y se dejará de ofrecer el 31 de agosto de 2026. Continuous Delivery dejará de estar disponible en las siguientes regiones el 12 de febrero de 2027: au-syd, ca-tor, us-east. Code Risk Analyzer también dejará de estar disponible en todas las regiones a partir de esa fecha. Si en una región no se hace uso activo de estas funciones, es posible que dichas funciones se dejen de ofrecer antes de lo previsto en esa región y dejen de aceptar nuevas instancias. Más información

Las cadenas de herramientas abiertas están disponibles en IBM Cloud®. Puede utilizar una cadena de herramientas para que sea productiva en su trabajo diario de desarrollo, despliegue y operaciones. Una vez que se ha configurado una cadena de herramientas, es posible añadir, suprimir o configurar integraciones de herramientas y gestionar el acceso a la cadena de herramientas. Para obtener más información sobre cómo trabajar con integraciones de herramientas, consulte Trabajar con integraciones de herramientas.

Gestión del acceso a las cadenas de herramientas

Puede utilizar el servicio de Identity and Access Management (IAM) para gestionar el acceso de usuario a las cadenas de herramientas en grupos de recursos. Para obtener más información sobre la gestión del control de acceso con IAM, consulte Gestión del acceso de usuarios a las cadenas de herramientas de los grupos de recursos.

Los usuarios con acceso a las cadenas de herramientas se pueden contar como usuarios autorizados del servicio IBM Cloud® Continuous Delivery. Para obtener más información sobre cómo se cuentan los usuarios autorizados, consulte Limitaciones y uso del plan.

Organización de cadenas de herramientas

Puede añadir etiquetas a sus cadenas de herramientas para organizarlas y encontrarlas fácilmente más adelante. Una etiqueta es un código que se asigna a una cadena de herramientas para facilitar el filtrado de las cadenas de herramientas en la lista de cadenas de herramientas.

  1. En la consola IBM Cloud, haga clic en el icono de menú hamburguesa > Automatización de la plataforma > Cadenas de herramientas.
  2. En la página Cadenas de herramientas, localice la cadena de herramientas a la que desee añadir una etiqueta y pulse Añadir etiquetas.
  3. Especifique un nombre para la etiqueta que desee añadir a la cadena de herramientas. Puede añadir varias etiquetas, separadas por comas.
  4. Pulse Guardar.

Para obtener más información sobre las etiquetas, consulte Cómo trabajar con etiquetas.

Visualización de las conexiones de la cadena de herramientas con apps, clústeres y servicios

Puedes ver las conexiones de tu cadena de herramientas con los clústeres y servicios de Kubernetes.

  1. En la consola IBM Cloud, haga clic en el icono de menú hamburguesa > 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. Seleccione el separador Conexiones y seleccione la app, el clúster o el servicio que desea ver.

Supresión de una cadena de herramientas

Puede suprimir una cadena de herramientas. Cuando suprime una cadena de herramientas, también se suprimen todas las integraciones de herramientas que pertenecen a dicha cadena de herramientas. La eliminación no se puede deshacer.

Cuando se elimina una integración de la herramienta Delivery Pipeline, también se elimina la herramienta Delivery Pipeline asociada.

Cuando se suprime un GitHub o la integración de herramientas de Git Repos and Issue Tracking, el repositorio asociado no se suprime de GitHub ni Git Repos and Issue Tracking. Debe eliminar manualmente el repositorio.

Supresión de una cadena de herramientas utilizando la consola

  1. En la consola IBM Cloud, haga clic en el icono de menú hamburguesa > 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. Pulse el menú Acciones y seleccione Suprimir. Cuando se suprime una cadena de herramientas, también se suprimen todas sus integraciones de herramienta, lo que podría dar lugar a la supresión de los recursos que dichas integraciones gestionan.
  4. Para confirmar la supresión, escriba el nombre de la cadena de herramientas y pulse Suprimir.

Supresión de una cadena de herramientas de la CLI (Beta)

  1. Inicie sesión en IBM Cloud utilizando la CLI deIBM Cloud.

    ibmcloud login
    

    Si el inicio de sesión falla, ejecute el mandato ibmcloud login --sso para volver a intentarlo. Se requiere el parámetro --sso para iniciar sesión con un ID federado. Si utiliza esta opción, vaya al enlace que aparece en la salida de la CLI para generar un código de acceso de un solo uso.

  2. Opcional. Liste todas las cadenas de herramientas en la cuenta, región y grupo de recursos de destino para identificar la instancia que desea suprimir.

    ibmcloud dev toolchains
    
  3. Suprima una cadena de herramientas ejecutando el mandato ibmcloud dev toolchain-delete.

    ibmcloud dev toolchain-delete TOOLCHAIN-NAME
    

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

Variables para borrar la cadena de herramientas desde la CLI
Variable Descripción
TOOLCHAIN_NAME El nombre de la cadena de herramientas que desea eliminar.

Cómo eliminar una cadena de herramientas 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. Elimina la cadena de herramientas que desees eliminar.

    curl -X DELETE \
      "{base_url}/toolchains/{toolchain_id}" \
      -H 'Authorization: Bearer {token}'
    
    const CdToolchainV2 = require('@ibm-cloud/continuous-delivery/cd-toolchain/v2');
    const toolchainService = CdToolchainV2.newInstance();
    ...
    (async() => {
       const response = await toolchainService.deleteToolchain({
          toolchainId: {toolchain_id}
       });
    })();
    
    import (
    	   "github.com/IBM/continuous-delivery-go-sdk/cdtoolchainv2"
    )
    ...
    toolchainClientOptions := &cdtoolchainv2.CdToolchainV2Options{}
    toolchainClient, err := cdtoolchainv2.NewCdToolchainV2UsingExternalConfig(toolchainClientOptions)
    deleteToolchainOptions := toolchainClient.NewDeleteToolchainOptions({toolchain_id})
    response, err := toolchainClient.DeleteToolchain(deleteToolchainOptions)
    
    from ibm_continuous_delivery.cd_toolchain_v2 import CdToolchainV2
    ...
    toolchain_service = CdToolchainV2.new_instance()
    response = toolchain_service.delete_toolchain(
       toolchain_id = toolchain_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();
    DeleteToolchainOptions deleteToolchainOptions = new DeleteToolchainOptions.Builder()
       .toolchainId({toolchain_id})
       .build();
    Response<Void> response = toolchainService.deleteToolchain(deleteToolchainOptions).execute();
    

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

Variables para eliminar la cadena de herramientas con la API
Variable Descripción
{base_url} El punto final de la API de la cadena de herramientas URL, por ejemplo https://api.us-south.devops.cloud.ibm.com/toolchain/v2. Para obtener más información sobre este punto final URL, incluida una lista de valores, consulte Punto final URL.
{iam_api_key} Su clave de API IAM.
{token} Un token de portador de IAM válido.
{toolchain_id} El ID de la cadena de herramientas que desea eliminar.

Supresión de una cadena de herramientas con Terraform

  1. Localice el archivo Terraform (por ejemplo, main.tf) que contiene el bloque resource para la cadena de herramientas existente. Para obtener más información sobre cómo utilizar Terraform con cadenas de herramientas, consulte Creación de una cadena de herramientas con Terraform.

    resource en el ejemplo siguiente describe una cadena de herramientas existente.

    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
    }
    
  2. Elimine el bloque resource del archivo Terraform.

  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 suprimir la cadena de herramientas.

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

    terraform apply
    

Gestión de cadenas de herramientas alternativas en distintas regiones

Puede definir su cadena de herramientas mediante el lenguaje de configuración de Terraform y, a continuación, aplicar y mantener su definición de cadena de herramientas en dos regiones: una región principal con canalizaciones activas y una región alternativa con canalizaciones inactivas. Si utiliza Git Repos and Issue Tracking, también puede replicar sus repositorios Git de la región primaria a la región alternativa. El mantenimiento de cadenas de herramientas y repositorios Git primarios y alternativos proporciona una conmutación por error y una redundancia más rápidas. Además, garantiza un funcionamiento fluido en caso de que surjan problemas en la región principal. Al codificar su cadena de herramientas en Terraform, puede actualizar su cadena de herramientas y aplicar los cambios a ambas regiones.

Para obtener más información sobre el uso de Terraform, consulte Configuración de Terraform para Continuous Delivery.