如何为GitLab CI指定阶段单独设置自定义环境变量

针对你的需求，不用逐个修改任务、不影响全局变量、支持开发者自定义值，推荐用GitLab CI模板继承+手动触发变量的方案，操作简单且无重构风险：

核心思路 #

通过定义一个通用模板，给deploy_private阶段的所有任务统一设置专属变量，变量值由开发者在触发流水线时手动输入，既覆盖该阶段的目标变量，又不影响其他阶段的全局变量值。

具体实现步骤 #

1. 定义deploy_private阶段的任务模板 #

在.gitlab-ci.yml中添加一个模板，集中设置该阶段的变量规则：

# 定义私有部署任务的通用模板
.deploy_private_template:
  stage: deploy_private
  # 在这里覆盖目标环境变量，指向手动输入的自定义值
  variables:
    # 假设你要修改的全局环境变量名为ENV_NAME，这里将其重定向到自定义变量PRIVATE_ENV_NAME
    ENV_NAME: $PRIVATE_ENV_NAME
  # 可选：添加规则，确保只有输入了自定义值才运行该阶段任务
  rules:
    - if: $PRIVATE_ENV_NAME
      when: always
    - when: never

2. 让阶段内的10个任务继承模板 #

把原来deploy_private阶段下的10个任务全部修改为继承上述模板，不用逐个设置变量：

# 示例：原来的任务1修改为继承模板
deploy_private_job1:
  extends: .deploy_private_template
  script:
    - # 你的部署脚本，这里使用的ENV_NAME就是自定义的私有环境名称

# 其余9个任务同理，只需要替换job名称和脚本内容
deploy_private_job2:
  extends: .deploy_private_template
  script:
    - # 第二个任务的部署脚本

3. 配置手动输入变量 #

在.gitlab-ci.yml的全局变量块中，添加自定义变量的描述，方便开发者触发时填写：

variables:
  # 保留原有的全局环境变量（比如ENV_NAME的全局默认值）
  ENV_NAME: "prod"
  # 定义私有环境的自定义变量，触发流水线时可手动修改
  PRIVATE_ENV_NAME:
    description: "私有开发环境名称（仅deploy_private阶段使用）"
    value: ""  # 默认空值，触发时必须填写

操作流程 #

开发者触发流水线时：

1. 在GitLab的流水线触发页面，找到PRIVATE_ENV_NAME输入框，填写自定义的私有环境名称
2. 启动流水线后，deploy_private阶段的所有任务会自动使用该自定义值，其他阶段仍沿用全局的ENV_NAME值

优势 #

• 无需逐个修改10个任务，一次模板配置即可批量生效
• 严格隔离全局变量与私有阶段变量，不会互相影响
• 支持开发者按需自定义环境名称，灵活度高
• 仅需修改少量CI配置，无重构风险，几分钟即可完成设置

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