AWS CodeBuild中docker-compose服务无法跨实例连接问题求助

问题根因 #

• depends_on 仅保证容器启动顺序，不会等待容器内的应用服务完全就绪，你在启动main、webserver容器后立刻执行Cypress测试，此时webserver和main的内部服务还没完成启动，自然无法访问。
• 你执行curl 127.0.0.1的时机过早，服务未就绪就检测自然返回Failed to connect to 127.0.0.1 port 80: Connection refused。
• 需确认ENVIRONMENT等环境变量是否正确传入CodeBuild，避免镜像拉取失败导致容器未正常运行。

解决步骤 #

1. 添加服务就绪检测逻辑
   在buildspec的build阶段，启动main、webserver容器后增加等待检测逻辑，确认服务可用后再运行Cypress：

build:
  commands:
    - echo Test Execution starting...
    - docker-compose --file=deployment/docker.yml up -d main webserver
    # 新增：循环检测webserver服务是否就绪，最多等待30秒
    - |
      for i in {1..15}; do
        if curl -s http://127.0.0.1:80 > /dev/null; then
          echo "webserver服务已就绪"
          break
        fi
        echo "等待webserver启动，第$i次重试..."
        sleep 2
      done
    - docker-compose --file=deployment/docker.yml run cypress

2. 排查容器运行状态
   如果添加等待后仍无法访问，在buildspec中加入调试命令排查容器状态：

# 查看所有容器运行状态
- docker ps -a
# 查看webserver容器日志，确认是否有启动报错、是否正常监听80端口
- docker logs webserver
# 进入cypress容器手动测试网络连通性
- docker-compose --file=deployment/docker.yml run --entrypoint "curl http://webserver:80" cypress

3. 校验环境变量配置
   确认CodeBuild项目的环境变量中已配置ENVIRONMENT参数，否则docker-compose拉取镜像时会因为变量缺失拉取失败，导致容器无法正常启动。
4. 可选优化
   在cypress服务的docker-compose配置中增加--rm参数，测试完成后自动清理容器，避免资源残留：

docker-compose --file=deployment/docker.yml run --rm cypress

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