GitLab CI分支配置问题：如何按分支加载不同CI文件

我有dev和test环境的两个独立CI文件，由于无法控制脚本及GitLab变量嵌套问题，必须分开配置。当前使用带条件的include配置.gitlab-ci.yml时，始终会执行最后一个ci.test.yml；尝试另一种写法后仍无效，需要实现按分支加载对应CI文件的正确配置。

原配置代码 #

include:
    - project: marketing/itm/icbf/feature/icbf-mfe-prompt
      ref: Development
      file: .ci/ci.dev.yml
      if: $CI_COMMIT_BRANCH == "Development"

    - project: marketing/itm/icbf/feature/icbf-mfe-prompt
      ref: main
      file: .ci/ci.test.yml
      if: $CI_COMMIT_BRANCH == "main"

尝试的配置代码 #

include:
  - project: marketing/itm/icbf/feature/icbf-mfe-prompt
    ref: Development
    file: .ci/ci.dev.yml

  - project: marketing/itm/icbf/feature/icbf-mfe-prompt
    ref: main
    file: .ci/ci.test.yml

stages:
  - build

# Build job that runs everything inside ci.dev.yml
build:
  stage: build
  script:
    - .ci/ci.dev.yml
  only:
    - Development  # Run only on the Development branch

问题分析与解决方法 #

原配置问题点 #

原配置中条件判断未加引号，可能导致GitLab解析变量时出现异常；此外，若被包含的两个CI文件存在同名Job，即使条件互斥，若解析异常导致两个文件都被加载，后加载的ci.test.yml会覆盖前者的Job定义。

正确配置写法 #

使用带引号的条件判断，同时改用rules语法（GitLab 13.0+推荐）确保仅加载对应分支的CI文件：

include:
  - project: marketing/itm/icbf/feature/icbf-mfe-prompt
    ref: Development
    file: .ci/ci.dev.yml
    rules:
      - if: '$CI_COMMIT_BRANCH == "Development"'
  - project: marketing/itm/icbf/feature/icbf-mfe-prompt
    ref: main
    file: .ci/ci.test.yml
    rules:
      - if: '$CI_COMMIT_BRANCH == "main"'

补充说明 #

1. 分支名称大小写：CI_COMMIT_BRANCH区分大小写，需确保配置中的分支名与实际分支完全一致（比如Development和development会被识别为两个不同分支）。
2. Job命名冲突：若ci.dev.yml和ci.test.yml中有同名Job，必须保证同一时间仅加载其中一个文件，避免后加载的文件覆盖Job定义。
3. GitLab版本要求：include的条件判断需GitLab 12.10及以上版本支持，rules语法需GitLab 13.0及以上版本。

错误写法的问题 #

你尝试的第二种写法会同时加载两个CI文件，且直接执行.ci/ci.dev.yml的写法无效（CI文件是YAML配置文件，不能作为Shell脚本执行），这会导致ci.test.yml中的Job也被触发，引发执行混乱。

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