GitLab CI与Docker：等待docker-compose up执行完成的技术问询

我之前在Symfony项目的GitLab CI流水线里也踩过固定sleep的坑——要么等太久浪费CI时间，要么容器没完全就绪就执行命令导致构建失败。这里有几个靠谱的替代方案，亲测有效：

1. 利用Docker健康检查+docker-compose wait #

这是最优雅的方案，让Docker自己监控服务状态，直到所有服务真正就绪再继续。

首先在你的docker-compose.yml中给需要等待的服务（比如MySQL、PHP）添加健康检查配置：

services:
  mysql:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
      MYSQL_DATABASE: ${MYSQL_DATABASE}
    healthcheck:
      # 用mysqladmin ping检测MySQL是否就绪
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "-p${MYSQL_ROOT_PASSWORD}"]
      interval: 5s  # 每5秒检测一次
      timeout: 5s   # 检测超时时间
      retries: 5    # 最多重试5次，还是失败就标记为不健康
  php:
    build: ./php
    healthcheck:
      # 检测PHP-FPM是否正常运行（如果用的是FPM）
      test: ["CMD", "nc", "-z", "localhost", "9000"]
      interval: 3s
      timeout: 3s
      retries: 3

然后修改你的.gitlab-ci.yml，把sleep 15替换成docker-compose wait：

setup:
  stage: setup
  before_script:
    - docker-compose up -d
  script:
    # 等待所有服务通过健康检查
    - docker-compose wait
    - docker-compose exec -T php php bin/console doctrine:schema:create
  after_script:
    - docker-compose down

docker-compose wait会阻塞直到所有服务的健康检查都通过，完全不需要固定等待时长。

2. 自定义Bash循环检测服务状态 #

如果不想修改docker-compose配置，可以在CI脚本里写一个简单的循环，手动检测服务是否就绪。比如针对MySQL：

setup:
  stage: setup
  before_script:
    - docker-compose up -d
  script:
    - |
      # 循环检测MySQL是否能成功连接
      MAX_WAIT=30
      WAIT_COUNT=0
      until docker-compose exec -T mysql mysql -u${MYSQL_USER} -p${MYSQL_PASSWORD} -D${MYSQL_DATABASE} -e "SELECT 1" > /dev/null 2>&1; do
        if [ $WAIT_COUNT -ge $MAX_WAIT ]; then
          echo "MySQL timed out after $MAX_WAIT seconds"
          exit 1
        fi
        echo "Waiting for MySQL to be ready... ($((WAIT_COUNT+=2))s elapsed)"
        sleep 2
      done
    - docker-compose exec -T php php bin/console doctrine:schema:create
  after_script:
    - docker-compose down

这个脚本会每隔2秒尝试连接MySQL，最多等30秒，超时就直接失败，避免无限等待。

3. 额外优化建议 #

• 对于Symfony的Doctrine命令，建议先执行doctrine:database:create --if-not-exists，确保数据库存在后再创建表结构：

  docker-compose exec -T php php bin/console doctrine:database:create --if-not-exists
  docker-compose exec -T php php bin/console doctrine:schema:create
  

• 确保GitLab CI的环境变量（比如MYSQL_ROOT_PASSWORD、MYSQL_USER）已经正确配置，可以在项目的Settings > CI/CD > Variables里添加。

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