Creación de cadenas de herramientas

Creación de una cadena de herramientas a partir de una plantilla utilizando la consola

Puede utilizar una plantilla como punto de partida para crear una cadena de herramientas que incluya un conjunto específico de integraciones de herramientas. En función de la plantilla que utilice, puede crear una cadena de herramientas que tenga un conjunto específico de integraciones de herramientas o bien una cadena de herramientas vacía a la que puede añadir integraciones de herramientas. Obtenga más información sobre cómo utilizar las plantillas en IBM Cloud Garage Method.

1. Inicie sesión en IBM Cloud.

2. En la consola IBM Cloud, haga clic en el icono de menú > Automatización de la plataforma > Cadenas de herramientas.

3. En la página Cadenas de herramientas, pulse Crear una cadena de herramientas.

4. En la página Crear una cadena de herramientas, haga clic en una plantilla de cadena de herramientas.

5. Revise el diagrama de la cadena de herramientas que se dispone a crear. El diagrama muestra cada integración de herramientas en la fase del ciclo de vida correspondiente en la cadena de herramientas.

   Algunas de las plantillas de cadena de herramientas tienen varias instancias de una integración de herramientas. Por ejemplo, la plantilla de cadena de herramientas "Desarrollar y probar microservicios con Kubernetes y Helm" en IBM Cloud Público contiene cuatro instancias de GitHub y cuatro instancias de Delivery Pipeline.

   El diagrama de la imagen siguiente es un ejemplo. Cuando cree una cadena de herramientas, el diagrama mostrará cada integración de herramientas que forma parte de la cadena de herramientas.

   

   herramientas*

6. Revise la información predeterminada de los valores de la cadena de herramientas:

   • El nombre de la cadena de herramientas la identifica en IBM Cloud. Si desea utilizar otro nombre, cambie el nombre de la cadena de herramientas.
   • La región en la que se va crear la cadena de herramientas. Si desea utilizar otra región, selecciónela en la lista de regiones disponibles.
   • Grupo de recursos en el que crear la cadena de herramientas. Si quiere utilizar un grupo de recursos distinto, selecciónelo en la lista de grupos de recursos disponibles.
   • El proveedor del repositorio de origen, por ejemplo GitHub, GitLab o Bitbucket. Si desea utilizar otro proveedor de origen, selecciónela en la lista de repositorios disponibles.

7. En la sección Integraciones de herramientas, seleccione las integraciones de herramientas que desee configurar para su cadena de herramientas. Algunas integraciones de herramientas no necesitan configuración. Para obtener más información sobre cómo configurar las integraciones de herramientas, consulte Configurar integraciones de herramientas.

   Muchas de las integraciones de herramientas que comprenden una cadena de herramientas necesitan un secreto para autenticarse con el servicio Continuous Delivery.

   Un secreto son credenciales que se pueden proporcionar en forma de contraseña, señal de autenticación, clave de API o certificado. Por ejemplo, cuando añade la integración de la herramienta Delivery Pipeline a la cadena de herramientas, debe proporcionar un secreto en forma de clave de API.

   a. En la sección Integraciones de herramientas, pulse Delivery Pipeline.

   b. Pulse Nueva para crear una clave de API de IBM Cloud®.

   c. Pulse Aceptar para aplicar la nueva clave de API.

   Cada usuario puede tener un máximo de 20 claves de API.

   d. Pulse Aceptar para crear la clave de API sin guardar una copia segura de la clave.

   e. Para guardar de forma segura la clave API y poder volver a utilizarla en otros flujos de trabajo de la cadena de herramientas:

   • Seleccione la casilla ' Guarda esta clave en un almacén de secretos para reutilizarla ' para integrar con la tienda de secretos ' Key Protect o ' Secrets Manager '.
   • Si no tiene una instancia existente de Key Protect o Secrets Manager, especifique un nombre para la instancia y el secreto.
   • Pulse Aceptar para aplicar la nueva clave de API.

   f. Para validar que la instancia de Key Protect o Secrets Manager se ha creado correctamente, vaya a la lista de recursos IBM Cloud® y expanda el triángulo Servicios. Para ver sus claves de API, en la barra de menús, haga clic en Gestionar > Acceso (IAM) y seleccione IBM Cloud® Claves API.

   g. La clave de API que ha creado y copiado en el proyecto clave está ahora disponible para su uso en la página Crear una cadena de herramientas. Cualquier integración de herramientas que necesite un secreto muestra un icono de clave. Haga clic en el icono de llave para abrir un cuadro de diálogo Selector de secretos para recuperar secretos de una o varias instancias Key Protect o Secrets Manager.

