Contenido relacionado

• Iniciación a Continuous Delivery
• Iniciación a los clústeres
• Iniciación a las cadenas de herramientas

Configurar el nombre y la región de la cadena de herramientas

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. Asegúrese de que el nombre de la cadena de herramientas sea exclusivo dentro de las cadenas de herramientas de la misma región y grupo de recursos en IBM Cloud.

La región de la cadena de herramientas puede diferir del clúster y de la región de registro.

Seleccione la estrategia de despliegue

La cadena de herramientas crea una interconexión de despliegue continuo para desplegar la imagen de Docker de la aplicación en IBM Cloud® Kubernetes Service. Seleccione la estrategia de despliegue que quiera utilizar. Deberá proporcionar más detalles, que dependerán de la estrategia de despliegue elegida (continua, azul-verde o Canary).

1. Pulse la estrategia de despliegue que quiera utilizar para la cadena de herramientas.

   {: caption="

2. Pulse Continuar.

Configurar el repositorio de código fuente de aplicación

En el paso Aplicación, se muestran, de forma predeterminada, las opciones recomendadas para el repositorio del código fuente de aplicación. Para ver todas las opciones disponibles para la integración de Git subyacente, pulse Opciones avanzadas. De forma predeterminada, la cadena de herramientas utiliza el ejemplo predeterminado que clona la aplicación de ejemplo como un repositorio de Git Repos and Issue Tracking alojado en IBM.

Puede cambiar el nombre del repositorio de aplicaciones. La región del repositorio sigue siendo la misma que la región de la cadena de herramientas.

La plantilla de la cadena de herramientas proporciona un ejemplo de aplicación Spring Java™ que utiliza una compilación Maven. Si quiere enlazar un repositorio de aplicaciones existente para la cadena de herramientas, seleccione Traer su propia aplicación y especifique el URL del repositorio. La cadena de herramientas solo admite la creación de enlaces con repositorios existentes de Git Repos and Issue Tracking.

De forma predeterminada, la plantilla del repositorio de aplicaciones se clona en la organización Git Repos and Issue Tracking. Para cambiar la organización, habilite las Opciones avanzadas y especifique el propietario del repositorio.

Configurar el repositorio de inventario

El repositorio de inventario registra los detalles de los artefactos creados por las cadenas de herramientas de integración continua. Puede crear un nuevo repositorio de inventario que sea un clon de la plantilla de repositorio de inventario o utilizar un repositorio de inventario ya existente que comparta entre cadenas de herramientas.

De forma predeterminada, la plantilla del repositorio de inventario se clona en la organización Git Repos and Issue Tracking. Para cambiar la organización, seleccione Opciones avanzadas y especifique el propietario del repositorio.

Almacenar secretos de forma segura

Hay varias herramientas de esta cadena de herramientas que requieren secretos, como una clave de API de IBM Cloud. Es necesario almacenar de forma segura todos los secretos en una caja fuerte de secretos y hacer referencia a ellos siempre que lo requiera la cadena de herramientas.

Con IBM Cloud, puede elegir entre varias ofertas de gestión de secretos y protección de datos que le ayudan a proteger los datos confidenciales y a centralizar los secretos. En el paso Secretos, puede especificar qué integraciones de la caja fuerte de secretos se deben añadir o eliminar de la cadena de herramientas. Para obtener más información sobre cómo añadir y eliminar integraciones de la caja fuerte, así como los requisitos previos y el uso de sugerencias, consulte Gestión de secretos de IBM Cloud.

Cuando se utilizan sugerencias en una plantilla, la cadena de herramientas se rellena automáticamente con secretos configurados previamente; no es necesario seleccionar secretos de forma manual en las integraciones de cajas fuertes conectadas a la cadena de herramientas.

En esta guía de aprendizaje, se utiliza IBM Secrets Manager como caja fuerte de secretos.

{: caption="

IBM Secrets Manager almacena y aplica de forma segura secretos como las claves de API, la firma de imágenes o las credenciales de HashiCorp que forman parte de la cadena de herramientas.

Para más información sobre la gestión de sus secretos en IBM Key Protect o HashiCorp, consulte Secretos.

Configurar detalles de la VPC

Configure la cadena de herramientas especificando información sobre la VPC y las instancias de servidor virtual (VSI).

La VPC y la VSI se han suministrado mediante IBM Cloud® Schematics y Terraform al seleccionar la estrategia de despliegue que utilizar.

• Región de la nube privada virtual: seleccione la región en la que se ha suministrado la VPC.
• Nombre de nube privada virtual: seleccione la VPC suministrada mediante la plantilla de Terraform. Entre las opciones, se incluyen todas las VPC disponibles en la región seleccionada.
• Nombre de usuario para instancias de VPC: especifique el nombre de usuario configurado al suministrar la instancia de VPC. Todas las VSI de la VPC requieren un nombre de usuario y una clave SSH para iniciar la sesión y desplegar la instancia.
• Clave SSH codificada en Base64 para instancias de VPC: especifique la clave SSH privada con el formato codificado en base64 para la clave pública SSH configurada al suministrar las instancias de VPC.

Configurar los detalles del host de bastión

La plantilla de Terraform también crea una VSI para utilizarla como host de bastión. Un host de bastión ofrece una manera segura de conectarse a las VSI de la VPC para completar las tareas de despliegue y mantenimiento. El host de bastión se conecta a las VSI a través de SSH utilizando las credenciales (nombre de usuario y clave SSH) configuradas en los detalles de la VPC.

La cadena de herramientas requiere que se inicie la sesión en las VSI de la VPC para desplegar el archivo binario de la aplicación, iniciar y detener la aplicación y descargar la dependencia de terceros para ejecutar la aplicación. Todas estas tareas se ejecutan utilizando el tunelado SSH con el host de bastión. La cadena de herramientas utiliza las mismas credenciales para iniciar la sesión en el host de bastión que las que utiliza el host de bastión para conectarse a las VSI.

• Host de bastión: seleccione la VSI suministrada como host de bastión por la plantilla de Terraform.

Configurar detalles del equilibrador de carga

La aplicación de ejemplo desplegada en las VSI de la VPC muestra una página web simple en el puerto 8080. Para hacer que la aplicación esté disponible en Internet utilizando un nombre DNS, además de para equilibrar la carga de tráfico entre las diversas VSI que ejecutan la aplicación, la plantilla de Terraform suministra un equilibrador de carga de aplicación. Todas las VSI que ejecutan la aplicación forman la agrupación de programa de fondo de los servidores para el equilibrador de carga.

La cadena de herramientas utiliza los detalles del equilibrador de carga y dos agrupaciones de programa de fondo para configurar y redirigir el tráfico de la aplicación activa durante el proceso de despliegue azul-verde. La agrupación de programa de fondo azul y la agrupación de programa de fondo verde contienen el mismo número de VSI. En todo momento, solo una de las agrupaciones da servicio activamente al tráfico activo, mientras que la otra permanece desocupada mediante la ejecución de una versión anterior de la aplicación. Con cada despliegue, el equilibrador de carga intercambia o conmuta la agrupación de programa de fondo que da servicio al tráfico activo. Si la agrupación de programa de fondo azul está activa actualmente, en el despliegue siguiente se desplegará la aplicación en las VSI de la agrupación de programa de fondo verde, que pasará a estar activa, mientras que la agrupación de programa de fondo azul pasará a ser la pasiva.

Para configurar la cadena de herramientas, especifique la información sobre el equilibrador de carga:

• Nombre del equilibrador de carga: seleccione el equilibrador de carga de aplicación suministrado por la plantilla de Terraform.
• Nombre de la agrupación de programa de fondo azul: seleccione la agrupación de programa de fondo azul que suministra la plantilla de Terraform para el equilibrador de carga.
• Nombre de la agrupación de programa de fondo verde: seleccione la agrupación de programa de fondo verde que suministra la plantilla de Terraform para el equilibrador de carga.

{: caption="de despliegue de objetivos*

Una vez completados los detalles de los pasos de deployment target, continúe con el paso siguiente.

Configurar almacenamiento de artefactos

Cualquier cambio en el origen activa el conducto de integración continua. Cuando una integración continua se ejecuta correctamente, se crea una compilación o un artefacto binario, que se guarda en un almacenamiento transitorio y, a continuación, se despliega en las VSI de destino.

{: caption="

Puede utilizar IBM Cloud Object Storage para almacenar los artefactos de compilación transitorios en la cadena de herramientas. La interconexión de integración continua compila el archivo .jar ejecutable para la aplicación Java Spring de ejemplo.

Si lo prefiere, puede utilizar Artifactory, si tiene una instancia de Artifactory propia.

Exploración de los conductos

Puede explorar los conductos para comprender el flujo de la cadena de herramientas y las distintas operaciones que se ejecutan dentro de cada conducto. La cadena de herramientas que acaba de crear contiene tres interconexiones:

• Interconexión de solicitud de extracción: se ejecuta cuando un desarrollador fusiona cambios de la rama de desarrollo con la rama maestra o con cualquier otra rama del repositorio. El conducto de la solicitud de extracción ejecuta la prueba unitaria y las exploraciones estáticas sobre el código fuente de la aplicación.
• Interconexión de integración continua: se ejecuta cuando se fusiona un cambio en la rama maestra del repositorio de código fuente de aplicación. La interconexión de integración continua ejecuta la prueba de unidad, la cobertura de código, las exploraciones estáticas en el código fuente de aplicación, la comprobación de CIS y la comprobación de la lista de materiales (BOM). La interconexión de entrega continua genera también los artefactos de compilación binarios y los carga en IBM Cloud® Kubernetes Service, tal y como se ha configurado en la cadena de herramientas. Además, la interconexión de integración continua genera los metadatos de los artefactos de compilación y los almacena en el repositorio de inventario.
• Interconexión de despliegue continuo: despliega artefactos de compilación en el entorno de despliegue. La interconexión verifica el despliegue correcto de la aplicación ejecutando la comprobación de estado. Una vez completada la interconexión de integración continua, debe activar de forma manual esta interconexión. En función de la estrategia de despliegue seleccionada, se añadirán más desencadenantes a la interconexión de entrega continua.

Ejecutar las interconexiones de integración continua y solicitud de extracción

Para iniciar la interconexión de solicitud de extracción, cree una solicitud de fusión en el repositorio de aplicaciones:

1. En la página Visión general de la cadena de herramientas, en la tarjeta Repositorios, pulse el repositorio de la aplicación compliance-app-<timestamp>.
2. Desde el repositorio maestro, cree una rama.
3. Actualice parte del código de la aplicación del nodo de ejemplo o el archivo readme y guarde los cambios.
4. Envíe la solicitud de fusión.
5. En la página Visión general de la cadena de herramientas, en la tarjeta Repositorios, pulse el repositorio de pr-pipeline para iniciar la interconexión de la solicitud de extracción. La solicitud de fusión correspondiente en el repositorio de aplicaciones permanece en estado pendiente hasta que todas las etapas de la interconexión de la solicitud de extracción se completan correctamente.
6. Si la ejecución de la interconexión de solicitud de extracción se realiza correctamente, puede seleccionarla para explorar los pasos completados.

Para iniciar la interconexión de integración continua, fusione la solicitud de fusión de integración continua en el repositorio de aplicaciones:

1. Vaya a la solicitud de fusión.
2. Fusione la solicitud para que los cambios se copien en la rama maestra del repositorio de aplicaciones. La interconexión de integración continua se desencadena automáticamente.
3. En la página Visión general de la cadena de herramientas de integración continua, en la tarjeta Repositorios, pulse el repositorio de ci-pipeline para iniciar la interconexión de integración continua.
4. Después de la correcta ejecución de la interconexión de integración continua, puede pulsar la ejecución de la interconexión para explorar los pasos completados.

{: caption="

Para evaluar si hay alguna anomalía en la ejecución de la interconexión, compruebe el paso final de la interconexión, que tiene un evaluador de interconexiones.

Explorar la interconexión de entrega continua

Las interconexiones de integración continua y solicitud de extracción son comunes en todas las estrategias de despliegue. Los cambios en la implementación y el diseño de la interconexión de entrega continua se basan en la estrategia de despliegue seleccionada previamente en esta guía de aprendizaje.

Esta guía de aprendizaje muestra cómo funciona la estrategia de despliegue azul-verde mediante la aplicación de ejemplo.