Octopus Deploy未等待CloudFormation堆栈完成问题求助

我之前也碰到过类似的头疼问题——明明勾选了「Wait for completion」，但Octopus还是跳去执行下一步，导致后续步骤拿不到堆栈输出变量。下面是我试过的几个有效解决办法，你可以逐一排查：

• 仔细核对CloudFormation步骤的等待配置细节
  光勾选等待选项还不够，得确认你是否指定了正确的终端状态。默认情况下Octopus会等待CREATE_COMPLETE、UPDATE_COMPLETE这类状态，但如果你的堆栈涉及资源替换、回滚操作，可能需要把UPDATE_ROLLBACK_COMPLETE这类特殊状态也加入等待判断。另外检查步骤里的超时时间设置，如果超时值比堆栈实际部署时长短，Octopus会强行终止等待继续执行，建议根据堆栈部署的平均时长适当调大超时。

• 验证Octopus使用的IAM权限是否充足
  Octopus用来执行CloudFormation操作的服务角色，必须有cloudformation:DescribeStacks权限——这是它轮询堆栈状态的核心权限。如果权限不足，Octopus无法获取到堆栈的实时状态更新，可能会误以为堆栈已经完成，直接跳去下一步。

• 检查CloudFormation堆栈的实际运行状态
  先登录AWS控制台看看你的堆栈是不是卡在了非预期状态，比如CREATE_IN_PROGRESS长时间没推进，或者进入了ROLLBACK_IN_PROGRESS。这种情况下，Octopus的等待逻辑会因为堆栈一直没进入预设的终端状态，超时后就直接继续执行后续步骤了。先解决堆栈本身的部署问题，再验证Octopus的等待是否正常。

• 用自定义脚本强制等待堆栈完成
  如果上面的方法都没效果，可以在CloudFormation步骤之后加一个「Run a script」步骤，用AWS CLI轮询堆栈状态，直到它进入终端状态再继续。比如这个脚本：

  STACK_NAME="your-target-stack-name"
  # 定义你认为完成的状态，可根据需求调整
  DESIRED_STATES="CREATE_COMPLETE UPDATE_COMPLETE"
  
  while true; do
      STACK_STATUS=$(aws cloudformation describe-stacks --stack-name $STACK_NAME --query "Stacks[0].StackStatus" --output text)
      if [[ $DESIRED_STATES =~ $STACK_STATUS ]]; then
          echo "堆栈 $STACK_NAME 已进入 $STACK_STATUS 状态，继续执行下一步..."
          exit 0
      elif [[ $STACK_STATUS == *FAILED* || $STACK_STATUS == *ROLLBACK_COMPLETE* ]]; then
          echo "堆栈 $STACK_NAME 部署失败，状态为 $STACK_STATUS，终止执行..."
          exit 1
      fi
      echo "堆栈 $STACK_NAME 当前状态为 $STACK_STATUS，等待30秒后再次检查..."
      sleep 30
  done
  

  这个脚本能确保只有当堆栈确实完成（或明确失败）时，才会执行后续步骤，同时能保证堆栈变量已经生成。

• 查看Octopus任务日志找线索
  去Octopus的任务日志里搜索「CloudFormation」相关条目，看看有没有类似「Failed to poll stack status」或者「Timeout waiting for stack to complete」的警告/错误信息。这些日志能帮你快速定位是权限问题、超时设置问题，还是堆栈本身的部署异常。

内容的提问来源于stack exchange，提问作者Issa Dawaji