GitLab CI如何基于规则有条件地忽略needs依赖？

我有一个用于构建Docker镜像的GitLab CI流水线，这些镜像供后续环节使用。目前配置了仅当提交消息包含特定标签时触发镜像构建，避免不必要的重建。但镜像数量多，希望实现更细粒度控制，按需仅重建部分镜像。

当前的gitlab-ci.yml配置片段如下：

build-base:
  stage: build-images
  extends: .template_build_image
  variables:
    IMAGE_NAME: base
  rules:
    - if: '$CI_COMMIT_MESSAGE =~ /^.*\[build-images\].*$/s'

build-environment:
  stage: build-images
  needs: [build-base]
  extends: .template_build_image
  variables:
    IMAGE_NAME: environment
  rules:
    - !reference [build-base, rules]

...
# 其他镜像构建任务

我可以给build-environment添加规则，让提交消息包含[build-environment]时触发它，但问题是它依赖build-base——如果流水线里没有build-base，GitLab会报错。我不想移除这些needs依赖，因为完整流水线运行时这些依赖很重要，只希望在需要手动跳过初始步骤（直接用仓库中已有的base镜像）时，能选择性忽略这些依赖。

请问GitLab CI里有没有办法实现这个需求？

你可以通过以下几种方式实现按需构建且选择性忽略依赖的需求：

1. 使用条件式needs（推荐） #

GitLab CI支持在needs中使用if条件，根据提交消息或自定义变量动态决定是否依赖前置任务。修改build-environment的配置：

build-environment:
  stage: build-images
  needs:
    - job: build-base
      # 仅当提交消息包含[build-images]时才依赖build-base
      if: '$CI_COMMIT_MESSAGE =~ /^.*\[build-images\].*$/s'
  extends: .template_build_image
  variables:
    IMAGE_NAME: environment
  rules:
    # 触发条件：要么全量构建，要么单独构建environment
    - if: '$CI_COMMIT_MESSAGE =~ /^.*\[build-images\].*$/s'
    - if: '$CI_COMMIT_MESSAGE =~ /^.*\[build-environment\].*$/s'

这样，当提交消息是[build-environment]时，needs会自动跳过build-base；当是[build-images]时，依然保持原有的依赖关系，确保完整构建流程的正确性。

2. 通过自定义变量手动控制依赖 #

如果需要更灵活的手动触发方式，可以添加一个自定义变量（比如SKIP_BASE_BUILD），在手动启动流水线时设置该变量来跳过依赖：

build-environment:
  stage: build-images
  needs:
    - job: build-base
      # 当SKIP_BASE_BUILD变量不存在或为false时，才依赖build-base
      if: '$SKIP_BASE_BUILD != "true"'
  extends: .template_build_image
  variables:
    IMAGE_NAME: environment
  rules:
    - if: '$CI_COMMIT_MESSAGE =~ /^.*\[build-images\].*$/s'
    - if: '$CI_COMMIT_MESSAGE =~ /^.*\[build-environment\].*$/s'
    # 允许手动触发时选择该任务
    - if: '$CI_PIPELINE_SOURCE == "web"'
      when: manual

当你需要单独构建environment镜像时，手动启动流水线并设置SKIP_BASE_BUILD=true，此时needs会忽略build-base，直接使用仓库中已有的镜像。

3. 拆分镜像构建的依赖层级 #

如果镜像之间的依赖关系复杂，可以考虑将基础镜像的版本固化到变量中，比如在build-environment中直接指定使用已发布的base镜像版本，而不是依赖构建任务：

# 定义基础镜像版本变量
variables:
  BASE_IMAGE_VERSION: "latest" # 或通过CI变量动态设置

build-environment:
  stage: build-images
  # 仅当全量构建时才依赖build-base
  needs:
    - job: build-base
      if: '$CI_COMMIT_MESSAGE =~ /^.*\[build-images\].*$/s'
  extends: .template_build_image
  variables:
    IMAGE_NAME: environment
    # 构建时指定基础镜像版本
    BASE_IMAGE: "$CI_REGISTRY_IMAGE/base:$BASE_IMAGE_VERSION"
  rules:
    - if: '$CI_COMMIT_MESSAGE =~ /^.*\[build-images\].*$/s'
    - if: '$CI_COMMIT_MESSAGE =~ /^.*\[build-environment\].*$/s'

这种方式需要确保你的.template_build_image模板中使用$BASE_IMAGE作为构建的基础镜像，而不是依赖本地构建的产物。

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