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, haz 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 Public 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 de la API y poder volver a utilizarla en otros flujos de trabajo de la cadena de herramientas:

   • Marca la casilla Guardar esta clave en un almacén de secretos para su reutilización para integrarla con el almacén de secretos de Key Protect o Secrets Manager.
   • Si aún no dispone de una instancia 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 tus claves de API, en la barra de menús, haz clic en Gestionar > Acceso (IAM) y selecciona IBM Cloud® ar claves de 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. Haz clic en el icono de la llave para abrir el cuadro de diálogo Secrets Picker y recuperar secretos de una o varias instancias de 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 ha configurado Event Notifications, la cadena de herramientas está configurada para enviar notificaciones de eventos al servicio Event Notifications que haya especificado.
   • 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.

   Ahora puede distribuir notificaciones de eventos mediante la integración de la herramienta Event NotificationsIBM Cloud Event Notifications es el método preferido para distribuir notificaciones a PagerDuty y otros canales de comunicación como Slack, correo electrónico, SMS, notificaciones push, webhook, Microsoft® Teams, ServiceNow, y IBM Cloud Functions. Para obtener más información sobre el uso de Event Notifications, consulte Activación de notificaciones de eventos 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 has utilizado IBM Cloud Public para crear tu aplicación, esta está configurada para la entrega continua desde un nuevo repositorio de GitHub que contiene el código inicial 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. Crea 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ñade la configuración para crear una cadena de herramientas utilizando el lenguaje de configuración de la plataforma de desarrollo de aplicaciones ( 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. Aplica el plan de ejecución de Terraform. Terraform realiza todas las acciones necesarias para crear la cadena de herramientas.

   terraform apply