GitLab CI：如何仅针对指定环境执行作业并规避依赖限制

先看当前的CI配置：

stages:
  - firstStage
  - secondStage

first-job:
  stage: firstStage
  parallel:
    matrix:
      - ENVIRONMENT: 
        - test
        - production
  environment: $ENVIRONMENT
  script:
    - echo "firstStage $ENVIRONMENT"
  when: manual
  allow_failure: false

second-job:
  stage: secondStage
  parallel:
    matrix:
      - ENVIRONMENT: 
        - test
        - production
  environment: $ENVIRONMENT
  script:
    - echo "secondStage $ENVIRONMENT"
  when: manual
  allow_failure: false

当前问题：必须执行first-job的test和production两个环境实例，才能触发对应环境的second-job，但需求是仅针对test环境执行全流程作业，且不想用复制作业、移除矩阵或设置allow_failure: true的方案。

更简洁的解决方案：流水线变量+矩阵过滤+精准依赖 #

通过定义流水线变量控制目标环境，结合矩阵条件过滤和精准依赖配置，既能保留预配置的环境列表，又能灵活指定单个环境运行全流程。

修改后的配置如下：

stages:
  - firstStage
  - secondStage

# 定义默认目标环境，触发流水线时可手动修改
variables:
  TARGET_ENV: "test"

first-job:
  stage: firstStage
  parallel:
    matrix:
      - ENVIRONMENT: 
          - test
          - production
        # 仅保留与TARGET_ENV匹配的环境实例
        if: $ENVIRONMENT == $TARGET_ENV
  environment: $ENVIRONMENT
  script:
    - echo "firstStage $ENVIRONMENT"
  when: manual
  allow_failure: false

second-job:
  stage: secondStage
  parallel:
    matrix:
      - ENVIRONMENT: 
          - test
          - production
        if: $ENVIRONMENT == $TARGET_ENV
  environment: $ENVIRONMENT
  script:
    - echo "secondStage $ENVIRONMENT"
  when: manual
  allow_failure: false
  # 仅依赖同环境的first-job实例，避免跨环境依赖
  needs:
    - job: first-job
      environment: $ENVIRONMENT

方案优势 #

• 保留预配置的环境列表（test、production），无需重复编写作业配置
• 通过TARGET_ENV变量灵活切换运行环境：触发流水线时手动修改变量值，即可切换到production环境运行全流程
• 利用needs指定同环境依赖，确保只有对应环境的first-job执行后，才能触发second-job，不会出现必须执行所有环境才能推进流程的问题
• 无需设置allow_failure: true，保证作业执行的可靠性

进一步精简：复用矩阵模板 #

如果需要进一步减少重复代码，可以把矩阵过滤逻辑抽成可复用的模板：

stages:
  - firstStage
  - secondStage

variables:
  ALL_ENVS: "test production"
  TARGET_ENV: "test"

# 复用的环境矩阵模板
.filtered_env_matrix:
  parallel:
    matrix:
      - ENVIRONMENT: $ALL_ENVS
        if: $ENVIRONMENT == $TARGET_ENV

first-job:
  stage: firstStage
  extends: .filtered_env_matrix
  environment: $ENVIRONMENT
  script:
    - echo "firstStage $ENVIRONMENT"
  when: manual
  allow_failure: false

second-job:
  stage: secondStage
  extends: .filtered_env_matrix
  environment: $ENVIRONMENT
  script:
    - echo "secondStage $ENVIRONMENT"
  when: manual
  allow_failure: false
  needs:
    - job: first-job
      environment: $ENVIRONMENT

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