如何向YAML注入环境变量以动态创建不同配置的Docker容器？

YAML本身是纯静态的数据序列化格式，没有内置执行逻辑、也没有权限访问系统环境变量，所有动态传值的能力都由解析YAML的上层工具实现，根据你用的编排场景选对应方案就行，不需要改原有镜像的逻辑。

方案1：Docker Compose 原生变量替换（最推荐，零额外依赖） #

如果你用Docker Compose管理容器，官方已经内置了环境变量替换能力，不需要写额外脚本：

• 首先在docker-compose.yml里用${变量名}格式写占位符，示例配置：

services:
  your-app:
    image: your-custom-image:latest
    environment:
      # 把宿主机的MY_LOCALE变量传入容器，也可以给默认值兜底
      - MY_LOCALE=${MY_LOCALE:-en_US}

• 传值有两种省事的方式：
  • 临时传值：启动前在当前shell导出变量即可，比如export MY_LOCALE=zh_CN && docker compose up -d
  • 固定配置：在docker-compose.yml同目录新建.env文件，写入MY_LOCALE=zh_CN，Compose启动时会自动读取这个文件里的变量，不需要手动export。

方案2：Kubernetes 场景下的动态传值 #

如果你是用K8s编排容器，不要直接让YAML读环境变量，根据部署方式选对应方案：

• 用原生kubectl部署：可以配合kustomize的变量替换能力，把环境变量的值渲染到Deployment的env字段后再apply
• 用Helm部署：直接在Chart的模板里留占位符，部署时通过--set myLocale=zh_CN动态传值，或者把不同环境的变量写到独立的values文件里，启动时指定对应文件即可。
  核心配置片段示例：

containers:
- name: your-app
  image: your-custom-image:latest
  env:
  - name: MY_LOCALE
    value: {{ .Values.myLocale | quote }} # Helm模板占位符

方案3：通用模板渲染（适配所有YAML场景） #

如果你不用上述编排工具，是自己写脚本调用docker命令创建容器，可以用模板工具提前把环境变量渲染成最终的YAML文件，再用生成的配置创建容器：

• 最轻量的选择是Linux系统自带的envsubst（属于gettext工具包，大部分发行版默认预装）：
  1. 先写模板文件config.yaml.tpl，需要动态替换的位置用${MY_LOCALE}占位
  2. 导出对应环境变量后，执行命令生成最终配置：

  # 只替换指定变量，避免误替换YAML里其他带$的特殊字段
  envsubst '${MY_LOCALE}' < config.yaml.tpl > runtime-config.yaml
  

  3. 拿生成好的runtime-config.yaml作为配置参数创建容器即可。
• 如果需要更复杂的配置逻辑（条件判断、循环、值转换），可以选yq、Jinja2这类更灵活的模板渲染工具。

踩坑提示：不要试图修改YAML语法标准来实现环境变量读取，所有声称“YAML支持读环境变量”的实现，本质都是解析工具在加载YAML前做了文本替换，选对应工具的原生能力就好，不用自己造轮子写替换脚本。

内容的提问来源于stack exchange，提问作者paul.kim1901