Jenkinsfile Parameters

Un Jenkinsfile se utiliza para definir el ciclo de vida de un proyecto en Jenkins. Esta herramienta es muy útil para automatizar tareas y acelerar el proceso de desarrollo. Un Jenkinsfile puede contener muchos parámetros para ajustar la ejecución del pipeline. En este artículo, exploraremos cómo utilizar los parámetros en un archivo Jenkinsfile.

Tipo de parámetros

Existen diferentes tipos de parámetros que se pueden utilizar en un archivo Jenkinsfile. Los más comunes son:

Booleano

Este parámetro se utiliza cuando necesitamos una respuesta verdadera o falsa, como una respuesta afirmativa o negativa a una pregunta. Ejemplo:

parameters {
booleanParam(name: 'deploy', defaultValue: false, description: 'Deploy to production?')
}

Cadena

Este parámetro se utiliza para ingresar texto. Ejemplo:

parameters {
string(name: 'branch', defaultValue: 'master', description: 'Branch to build?')
}

Número

Este parámetro se utiliza para ingresar un valor numérico. Ejemplo:

parameters {
number(name: 'buildNumber', defaultValue: 1, description: 'Build number?')
}

Lista

Este parámetro se utiliza para ingresar una lista de elementos. Ejemplo:

parameters {
choice(name: 'environment', choices: ['dev', 'qa', 'prod'], description: 'Environment to deploy to?')
}

Ejemplos de uso

A continuación, algunos ejemplos de cómo utilizar los parámetros en un Jenkinsfile:

Despliegue manual

En este ejemplo, se utilizará un parámetro booleano para permitir el despliegue manual a producción.

pipeline {
agent any
parameters {
booleanParam(name: 'deploy', defaultValue: false, description: 'Deploy to production?')
}
stages {
stage('Build') {
steps {
sh 'npm install'
}
}
stage('Deploy') {
when {
expression { params.deploy == true }
}
steps {
sh 'npm deploy'
}
}
}
}

Build condicional según la rama

En este ejemplo, se utilizará un parámetro de cadena para permitir la selección de una rama específica para construir.

pipeline {
agent any
parameters {
string(name: 'branch', defaultValue: 'master', description: 'Branch to build?')
}
stages {
stage('Build') {
when {
branch branch
}
steps {
sh 'npm install'
}
}
}
}

Conclusión

Los parámetros en un Jenkinsfile son una característica muy útil para personalizar el proceso de construcción y despliegue. Son muy fáciles de utilizar y permiten una mayor flexibilidad en la configuración del pipeline.

Preguntas frecuentes

¿Puedo utilizar múltiples parámetros en un Jenkinsfile?

Sí, puede utilizar varios tipos de parámetros en un Jenkinsfile.

¿Cómo puedo utilizar los parámetros para personalizar la ejecución del pipeline?

Los parámetros pueden ser utilizados en muchas maneras para personalizar la ejecución del pipeline. Se pueden utilizar para permitir la selección de ramas específicas, especificar opciones de construcción, o permitir la selección de entornos de implementación.

¿Puedo utilizar los parámetros en cualquier tipo de proyecto?

Sí, los parámetros se pueden utilizar en cualquier tipo de proyecto en Jenkins.

¿Cómo puedo agregar más parámetros a mi Jenkinsfile?

Puede agregar más parámetros a su Jenkinsfile simplemente agregando más secciones "parameters" y especificando el tipo de parámetro que desea agregar.
[nekopost slugs="prueba-a-jenkinsfile-localmente,ver-registros-de-jenkins,instalar-use-ssh-agent-jenkins-plugin,jenkinsfile-si-mas,jenkinsfile-ejecuta-script-shell,como-clonar-un-trabajo-de-jenkins,reiniciar-jenkins-linux,jenkins-changerequest,encuentra-mi-numero-de-construccion-de-jenkins"]