如何让Jenkins流水线在外部进程（如CloudFormation部署）失败时终止并标记失败？

核心问题原因 #

你用try {} catch (err) {}捕获了CloudFormation部署的错误，但没有在catch块里主动触发流水线失败，所以Jenkins会认为这个异常已经被处理，继续执行后续步骤。

具体解决方案 #

• 在catch块中主动终止流水线
  捕获到部署失败的异常后，调用Jenkins内置的error函数，这个函数会直接终止后续所有阶段，并把构建标记为失败。示例代码如下：

  try {
      // 执行CloudFormation部署命令
      sh 'aws cloudformation deploy --template-file your-template.yaml --stack-name target-stack'
  } catch (err) {
      echo "部署失败详情: ${err.getMessage()}"
      // 触发流水线失败
      error "CloudFormation堆栈部署失败，终止流水线执行"
  }
  

• 按需缩小catch范围
  如果你的try块只处理CloudFormation部署这一关键操作，完全可以去掉try/catch，让部署失败的异常直接向上抛出——Jenkins默认会识别这种未捕获的异常，自动终止流水线并标记失败。示例：

  // 直接执行部署，失败时Jenkins自动终止流水线
  sh 'aws cloudformation deploy --template-file your-template.yaml --stack-name target-stack'
  

  要是你需要捕获其他非致命异常，可以调整catch的逻辑，只捕获那些不影响流水线继续执行的错误，让CloudFormation的失败异常直接抛出。

• 通过命令退出码判断并终止
  如果你用sh步骤执行AWS命令时加了returnStatus: true参数（这种情况sh步骤不会自动抛出错误），可以手动检查命令的退出码，非0时主动触发失败：

  def deployExitCode = sh script: 'aws cloudformation deploy --template-file your-template.yaml --stack-name target-stack', returnStatus: true
  if (deployExitCode != 0) {
      error "CloudFormation部署失败，命令退出码: ${deployExitCode}"
  }
  

可行性结论 #

完全可行。Jenkins提供了明确的机制来控制流水线的失败状态，只要在检测到外部进程（比如CloudFormation部署）失败时，主动触发失败信号，就能让流水线立即停止后续执行，并将构建标记为失败。

内容的提问来源于stack exchange，提问作者pragmatic learner