如何让Bitbucket Pipeline步骤等待直至满足指定条件？

你当前用固定sleep 5等待Docker容器启动的方式，确实会因为容器启动时长不稳定导致后续./bin/main执行失败，或是sleep时间过长浪费构建资源。完全可以用主动检查服务就绪状态的方式替代，以下是几种实用方案：

方案1：用curl循环检查服务可用性 #

如果你的容器服务通过HTTP/HTTPS暴露，直接用curl循环检测，直到服务能正常响应再继续：

- docker run -d --name my_container [...]
- |
  # 循环检查直到curl成功访问服务
  until curl -s -f http://localhost:4444 > /dev/null; do
    echo "等待容器服务就绪..."
    sleep 1
  done
- ./bin/main

• -s让curl静默输出，-f确保HTTP状态码≥400时返回非0退出码，更精准判断服务是否就绪
• 每次检查间隔1秒，避免不必要的等待

方案2：Docker健康检查配合docker wait #

给容器配置健康检查规则，用docker wait等待容器进入健康状态：

- docker run -d --name my_container \
    --health-cmd "curl -f http://localhost:4444 || exit 1" \
    --health-interval 1s \
    --health-timeout 5s \
    --health-retries 10 \
    [...]
# 等待容器变为健康状态
- docker wait my_container
- ./bin/main

• --health-cmd定义检查服务就绪的命令，这里用curl检测4444端口
• --health-interval每隔1秒检查一次，--health-retries最多重试10次（超时约10秒）
• docker wait会阻塞直到容器健康检查通过，无需手动写循环

方案3：用nc检查端口开放状态 #

如果只需要确认端口是否开放，用nc（netcat）写个简单的等待函数：

- docker run -d --name my_container [...]
- |
  # 定义等待端口就绪的函数
  wait_for_port() {
    local host=$1
    local port=$2
    local timeout=${3:-30}
    local start_time=$(date +%s)
    
    while ! nc -z "$host" "$port"; do
      local current_time=$(date +%s)
      # 超时则退出Pipeline
      if (( current_time - start_time > timeout )); then
        echo "错误：$host:$port 在$timeout秒内未就绪"
        exit 1
      fi
      echo "等待$host:$port 开放..."
      sleep 1
    done
  }
  
  # 等待localhost:4444，超时30秒
  wait_for_port localhost 4444 30
- ./bin/main

• nc -z只检查端口是否开放，不发送数据，适合不需要HTTP响应的场景
• 可自定义超时时间，避免无限等待

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