Comment ajouter une étape de délai d'expiration au pipeline Jenkins

Lorsque vous utilisez un projet de style libre, vous pouvez définir qu'après 20 minutes, la génération est abandonnée si elle n'est pas terminée. Comment est-ce possible avec un projet de pipeline Jenkins Multi Branch?

Vous pouvez utiliser l' étape de temporisation :

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

Si vous avez besoin d'un autre TimeUnitque MINUTES , vous pouvez fournir l' unitargument:

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

EDIT août 2018: De nos jours, avec les pipelines déclaratifs les plus courants (facilement reconnus par la pipelineconstruction de niveau supérieur ), les délais d'expiration peuvent également être spécifiés à optionsdifférents niveaux (par pipeline global ou par étape):

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

Néanmoins, si vous souhaitez appliquer un délai d'expiration à une seule étape d'un pipeline déclaratif, il peut être utilisé comme décrit ci-dessus.

Pour un pipeline déclaratif, il est conseillé d'utiliser l' étape de temporisation dans la section des options .

Exécute le code à l'intérieur du bloc avec un délai d'expiration déterminé. Si la limite de temps est atteinte, une exception (org.jenkinsci.plugins.workflow.steps.FlowInterruptedException) est levée, ce qui conduit à abandonner la construction (sauf si elle est interceptée et traitée d'une manière ou d'une autre). L'unité est facultative mais prend par défaut les minutes.

Le délai d'expiration a 3 paramètres que vous pouvez configurer:

• time (obligatoire, int)

  • La durée du délai d'attente, si aucune unité n'est indiquée, durée en minutes

• activité (facultatif, booléen)

  • Délai d'expiration après aucune activité dans les journaux pour ce bloc au lieu de la durée absolue.

• unité (facultatif, valeurs: NANOSECONDS, MICROSECONDS, MILLISECONDS, SECONDS, MINUTES, HOURS, DAYS)

  • L'unité pour l' heure , par défaut est MINUTES

Exemples:

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 documentation officielle de Jenkins a un très bel exemple d'utilisation d'un timeout:

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