如何用Bash优雅实现5分钟部署状态校验，超时后终止构建

需求说明 #

执行部署命令后需轮询校验服务部署状态：

• 状态为Pending时休眠30秒后重新拉取状态检查
• 直到状态变为Completed则判定部署成功
• 总超时阈值300秒，超时未完成则返回退出码1终止构建

原有代码问题 #

原有实现存在多处逻辑和语法错误，无法满足需求：

• 状态变量在循环外仅赋值一次，循环内不会拉取最新部署状态，判断逻辑完全失效
• 变量名拼写错误，service_ui_staus/service_db_staus的staus应为status
• DB服务状态赋值语法错误，多余的$(( ))算术运算包裹会导致执行报错
• 循环仅执行5次，总等待时长150秒，不满足300秒超时要求
• 缺少超时失败分支，超时后不会返回非0退出码终止流程
• if判断未闭合，缺少fi关键字，语法不合法

优化后通用实现 #

#!/bin/bash
# 可根据实际场景调整配置
readonly POLL_INTERVAL=30       # 轮询间隔（秒）
readonly TIMEOUT=300            # 总超时阈值（秒）
readonly MAX_RETRY=$((TIMEOUT / POLL_INTERVAL)) # 自动计算最大重试次数

# 封装服务状态检查逻辑，新增待校验服务只需修改此函数
check_deploy_ready() {
    # 每次执行都重新拉取最新状态
    local ui_status=$(command to check the deployment of UI service)
    local db_status=$(command to check the deployment of DB service)

    # 所有服务均为Completed状态则返回成功
    if [[ "${ui_status}" =~ "Completed" && "${db_status}" =~ "Completed" ]]; then
        return 0
    fi

    # 打印当前状态便于排查
    echo "Deployment in progress, current status: UI=${ui_status}, DB=${db_status}, will retry in ${POLL_INTERVAL}s"
    return 1
}

# 核心轮询逻辑
echo "Start verifying deployment status, timeout: ${TIMEOUT}s"
for ((i=1; i<=MAX_RETRY; i++)); do
    if check_deploy_ready; then
        echo "All services deployed successfully."
        exit 0
    fi
    # 未到最大重试次数则等待
    if [ $i -lt $MAX_RETRY ]; then
        sleep $POLL_INTERVAL
    fi
done

# 轮询结束仍未成功则判定超时失败
echo "ERROR: Deployment did not complete within ${TIMEOUT}s, build terminated."
exit 1

提示：如果服务状态返回值是纯Completed/Pending字符串（无多余前后缀），可将正则匹配=~替换为精确相等判断==，避免包含Completed关键词的异常状态被误判。

方案优势 #

• 配置与逻辑分离：轮询间隔、超时时间均抽为只读常量，调整参数无需修改核心逻辑
• 易扩展：状态检查逻辑独立封装，后续新增服务校验仅需修改检查函数，轮询逻辑可直接复用
• 鲁棒性强：自动根据配置计算重试次数，不存在手动写死循环次数导致的时长不匹配问题
• 可观测性好：每次重试打印当前服务状态，异常时可快速定位卡点
• 符合流水线规范：严格按照执行结果返回0/1退出码，可直接对接CI/CD构建流程

内容的提问来源于stack exchange，提问作者Chel MS