Como adicionar uma etapa de tempo limite ao Jenkins Pipeline

Quando você está usando um projeto de estilo livre, você pode definir que após 20 minutos a construção seja abortada se não for concluída. Como isso é possível com um projeto Jenkins Multi Branch Pipeline?

Você pode usar a etapa de tempo limite :

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

Se precisar de um diferente TimeUnitde MINUTES , você pode fornecer o unitargumento:

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

EDITAR agosto de 2018: Hoje em dia, com os pipelines declarativos mais comuns (facilmente reconhecidos pela pipelineconstrução de nível superior ), os tempos limites também podem ser especificados usando optionsem diferentes níveis (por pipeline geral ou por estágio):

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

Ainda assim, se você deseja aplicar um tempo limite a uma única etapa em um pipeline declarativo, ele pode ser usado conforme descrito acima.

Para um Pipeline Declarativo , é aconselhável usar a etapa de tempo limite na seção de opções .

Executa o código dentro do bloco com um determinado limite de tempo. Se o limite de tempo for atingido, uma exceção (org.jenkinsci.plugins.workflow.steps.FlowInterruptedException) é lançada, o que leva ao aborto da compilação (a menos que seja capturado e processado de alguma forma). A unidade é opcional, mas o padrão é minutos.

A etapa de tempo limite tem 3 parâmetros que você pode configurar:

• tempo (obrigatório, interno)

  • A quantidade de tempo limite, se nenhuma unidade tiver duração declarada em minutos

• atividade (opcional, booleano)

  • Tempo limite após nenhuma atividade em logs para este bloco em vez de duração absoluta.

• unidade (opcional, valores: NANOSSEGUNDOS, MICROSECONDOS, MILISSEGUNDOS, SEGUNDOS, MINUTOS, HORAS, DIAS)

  • A unidade para o tempo , o padrão é MINUTOS

Exemplos:

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')

A documentação oficial do Jenkins tem um exemplo muito bom para o uso de um tempo limite:

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