如何通过GitLab CI并行矩阵为Docker镜像构建按需添加延时？

首先要明确：GitLab CI的parallel matrix是用来同时启动多个独立任务的，你在矩阵里加sleep:900这种变量根本不会被执行——矩阵只是传递环境变量，不是执行脚本的载体。而且并行任务是同时触发的，就算你在某个任务里单独加sleep，也只是让这个任务延后执行，但所有并行任务还是同一时间启动，没法做到依次间隔15分钟的效果。

针对你的需求，分两种场景给出解决方案：

场景1：部分镜像需要依次间隔执行，其余镜像可并行 #

直接把任务拆成两部分处理：

1. 并行构建不需要延时的镜像
2. 串行构建需要间隔的镜像，每个任务之间设置15分钟延时

示例配置：

# 并行构建无需延时的镜像
build-docker-parallel:
  extends: .docker-build-job
  stage: build
  parallel:
    matrix:
      - DOCKER_BUILD_CONTEXT: "."
        DOCKER_BUILD_NAME: "$DOCKER_IMAGE1"
        DOCKER_BUILD_DOCKERFILE: "/Dockerfile1"
      # 可添加其他无需延时的镜像配置...

# 串行构建需要间隔的第一个镜像
build-docker-serial-1:
  extends: .docker-build-job
  stage: build
  variables:
    DOCKER_BUILD_CONTEXT: "."
    DOCKER_BUILD_NAME: "$DOCKER_IMAGE2"
    DOCKER_BUILD_DOCKERFILE: "/Dockerfile2"

# 串行构建需要间隔的第二个镜像，等待第一个任务完成后，先睡15分钟再构建
build-docker-serial-2:
  extends: .docker-build-job
  stage: build
  needs: [build-docker-serial-1]
  before_script:
    - sleep 900
  variables:
    DOCKER_BUILD_CONTEXT: "."
    DOCKER_BUILD_NAME: "$DOCKER_IMAGE3"
    DOCKER_BUILD_DOCKERFILE: "/Dockerfile3"

场景2：所有任务必须放在同一个stage，但部分需依次间隔 #

如果一定要把所有任务放在同一个stage，可以通过needs结合矩阵变量控制执行顺序，再在脚本里加条件sleep：

build-docker-images:
  extends: .docker-build-job
  stage: build
  parallel:
    matrix:
      - TASK_TYPE: "parallel"
        DOCKER_BUILD_CONTEXT: "."
        DOCKER_BUILD_NAME: "$DOCKER_IMAGE1"
        DOCKER_BUILD_DOCKERFILE: "/Dockerfile1"
      - TASK_TYPE: "serial-first"
        DOCKER_BUILD_CONTEXT: "."
        DOCKER_BUILD_NAME: "$DOCKER_IMAGE2"
        DOCKER_BUILD_DOCKERFILE: "/Dockerfile2"
      - TASK_TYPE: "serial-second"
        DOCKER_BUILD_CONTEXT: "."
        DOCKER_BUILD_NAME: "$DOCKER_IMAGE3"
        DOCKER_BUILD_DOCKERFILE: "/Dockerfile3"
  # 让第二个串行任务依赖第一个串行任务的完成
  needs:
    - $TASK_TYPE == "serial-second" && build-docker-images:TASK_TYPE=serial-first
  before_script:
    - |
      # 只有第二个串行任务需要先sleep 15分钟
      if [ "$TASK_TYPE" = "serial-second" ]; then
        sleep 900
      fi

关键注意点 #

• 不要试图在parallel matrix里直接写sleep指令，矩阵仅负责传递变量，不处理脚本逻辑
• 间隔执行的核心是控制任务的触发顺序，必须用needs来让任务按先后顺序启动，再结合sleep实现间隔
• 如果你的.docker-build-job模板里已有before_script，记得把上述sleep逻辑合并进去，避免被覆盖

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