Configuración de Delivery Pipeline
Delivery Pipeline automatiza el despliegue continuado de los proyectos a través de secuencias de fases que recuperan entradas y ejecutan trabajos, como compilaciones, pruebas y despliegues.
Configure Delivery Pipeline para automatizar la creación, las pruebas y el despliegue automáticos de sus apps:
-
Si configura la integración de esta herramienta al crear la cadena de herramientas, en la sección Integraciones configurables, pulse Delivery Pipeline. En función de la plantilla que utilice, los campos disponibles serán distintos. Revise los valores del campo predeterminado y, si es necesario, realice cambios.
-
Si tienes una cadena de herramientas y vas a añadirle esta integración de herramientas, desde la consola ' IBM Cloud ', haz clic en el icono ' Menú ' '
> ' Automatización de plataformas > ' Cadenas de herramientas. En la página Cadenas de herramientas, pulse la cadena de herramientas a la que desea añadir Delivery Pipeline. Como alternativa, en la página Visión general de su app, en la tarjeta de Entrega continua, pulse Ver cadena de herramientas. A continuación, pulse Visión general.
a. Pulse Añadir herramienta.
b. En la sección Integraciones de herramientas, pulse Delivery Pipeline.
-
Especifique un nombre para el nuevo conducto.
-
Seleccione el tipo de conducto que desea crear:
- Clásico: Proporciona una interfaz gráfica de usuario fácil de usar para definir etapas y trabajos que se ejecutan en infraestructuras públicas compartidas, con soporte para ejecutar etapas individuales en trabajadores privados.
- Tekton: Proporciona un panel de control que el usuario puede utilizar para ver la salida del conducto Tekton que se ejecuta en un clúster definido de Kubernetes, con soporte para configurar repositorios de definiciones de conductos, desencadenantes de conductos, donde se ejecuta el conducto, y secretos simples.
-
Si planea utilizar su canalización para desplegar una interfaz de usuario, y su canalización es una canalización clásica, seleccione la casilla de verificación Mostrar aplicaciones en el menú Ver aplicación. Todas las apps creadas por el conducto se muestran en la lista Ver app de la página de visión general de la cadena de herramientas.
-
Pulse Crear integración para añadir el Delivery Pipeline a la cadena de herramientas.
-
En la cadena de herramientas, en la tarjeta Interconexiones de entrega, pulse la interconexión de entrega para verla y configurarla. Para obtener información básica sobre cómo configurar un conducto, consulte Creación y despliegue de conductos.
Si desea que el conducto se ejecute automáticamente cuando se envíe una confirmación a su repositorio GitHub o Git (repo), siga estos pasos:
a. Configure GitHub o Git Repos and Issue Tracking para la cadena de herramientas antes de definir las fases del conducto. Las etapas del conducto necesitan los URL Git para los repositorios. Cada fase de conducto puede hacer referencia a un único repositorio GitHub o Git que esté asociado con la cadena de herramientas. Para obtener instrucciones sobre cómo configurar GitHub, consulte la sección GitHub. Para obtener instrucciones sobre cómo configurar Git Repos and Issue Tracking, consulte la sección Git Repos and Issue Tracking.
b. Utilice un webhook. Sin un webhook, solo podrá ejecutar los conductos manualmente. Para utilizar un webhook cuando enlaza con un repositorio GitHub o GitHub Enterprise, necesita privilegios de administración. Para enlazar un repositorio de Git Repos and Issue Tracking, necesita privilegios de maestro o de propietario.
-
Opcional: si utiliza una cadena de herramientas en IBM Cloud Público y desea que Sauce Labs ejecute pruebas en la app, configure el Delivery Pipeline para añadir el trabajo de pruebas Sauce Labs. Para obtener instrucciones sobre cómo configurar el trabajo de pruebas, consulte Configuración de un trabajo de pruebas Sauce Labs en el conducto.
Configuración de un trabajo de pruebas Sauce Labs en el conducto
Antes de configurar un trabajo de pruebas Sauce Labs en el conducto, necesita un conducto funcional que incluya fases para crear y desplegar la app. También debe configurar Sauce Labs para la cadena de herramientas. Para obtener instrucciones sobre cómo configurar Sauce Labs, consulte la sección Sauce Labs.
Configure el Delivery Pipeline para añadir un trabajo de pruebas Sauce Labs:
-
Si no tiene ninguna etapa que despliegue una versión de pruebas de su app, cree una.
-
En la etapa, añada un trabajo de prueba después del trabajo de despliegue. Disponer de estos trabajos en la misma etapa permite que accedan al mismo conjunto de propiedades del entorno.
de -
Configurar la etapa. En el separador PROPIEDADES DE ENTORNO, cree la propiedad CF_APP_NAME.
El nombre de usuario y la clave de acceso de Sauce Labs están disponibles en el script del trabajo de prueba como variables de entorno SAUCE_USERNAME y SAUCE_ACCESS_KEY. Cuando escriba sus pruebas, debe utilizar estas variables de entorno para autenticarse con Sauce Labs.
-
Configure el trabajo de despliegue. En el campo Desplegar script, incluya este mandato:
export CF_APP_NAME="$CF_APP"
. Este mandato exporta el nombre de la app como propiedad del entorno. -
Configure el trabajo de prueba.
Los campos Instancia de servicio, Destino, Organización y Espacio se rellenan con el nombre de usuario, la región, la organización y el espacio de Sauce Labs que está utilizando.
a. Para el tipo de probador, seleccione Sauce Labs.
b. Para la instancia de servicio, seleccione el nombre de usuario de Sauce Labs que utilizó cuando configuró Sauce Labs para su cadena de herramientas.
Para ver el nombre de usuario y la clave de acceso que utilizó al configurar Sauce Labs para su cadena de herramientas, haga clic en Configurar.
c. En el campo Probar mandato de ejecución, especifique los mandatos que instalan las dependencias necesarias para las pruebas y, a continuación, ejecute las pruebas. Por ejemplo, para una app Node.js, puede introducir estos mandatos:
npm install node_modules/grunt-cli/bin/grunt test:sauce:parallel
d. Si desea ver los informes de las pruebas en los registros del trabajo de prueba, marque el recuadro de selección Habilitar informe de prueba y establezca el valor de Probar patrón de archivo de resultado en
test/*.xml
. -
Pulse Guardar. Siempre que se ejecute su conducto, se ejecutarán las pruebas de Sauce Labs.
Configuración de Delivery Pipeline mediante la API
La integración de herramientas de Delivery Pipeline da soporte a los siguientes parámetros de configuración que puede utilizar con la API HTTP de cadena de herramientas y SDK al crear, leery actualizar integraciones de herramientas.
Debe especificar la propiedad tool_type_id
en el cuerpo de la solicitud con el valor pipeline
.
Parámetro | Uso | Tipo | Argumento de Terraform | Descripción |
---|---|---|---|---|
nombre | opcional, actualizable | Serie | nombre | El nombre de esta integración de herramientas. |