如何为部署流水线的不同阶段设置不同的变量值

开发者阿泽

2026-9-23

可行实现方案

全局变量加阶段前缀映射
对需要分阶段取值的变量，按{阶段标识}_{变量名}的规则设置全局变量，比如变量目标名为ENV_TYPE，可设置全局变量STAGE1_ENV_TYPE=dev、STAGE2_ENV_TYPE=prod。在每个阶段的执行脚本开头做变量重赋值即可，示例shell逻辑：
```
# 阶段1执行
export ENV_TYPE=$STAGE1_ENV_TYPE
# 后续JSON转换逻辑直接调用$ENV_TYPE即可
```
该方案无额外依赖，不需要调整现有流水线配置逻辑，适配性最高。
配置文件托管分阶段变量
在代码仓库中新增专属阶段变量配置文件（比如stage-vars.json），按阶段分组存储所有变量取值：
```
{
  "stage1": {"ENV_TYPE": "dev", "API_DOMAIN": "dev.example.com"},
  "stage2": {"ENV_TYPE": "prod", "API_DOMAIN": "example.com"}
}
```
每个阶段执行前先读取对应阶段的配置加载为环境变量，以jq工具为例：
```
export ENV_TYPE=$(jq -r ".stage1.ENV_TYPE" ./stage-vars.json)
```
变量修改仅需调整配置文件，不需要修改流水线设置，适合变量数量多、调整频率高的场景。
基于内置阶段标识判断赋值
绝大多数传统CI/CD平台都会提供内置全局变量，比如当前阶段序号、阶段名称等，可直接在阶段脚本中做分支判断赋值：
```
if [ $CI_BUILD_STAGE_ID -eq 1 ]; then
  export ENV_TYPE="dev"
elif [ $CI_BUILD_STAGE_ID -eq 2 ]; then
  export ENV_TYPE="prod"
fi
```
该方案不需要新增额外全局变量，适合变量数量少的场景。
转换命令直接传入阶段专属参数
如果JSON转换通过jq等工具实现，可以直接在对应阶段的转换命令中硬编码传入参数值，完全绕开环境变量限制，示例：
```
# 阶段1执行
jq --arg env_type "dev" '.[].env = $env_type' input.json > output.json
# 阶段2执行时修改--arg后的取值即可
```