GitLab Job服务配置：如何实现服务按依赖顺序启动

问题场景 #

现有如下GitLab CI Job配置：

test-integration:
  extends:
    - .some_tnner
  image: $SOME_IMAGE
  variables:
    FF_NETWORK_PER_BUILD: 'true' 
  services:
    - name: $FIRST_SERVICE
      alias: first-service
    - name: $SECOND_SERVICE
      alias: second-service
  script:
    - 'some_script'

需求是让第二个服务在第一个服务完全启动就绪后再启动，但尝试给第二个服务添加depends_on: first-service时，GitLab报错unknown key: depends_on——因为GitLab CI的services配置并不支持depends_on字段（该字段是Docker Compose的语法，不适用于GitLab CI）。

可行解决方案 #

方案1：在脚本中手动控制服务启动 #

将第二个服务移出services块，在script步骤中先等待第一个服务就绪，再手动启动第二个服务：

test-integration:
  extends:
    - .some_tnner
  image: $SOME_IMAGE
  variables:
    FF_NETWORK_PER_BUILD: 'true' 
  services:
    - name: $FIRST_SERVICE
      alias: first-service
  script:
    # 等待第一个服务就绪（替换成对应服务的健康检查方式，比如curl端口）
    - until curl -s http://first-service:8080; do sleep 2; done
    # 启动第二个服务，使用CI的作业网络保证互通
    - docker run -d --name second-service --network $CI_JOB_NETWORK $SECOND_SERVICE
    # 等待第二个服务就绪
    - until curl -s http://second-service:9090; do sleep 2; done
    # 执行原有测试脚本
    - 'some_script'

注意：需要确保GitLab Runner拥有执行Docker命令的权限（比如使用Docker-in-Docker执行器）。

方案2：给第二个服务添加启动前等待逻辑 #

利用服务的command配置，在启动第二个服务自身进程前，先等待第一个服务就绪：

test-integration:
  extends:
    - .some_tnner
  image: $SOME_IMAGE
  variables:
    FF_NETWORK_PER_BUILD: 'true' 
  services:
    - name: $FIRST_SERVICE
      alias: first-service
    - name: $SECOND_SERVICE
      alias: second-service
      # 替换为实际的等待逻辑和服务启动命令
      command: ["/bin/sh", "-c", "until curl -s http://first-service:8080; do sleep 2; done && /usr/bin/start-second-service"]

这种方式无需修改Runner配置，适合第二个服务的基础镜像包含Shell和curl工具的场景。

方案3：使用专业等待工具 #

如果需要更可靠的等待逻辑，可以使用专门的工具（如wait-for-it），将其集成到第二个服务的启动流程中：

test-integration:
  extends:
    - .some_tnner
  image: $SOME_IMAGE
  variables:
    FF_NETWORK_PER_BUILD: 'true' 
  services:
    - name: $FIRST_SERVICE
      alias: first-service
    - name: $SECOND_SERVICE
      alias: second-service
      command: ["/bin/sh", "-c", "wget -q https://raw.githubusercontent.com/vishnubob/wait-for-it/master/wait-for-it.sh && chmod +x wait-for-it.sh && ./wait-for-it.sh first-service:8080 -- /usr/bin/start-second-service"]

如果第二个服务镜像已经预装了这类工具，可以直接省略下载步骤。

内容的提问来源于stack exchange，提问作者Po Ah Wong