Creando etapas de Jenkins

Una etapa de Jenkins se refiere a una fase en una tubería de Jenkins. Las etapas nos permiten agrupar una serie de tareas en una sola entidad y hacer referencia a ellas bajo un identificador único. Usando las etapas de Jenkins, podemos visualizar y rastrear el progreso de la construcción de la tubería utilizando el identificador especificado. También puede ayudarnos a rastrear los errores en los registros.

Por ejemplo, podemos tener una tubería con tres etapas: construir, probar e implementar. Cada etapa contiene una o más tareas necesarias para completar las tareas establecidas. Por ejemplo, en la etapa de compilación, podemos tener tareas como instalar las dependencias necesarias, configurar los directorios, etc.

En la etapa de prueba, podemos ejecutar las pruebas necesarias para ese proyecto y publicar los resultados de las pruebas utilizando herramientas como informes HTML, pepino, etc.

Finalmente, en la etapa de implementación, podemos tener las tareas, como iniciar sesión en un servidor remoto, ejecutar un script de configuración y otros pasos.

Cuando ejecutamos la tubería, Jenkins ejecuta las tareas en cada etapa en el orden en que se definen para completar. Si uno de los pasos en una etapa determinada falla, toda la construcción falla y no se ejecutan otras etapas.

Bloque de escenario de Jenkins

En un jenkinsfile, podemos definir las etapas utilizando las etapas y el bloqueo de la etapa. El bloque de etapas nos permite decirle a Jenkins que los próximos bloques contienen las etapas que deseamos ejecutar en la compilación.

Luego usamos el bloque de etapas para definir un conjunto distinto de tareas que se ejecutan en la tubería.

Una sintaxis de ejemplo es la siguiente:

tubería
agente cualquiera
etapas
etapa ('construir')
pasos
// tareas para ejecutar va aquí


etapa ('test')
pasos
// Tareas de prueba


etapa ('implement')
pasos
// tareas de implementación

Cada etapa debe contener uno o más pasos que son las tareas individuales que se ejecutan en el contexto de la etapa. Por ejemplo, puede definir los pasos utilizando una de las funciones de paso disponibles, como SH, para ejecutar un comando shell, un script groovy o git para ejecutar un comando git.

Puede consultar el soporte de documentación y complemento para conocer las capacidades de Jenkins.

Ejemplo:

El siguiente ejemplo muestra una tubería simple con una sola etapa:

tubería
agente cualquiera
etapas
etapa ('versión')
pasos
guion
Def Jenkinsversion = Hudson.modelo.Hudson.instancia.versión
println "Versión de Jenkins: $ JenkinsVersion"

La tubería anterior define una sola etapa llamada "Versión" que contiene un solo paso que ejecuta un guión Groovy. El script usa el Hudson.modelo.Clase Hudson para obtener la versión de Jenkins e imprimirla usando la función println.

Una vez que ejecutamos la tubería anterior, deberíamos ver la versión de Jenkins instalada en la salida de la consola.

Conclusión

Esta publicación cubre cómo crear y usar las etapas en una tubería de Jenkins. Las etapas nos permiten agrupar las tareas bajo una sola entidad para una gestión y seguimiento más fáciles.