Comment ajouter une étape de délai d'attente à Jenkins Pipeline

Question

Lorsque vous utilisez un projet de style libre, vous pouvez faire en sorte que la construction soit interrompue après 20 minutes si elle n'est pas terminée. Comment cela est-il possible avec un projet pipeline multi-branches de Jenkins ?

Answer 1

Vous pouvez utiliser le délai d'attente étape :

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

Si vous avez besoin d'un autre TimeUnit que MINUTES vous pouvez fournir le unit argument :

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

EDIT Août 2018 : De nos jours, avec le plus commun pipelines déclaratifs (facilement reconnaissable par le niveau supérieur pipeline ), les délais d'attente peuvent également être spécifiés à l'aide de la fonction options à diffé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'attente à une seule étape d'un pipeline déclaratif, vous pouvez l'utiliser comme décrit ci-dessus.

Answer 2

Pour un Pipeline déclaratif il est conseillé d'utiliser le étape de temporisation dans le options-section .

Exécute le code à l'intérieur du bloc avec une limite de temps déterminée. Si la limite de temps est atteinte, une exception d'exception (org.jenkinsci.plugins.workflow.steps.FlowInterruptedException). exception (org. jenkinsci.plugins.workflow.steps.FlowInterruptedException) est levée, ce qui entraîne l'abandon de la construction (à moins qu'elle ne soit capturée et traitée d'une manière ou d'une autre). L'unité est facultative mais la valeur par défaut est minutes.

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

• temps (obligatoire, int)

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

• actividad (facultatif, booléen)

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

• unité (facultatif, valeurs : NANOSECONDES, MICROSECONDES, MILLISECONDES, SECONDES, MINUTES, HEURES, JOURS)

  • L'unité pour le temps par défaut 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')

El la documentation officielle de Jenkins propose un très bel exemple d'utilisation d'un délai d'attente :

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

Answer 3

Dans un pipeline déclaratif, vous pouvez utiliser :

pipeline {
    agent any
    stages {
        stage('Deploy') {
            steps {
                retry(3) {
                    sh './flakey-deploy.sh'
                }

                timeout(time: 3, unit: 'MINUTES') {
                    sh './health-check.sh'
                }
            }
        }
    }
}