jenkins-job-dsl - 使用 Jenkins Job DSL 插件时如何使种子作业失败

Question

我正在使用 Jenkins Job DSL 插件并配置了一个参数化构建的种子作业。如果有人忘记填写所需参数之一，我希望构建失败。我的 DSL 脚本顶部有以下内容：

def expectedParams = [
  'BRANCH_NAME',
  'FALLBACK_BRANCH',
  'FOLDER_NAME',
  'FOLDER_DISPLAYNAME',
  'MAIL_TO'
];


boolean envChecksPass = true;
expectedParams.each {
  if (! binding.variables.get(it)?.trim()) {
      println "This script expects the $it environment variable to be set."
      envChecksPass = false;
  }
}

if (! envChecksPass) {
  // TODO: SET THE JOB STATUS TO FAILED
  return false;
}

如何完成 TODO 位？显然我可以在这里抛出一个异常，但它看起来有点难看。什么是首选/最佳实践方式。

Answer 1

抛出异常是目前的首选方式。如果你抛出一个javaposse.jobdsl.dsl.DslException堆栈跟踪将被抑制，并且只会显示消息。

Answer 2

另一种方法是使用非零代码退出，这会将作业结果标记为失败：

if (! envChecksPass) {
  // TODO: SET THE JOB STATUS TO FAILED
  exit 1;
}

Answer 3

在 Jenkins 管道中，最好使用“错误”步骤

if (! binding.variables.get(it)?.trim()) {
    error "This script expects the $it environment variable to be set."
}

您将在日志中看到以下输出（没有堆栈空间）

ERROR: This script expects the USER environment variable to be set.
Finished: FAILURE