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 entrega continua para desplegar la imagen de Docker de la aplicación en el grupo de clústeres definido en Satellite.

1. Pulse Varios clústeres mediante Satellite para desplegar la aplicación utilizando Satellite.

   

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 cadena de herramientas proporciona una aplicación Hello Containers. 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.

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.

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.

{: caption="

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

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.

Puede iniciar una interconexión de entrega continua de cualquiera de las maneras siguientes:

• Desencadene manualmente la interconexión de entrega continua.
• Desencadene automáticamente la interconexión de entrega continua después de cada acción de Merge en el repositorio de inventario. Después de la fusión, debe desencadenar manualmente la ejecución de la interconexión de entrega continua.

Hay un desencadenante Git Repos and Issue Tracking configurado para desencadenar una interconexión de entrega continua automática, pero está inhabilitado de forma predeterminada. Cuando haya promocionado un cambio, podrá habilitar este desencadenante.