Jenkinsfile When Expression

En un proyecto en Jenkins, hay varios momentos en los que es necesario ejercer un mayor control sobre el proceso de construcción, testeo y entrega. Esto se logra mediante el uso de los Jenkinsfiles, que permiten definir los pasos que se deben realizar en cada uno de estos momentos. En este artículo, nos enfocaremos en el uso de la expresión 'when' dentro del Jenkinsfile, la cual nos permite especificar condiciones para ejecutar una etapa determinada.

¿Qué es la expresión 'when' en un Jenkinsfile?

La expresión 'when' en un Jenkinsfile es una herramienta poderosa que nos permite controlar cuándo se ejecutará una etapa específica del pipeline. Esto se logra definiendo una o más condiciones que, si se cumplen, indican que la etapa en cuestión debe ejecutarse.

Sintaxis de la expresión 'when'

La sintaxis de la expresión 'when' es la siguiente:


when {
condition1
condition2
condition3
}


En este caso, 'condition1', 'condition2' y 'condition3' pueden ser cualquier expresión booleana que se evalúe en true o false. La etapa solo se ejecutará si todas las condiciones se cumplen.

Ejemplo de uso de la expresión 'when'

Un ejemplo común del uso de 'when' es cuando queremos ejecutar una etapa solo cuando se cambió el código fuente que está siendo construido. En este caso, la condición podría ser:


when {
changeset ".*/*.{java,xml}"
}


Esta condición le dice a Jenkins que solo ejecute la etapa si se produjo un cambio en uno o más archivos con la extensión .java o .xml.

Conclusión

La expresión 'when' en un Jenkinsfile es una herramienta útil que nos permite controlar cuándo se ejecuta cada etapa del pipeline. Al usarla correctamente, podemos mejorar la eficiencia de nuestro proceso de construcción, certificación y entrega.

Preguntas frecuentes

¿Cómo sé qué condiciones puedo usar en la expresión 'when'?

Puedes consultar la documentación oficial de Jenkins, que describe todas las expresiones disponibles para la expresión 'when'.

¿Puedo usar más de una condición en una sola etapa?

Sí, puedes definir varias condiciones dentro de una sola etapa. En este caso, todas las condiciones deben cumplirse para que se ejecute la etapa.

¿Qué puedo hacer si ninguna de las condiciones que necesito está disponible?

Si no encuentras una condición que se adapte a tus necesidades, puedes definir una expresión personalizada utilizando la expresión 'expression', que te permite utilizar Groovy para definir la condición que requieres.

¿Dónde puedo encontrar ejemplos de código que muestren el uso de la expresión 'when'?

Puedes encontrar una variedad de ejemplos y tutoriales en línea. Además, puedes explorar la documentación oficial de Jenkins para ver algunos ejemplos de uso de la expresión 'when' en diferentes situaciones.

Ejemplos de código

Aquí hay un ejemplo de cómo usar la expresión 'when' para ejecutar una etapa solo cuando se cambia el código fuente en los archivos con extensión .java o .xml:


stage('Build'){
when {
changeset ".*/*.{java,xml}"
}
steps{
// Aquí irían las instrucciones para construir el proyecto
}
}

[nekopost slugs="instalar-use-ssh-agent-jenkins-plugin,jenkins-changerequest,como-clonar-un-trabajo-de-jenkins,reiniciar-jenkins-linux,prueba-a-jenkinsfile-localmente,jenkinsfile-si-mas,encuentra-mi-numero-de-construccion-de-jenkins,parametros-de-jenkinsfile,definir-variables-jenkinsfile"]