GitLab流水线中Apache服务启动问题：替代硬编码sleep的方案

问题根源 #

你当前的问题在于：容器启动时需要先完成composer install、yarn install等初始化操作，之后才会启动Apache服务。硬编码sleep 60的方式要么浪费时间（服务提前就绪），要么仍会失败（初始化耗时超过60秒）。而你配置的HEALTHCHECK未生效，是因为Docker的健康检查仅由守护进程监控，GitLab流水线脚本不会自动等待容器进入健康状态，需要主动查询状态并等待。

可行解决方案 #

方案一：基于Docker HEALTHCHECK的状态等待 #

利用你已经配置的HEALTHCHECK，在流水线脚本中循环查询容器的健康状态，直到其变为healthy或超时。这种方式符合容器化最佳实践，且能准确判断服务是否就绪。

修改后的流水线脚本：

test_job:
  stage: test
  image: docker:20.10.16
  services:
    - docker:20.10.16-dind
  tags:
    - shell
  script:
    - docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY
    - docker run -d -p 80:80 --env APP_ENV=$APP_ENV --env APP_DEBUG=$APP_DEBUG --name $CONTAINER_NAME $CONTAINER_IMAGE_NAME
    # 循环等待容器进入健康状态，最多等待120秒，每10秒检查一次
    - |
      MAX_WAIT=120
      WAIT_INTERVAL=10
      elapsed=0
      while [ $elapsed -lt $MAX_WAIT ]; do
        HEALTH_STATUS=$(docker inspect --format='{{.State.Health.Status}}' $CONTAINER_NAME)
        if [ "$HEALTH_STATUS" = "healthy" ]; then
          echo "容器已就绪"
          break
        fi
        echo "等待容器就绪，当前状态: $HEALTH_STATUS，已等待 $elapsed 秒"
        sleep $WAIT_INTERVAL
        elapsed=$((elapsed + WAIT_INTERVAL))
      done
      # 超时处理：打印日志便于排查，然后清理容器并退出
      if [ $elapsed -ge $MAX_WAIT ]; then
        echo "容器超时未就绪，打印容器日志排查问题："
        docker logs $CONTAINER_NAME
        docker stop $CONTAINER_NAME
        docker container rm $CONTAINER_NAME
        exit 1
      fi
    - curl http://localhost:80
    - docker stop $CONTAINER_NAME
    - docker container rm $CONTAINER_NAME

方案二：直接在流水线中循环检测服务可用性 #

如果不想依赖HEALTHCHECK，可以直接在脚本中循环执行curl，直到请求成功或超时。这种方式更直观，无需修改Dockerfile。

修改后的流水线脚本：

test_job:
  stage: test
  image: docker:20.10.16
  services:
    - docker:20.10.16-dind
  tags:
    - shell
  script:
    - docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY
    - docker run -d -p 80:80 --env APP_ENV=$APP_ENV --env APP_DEBUG=$APP_DEBUG --name $CONTAINER_NAME $CONTAINER_IMAGE_NAME
    # 循环检测Apache服务，最多等待120秒，每10秒尝试一次
    - |
      MAX_WAIT=120
      WAIT_INTERVAL=10
      elapsed=0
      while [ $elapsed -lt $MAX_WAIT ]; do
        if curl -f http://localhost:80; then
          echo "Apache服务已就绪"
          break
        fi
        echo "等待Apache服务就绪，已等待 $elapsed 秒"
        sleep $WAIT_INTERVAL
        elapsed=$((elapsed + WAIT_INTERVAL))
      done
      # 超时处理
      if [ $elapsed -ge $MAX_WAIT ]; then
        echo "服务超时未就绪，打印容器日志排查问题："
        docker logs $CONTAINER_NAME
        docker stop $CONTAINER_NAME
        docker container rm $CONTAINER_NAME
        exit 1
      fi
    - docker stop $CONTAINER_NAME
    - docker container rm $CONTAINER_NAME

Dockerfile补充优化 #

确保你的容器内已安装curl（用于HEALTHCHECK），如果基础镜像没有，需要在Dockerfile中添加安装步骤：

# 基础镜像之后添加
RUN apt-get update && apt-get install -y --no-install-recommends curl && rm -rf /var/lib/apt/lists/*

CMD composer install && \
    chmod -R 777 /var/www/html/config/autogenerated && \
    chmod -R 777 /var/www/html/var && \
    yarn install && \
    yarn encore production && \
    apache2-foreground
    
HEALTHCHECK --interval=10s --timeout=10s --retries=12 \
  CMD curl -f http://localhost:80 || exit 1

总结 #

两种方案都能替代硬编码的sleep，方案一利用Docker原生健康检查机制，更适合复杂容器场景；方案二更轻量，无需依赖容器内的健康检查配置。根据你的实际需求选择即可。

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