Parámetro de elección de Jenkinsfile

En Jenkins, el "parámetro de elección" es un parámetro que le permite seleccionar un valor único de una lista predefinida de valores. Esto puede ser útil cuando desea permitir a los usuarios seleccionar entre una lista de opciones al construir un trabajo de Jenkins: seleccionar una versión específica de un componente de software para construir o probar.

Esta publicación le enseñará cómo crear un parámetro de elección dentro de un trabajo de Jenkins.

Jenkins crea el parámetro de elección

Para crear un parámetro de elección en Jenkins, siga estos pasos:

Comience iniciando sesión en el tablero de Jenkins.

Haga clic en la opción de nuevo elemento para crear un nuevo trabajo de Jenkins.

A continuación, proporcione un nombre para su trabajo y seleccione el tipo de trabajo como "tubería."

Desplácese hacia abajo hasta la sección "Pipelina" y seleccione la definición "Sintaxis de la tubería" desde el menú desplegable.

Para agregar un parámetro de elección, seleccione el enlace "Sintaxis de la tubería" para abrir el generador de tuberías.

Seleccione el "Generador de Directivas Declarativas" en el menú izquierdo.

Seleccione "Parámetros: Parámetros" de las opciones proporcionadas en la opción Directiva de muestra.

Haga clic en la opción "Agregar" para crear un nuevo tipo de parámetro. Elija el tipo de parámetro como elección.

Darle un nombre al parámetro y proporcionar varias opciones para seleccionar los valores. Una vez que esté satisfecho con la opción, seleccione Generar la sintaxis para generar la sintaxis de la tubería de destino.

Esto debería darle una muestra de tuberías válida para agregar a su código. Por ejemplo:

parámetros
Opciones de elección: ['Debian_amd64', 'Ubuntu_amd64', 'Centos_amd64'], Descripción: 'Elija su distribución favorita', Nombre: 'Dist'

Una vez satisfecho, podemos copiar el código y pegarlo en la sección de tuberías de nuestra tubería. Un ejemplo de script completo es como se muestra:

tubería
agente cualquiera
parámetros
Opciones de elección: ['Debian_amd64', 'Ubuntu_amd64', 'Centos_amd64'], Descripción: 'Elija su distribución favorita', Nombre: 'Dist'

etapas
etapa ('construir')
pasos
Echo "edificio para distribución: $ params.dist "

Esta tubería define una sola etapa llamada "Build", que contiene un solo paso que imprime un mensaje en la consola que indica el valor del parámetro DIST.

Cuando ejecutemos esta tubería, se nos presentará una lista desplegable que contenga los valores debian_amd64, ubuntu_amd64 y centos_amd64. Luego seleccionamos uno de estos valores y luego ejecutamos la tubería.

Conclusión

En esto, aprendió cómo usar el generador declarativo Jenkins y el bloque de parámetros Jenkins para crear un parámetro a partir de una lista de valores.

Desplácese hacia abajo a la sección "Acciones posteriores a la construcción" y haga clic en el menú desplegable "Agregar acción posterior a la construcción". Seleccione "Construir otros proyectos" de las opciones.

1. En el campo "Proyectos para construir", ingrese el nombre del trabajo que desea activar.
2. Desplácese hacia abajo a la sección "Parámetros" y haga clic en el menú desplegable "Agregar parámetro". Seleccione "Parámetro de elección" de las opciones.
3. Ingrese un nombre para su parámetro (E.gramo. "My_choice") y una descripción (opcional).
4. En el campo "Opciones", ingrese la lista de valores que desea estar disponible para la selección. Cada valor debe estar en una nueva línea.
5. Haga clic en el botón "Guardar" para guardar su trabajo.

Cuando crea el trabajo, se le presentará una lista desplegable que contiene los valores que especificó. Puede seleccionar uno de los valores y luego construir el trabajo. El valor que seleccionó se pasará al comando que ingresó en el campo "Comando", y se puede usar en su script de compilación.