Gitlab CI模板：如何传递Runner标签与环境参数？

你的需求完全可行，报错原因是GitLab CI对stage的解析时机限制：stage属于流水线结构定义，会在配置解析的早期阶段处理，此时模板中的变量（如${stage_name}）还未被替换，导致GitLab把${stage_name}当作一个不存在的stage名称，从而抛出“所选阶段不存在”的错误。

下面是几种可行的解决方向：

方案1：extends模板+显式指定stage #

把可复用的配置（变量、脚本）放在模板中，每个job单独指定stage、tags和environment，这是最直观且兼容性最好的方式：

stages:
  - legacyStuff
  - targetStuff

# 可复用的模板
.diagnostics:
  variables:
    ProjectName: '${ProjectBaseName}_${ENVID}'
  script:
    - echo $ProjectName

# 针对Legacy环境的Job
diags_source:
  extends: .diagnostics
  stage: legacyStuff
  tags:
    - legacyRunner
  environment: 
    name: LegacyCI

# 针对Target环境的Job
diags_target:
  extends: .diagnostics
  stage: targetStuff
  tags:
    - targetRunner
  environment: 
    name: TargetCI

方案2：使用并行矩阵批量生成Jobs #

如果你的环境、Runner标签和Stage的对应关系规整，可以用parallel:matrix批量生成Job，进一步减少重复代码（需要GitLab 14.0及以上版本）：

stages:
  - legacyStuff
  - targetStuff

diagnostics:
  # 矩阵会自动为每个条目生成独立Job，stage会被正确解析
  stage: ${stage}
  tags:
    - ${runner_tag}
  environment: 
    name: ${env_name}
  variables:
    ProjectName: '${ProjectBaseName}_${ENVID}'
  script:
    - echo $ProjectName
  parallel:
    matrix:
      - stage: legacyStuff
        runner_tag: legacyRunner
        env_name: LegacyCI
      - stage: targetStuff
        runner_tag: targetRunner
        env_name: TargetCI

方案3：YAML锚点复用配置片段 #

如果extends的灵活性不够，可以用YAML原生的锚点（anchor）来复用配置片段：

stages:
  - legacyStuff
  - targetStuff

# 定义锚点模板
.diagnostics_template: &diagnostics_template
  variables:
    ProjectName: '${ProjectBaseName}_${ENVID}'
  script:
    - echo $ProjectName

diags_source:
  # 引用锚点
  <<: *diagnostics_template
  stage: legacyStuff
  tags:
    - legacyRunner
  environment: 
    name: LegacyCI

diags_target:
  <<: *diagnostics_template
  stage: targetStuff
  tags:
    - targetRunner
  environment: 
    name: TargetCI

以上三种方案都能满足你的需求：实现环境与Runner的绑定、按Stage顺序执行（前一Stage的Job成功后才会执行下一Stage），同时复用重复配置。

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