Cómo agregar un paso de tiempo de espera a Jenkins Pipeline

Cuando está utilizando un proyecto de estilo libre, puede configurar que después de 20 minutos la compilación se cancele si no se concluye. ¿Cómo es esto posible con un proyecto de canalización de múltiples ramas de Jenkins?

Puede utilizar el paso de tiempo de espera :

timeout(20) {
  node {
    sh 'foo'
  }
}

Si necesita un valor diferente TimeUnita MINUTES , puede proporcionar el unitargumento:

timeout(time: 20, unit: 'SECONDS') {

EDITAR agosto de 2018: hoy en día, con las canalizaciones declarativas más comunes (reconocidas fácilmente por la pipelineconstrucción de nivel superior ), los tiempos de espera también se pueden especificar usando optionsen diferentes niveles (por canalización general o por etapa):

pipeline {
  options {
      timeout(time: 1, unit: 'HOURS') 
  }
  stages { .. }
  // ..
}

Aún así, si desea aplicar un tiempo de espera a un solo paso en una canalización declarativa, se puede usar como se describe anteriormente.

Para una canalización declarativa , se recomienda utilizar el paso de tiempo de espera en la sección de opciones .

Ejecuta el código dentro del bloque con un límite de tiempo de espera determinado. Si se alcanza el límite de tiempo, se lanza una excepción (org.jenkinsci.plugins.workflow.steps.FlowInterruptedException), lo que lleva a abortar la compilación (a menos que se detecte y procese de alguna manera). La unidad es opcional pero el valor predeterminado es minutos.

El paso de tiempo de espera tiene 3 parámetros que puede configurar:

• time (obligatorio, int)

  • La cantidad del tiempo de espera, si no se indica una unidad, duración en minutos

• actividad (opcional, booleano)

  • Tiempo de espera después de que no haya actividad en los registros de este bloque en lugar de la duración absoluta.

• unidad (opcional, valores: NANOSECONDS, MICROSECONDS, MILISECONDS, SECONDS, MINUTES, HOURS, DAYS)

  • La unidad para el tiempo , por defecto es MINUTOS

Ejemplos:

timeout(time: 10) // would lead to a timeout of 10 minutes (MINUTES is default value)
timeout(time: 10, unit: 'SECONDS') // a 10 seconds timeout
timeout(time: 10, activity: false, unit: 'MILLISECONDS')

La documentación oficial de Jenkins tiene un ejemplo muy bueno para el uso de un tiempo de espera:

pipeline {
    agent any
    options {
        timeout(time: 1, unit: 'HOURS') 
    }
    stages {
        stage('Example') {
            steps {
                echo 'Hello World'
            }
        }
    }
}