8. Pulse Crear. Para configurar la cadena de herramientas, se ejecutan varios pasos automáticamente. Las integraciones de herramientas configuradas difieren en función de la plantilla de cadena de herramientas seleccionada. Por ejemplo, cuando crea una cadena de herramientas "Desarrollar y probar microservicios con Kubernetes y Helm" en IBM Cloud público, se ejecutan estos pasos:

   • Se crea la cadena de herramientas.
   • Si ha configurado Delivery Pipeline, los conductos se crean y se activan.
   • Si configuraste ' Event Notifications, la cadena de herramientas está configurada para enviar notificaciones de eventos al servicio ' Event Notifications ' que especificaste.
   • Si ha configurado Sauce Labs, la cadena de herramientas se configura para añadir trabajos de prueba de Sauce Labs a los conductos.
   • Si ha configurado PagerDuty, la cadena de herramientas se configura para enviar notificaciones de alerta al servicio PagerDuty que ha especificado.
   • Si ha configurado Slack, la cadena de herramientas se configura para enviar notificaciones sobre el estado de despliegue al canal Slack que ha especificado.
   • Si ha configurado la integración de una herramienta de código fuente como GitHub, el repositorio de ejemplo de GitHub se clona en su cuenta de GitHub.

   You can now distribute event notifications by using the Event Notifications tool integration. IBM Cloud Event Notifications is the preferred method for distributing notifications to PagerDuty and other communication channels such as Slack, email, SMS, push notifications, webhook, Microsoft® Teams, ServiceNow, and IBM Cloud Functions. Para obtener más información sobre cómo utilizar Event Notifications, consulte Habilitación de notificaciones de sucesos para cadenas de herramientas.

Creación de una cadena de herramientas desde una app utilizando la consola

Puede crear una cadena de herramientas desde su app. La cadena de herramientas puede admitir tareas continuadas de desarrollo, despliegue, supervisión, etc., y está asociada con su app. Cada app puede asociarse a una cadena de herramientas. Cuando se envían los cambios al repositorio de GitHub de la cadena de herramientas, el conducto crea y despliega automáticamente la app.

1. Si ha utilizado IBM Cloud Public para crear tu aplicación, se configura para la entrega continua desde un nuevo repositorio de GitHub que se rellena con el código de inicio de la aplicación.

2. En la página de configuración de cadenas de herramientas, revise el diagrama de la cadena de herramientas que está a punto de crear. El diagrama muestra cada integración de herramientas en la fase del ciclo de vida correspondiente en la cadena de herramientas.

3. Revise la información predeterminada para la configuración de la cadena de herramientas. El nombre de la cadena de herramientas la identifica en IBM Cloud. Si desea utilizar otro nombre, cambie el nombre de la cadena de herramientas.

4. En la sección Integraciones de herramientas, seleccione las integraciones de herramientas que desee configurar para su cadena de herramientas. Algunas integraciones de herramientas no necesitan configuración. Para obtener más información sobre cómo configurar las integraciones de herramientas, consulte Configurar integraciones de herramientas.

5. Pulse Crear. Para configurar la cadena de herramientas, se ejecutan varios pasos automáticamente. Por ejemplo, si crea una cadena de herramientas a partir de una app en IBM Cloud público, se ejecutan estos pasos:

   • Se crea la cadena de herramientas.
   • Si ha configurado Delivery Pipeline, los conductos se crean y se activan.
   • Si ha configurado GitHub, el repositorio de ejemplo de GitHub se clona en su cuenta de GitHub.

Creación de una 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 del grupo de recursos en el que desea crear la cadena de herramientas.

3. Elija la región en la que desea crear la cadena de herramientas.

4. Crear una instancia de la cadena de herramientas.

   curl -X POST \
     "{base_url}/toolchains" \
     -H 'Authorization: Bearer {token}' \
     -H 'Content-Type: application/json' \
       -d '{
       "name": "{toolchain_name}",
       "resource_group_id": "{resource_group_id}"
     }'
   

   const CdToolchainV2 = require('@ibm-cloud/continuous-delivery/cd-toolchain/v2');
   const toolchainService = CdToolchainV2.newInstance();
   ...
   (async() => {
      const toolchainPrototypeModel = {
         description: {toolchain_description},
         name: {toolchain_name},
         resourceGroupId: {resource_group_id}
      };
      const response = await toolchainService.createToolchain(toolchainPrototypeModel);
   })();
   

   import (
   	   "github.com/IBM/continuous-delivery-go-sdk/cdtoolchainv2"
   )
   ...
   toolchainClientOptions := &cdtoolchainv2.CdToolchainV2Options{}
   toolchainClient, err := cdtoolchainv2.NewCdToolchainV2UsingExternalConfig(toolchainClientOptions)
   createToolchainOptions := toolchainClient.NewCreateToolchainOptions({toolchain_name}, {resource_group_id})
   createToolchainOptions.SetDescription({toolchain_description})
   toolchain, response, err := toolchainClient.CreateToolchain(createToolchainOptions)
   

   from ibm_continuous_delivery.cd_toolchain_v2 import CdToolchainV2
   ...
   toolchain_service = CdToolchainV2.new_instance()
   toolchain = toolchain_service.create_toolchain(
      description = {toolchain_description},
      name = {toolchain_name},
      resource_group_id = {resource_group_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();
   CreateToolchainOptions createToolchainOptions = new CreateToolchainOptions.Builder()
      .description({toolchain_description})
      .name({toolchain_name})
      .resourceGroupId({resource_group_id})
      .build();
   Response<ToolchainPost> response = toolchainService.createToolchain(createToolchainOptions).execute();
   ToolchainPost toolchain = response.getResult();
   

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

Para obtener más información sobre la creación de cadenas de herramientas con la API, consulte Crear una cadena de herramientas en la documentación de la API de IBM Cloud.

Creación de una 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ñada la configuración para crear una cadena de herramientas utilizando el Lenguaje de Configuración HashiCorp. 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 cadena de herramientas utilizando el recurso ibm_cd_toolchain.

   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
   }
   

   Para obtener más información sobre ibm_cd_toolchain, consulte los detalles de referencia de argumentos en la Documentación del registro de 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 crear una cadena de herramientas.

   terraform plan
   

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

   terraform apply