A maneira mais limpa de sair prematuramente de um trabalho no Jenkins Pipeline como um sucesso?

Eu tenho um trabalho que criará arquivos, a menos que um dos valores que está sendo alimentado corresponda a um valor mais antigo. Qual é a maneira mais limpa em Jenkins de abortar ou sair do trabalho, sem que seja FAILED? A saída é o comportamento correto, por isso quero que a compilação seja marcada SUCCESS.

Terminará em uma declaração if;

stage ('Check value') {

     if( $VALUE1 == $VALUE2 ) {
       //if they do match exit as a success, else continue with the rest of the job 
    }

}

Eu não quero lançar um código de erro, a menos que isso possa de alguma forma se traduzir para ser marcado como uma compilação bem-sucedida.

Descobri isso. Fora de qualquer estágio (caso contrário, isso acabará com o estágio específico como um sucesso), faça o seguinte;

if( $VALUE1 == $VALUE2 ) {
   currentBuild.result = 'SUCCESS'
   return
}

return interromperá o estágio ou o nó em que você está executando, e é por isso que é importante executá-lo fora de um estágio, enquanto a definição de currentBuild.resultimpede que ele falhe.

Você também pode usar error para sair do estágio atual e não precisar considerar a hierarquia do estágio atual e coisas semelhantes:

def autoCancelled = false

try {
  stage('checkout') {
    ...
    if (your condition) {
      autoCancelled = true
      error('Aborting the build.')
    }
  }
} catch (e) {
  if (autoCancelled) {
    currentBuild.result = 'SUCCESS'
    // return here instead of throwing error to keep the build "green"
    return
  }
  // normal error handling
  throw e
}

Mas isso levaria a um estágio vermelho, se o erro ocorrer dentro de um estágio.

Depende dos seus requisitos, de que maneira você deseja usar.

Honestamente, você não precisa usar o comando exit especificamente, mas há um plug-in BuildStep condicional que pode alcançar o mesmo resultado final (código que não é executado).

Ainda não me deparei com isso, então não usei o plugin.

Também existem condicionais, conforme encontrado nesta publicação anterior do Stack Overflow no Jenkins: Etapa / estágio condicional do pipeline do Jenkins

O Executor.interrupt(Result)método é a maneira mais direta e limpa de interromper uma construção prematuramente e marcá-la como um sucesso.

script {
    currentBuild.getRawBuild().getExecutor().interrupt(Result.SUCCESS)
}

Prós :

• Funciona em um pipeline declarativo tão bem quanto em um script.
• Nenhuma tentativa / captura ou exceções para lidar.
• Marca o estágio de chamada e todos os estágios sucessivos como verde / passando na interface do usuário.

Contras :

• Requer várias aprovações de script em processo, incluindo uma que é considerada insegura . Aprovar e usar com cuidado.