容器与云原生 / 系统课时

environment 怎样传变量给容器

environment 怎样传变量给容器

应用镜像通常不应该把数据库地址、运行环境或功能开关写死。Compose 的 environment 可以在创建容器时把这些值写入进程环境,本课通过一个最小服务验证变量确实进入容器,并说明常见写法与覆盖规则。

学习目标

  • 使用 environment 为容器设置运行时环境变量
  • 选择清晰的映射语法并正确处理字符串值
  • 理解 environment、env_file 与临时命令行覆盖之间的关系

用映射语法设置容器环境

environment 属于服务配置,Compose 创建容器时会把其中的键值写入容器环境。它支持映射和列表两种语法;在团队配置中,映射形式通常更容易审查,也更不容易把键和值看混。([Docker Documentation][2])

下面用 alpine 容器直接打印三个变量,不依赖额外应用代码。

bash
mkdir -p compose-environment-demo
cd compose-environment-demo

cat > compose.yaml <<'EOF'
services:
  app:
    image: alpine:3.20
    environment:
      APP_ENV: "staging"
      DB_HOST: "db.internal"
      FEATURE_CHECKOUT: "true"
    command:
      - sh
      - -c
      - env | grep -E '^(APP_ENV|DB_HOST|FEATURE_CHECKOUT)=' | sort
EOF

docker compose run --rm app

预期输出

text
APP_ENV=staging
DB_HOST=db.internal
FEATURE_CHECKOUT=true

首次运行如果本机没有 alpine:3.20,Docker 可能先打印镜像或网络准备日志;上面的三行是容器命令最终应输出的变量值。

变量值可以来自哪里

environment 既可以直接写固定值,也可以结合 Compose 插值,例如 APP_ENV: "${APP_ENV:-development}"。前者适合稳定且非敏感的默认配置,后者适合让 Shell 或 .env 决定不同环境的值。

列表形式与映射形式都受支持,例如 - APP_ENV=staging 与 APP_ENV: "staging" 可以表达相同结果。映射形式在布尔值、数字和空值附近更直观;像 "true"、"8080" 这类希望应用按字符串读取的值,显式加引号更稳妥。([Docker Documentation][2])

还可以只写变量名而不写值,让 Compose 从运行 Compose 的 Shell 继承,例如列表中的 - APP_ENV。这种写法在 Shell 未定义变量时不会发出警告;如果希望缺失时更早暴露问题,更推荐显式使用 ${APP_ENV:?APP_ENV is required}。([Docker Documentation][2])

与 env_file 怎样配合

当变量很多时,可以把一组容器环境变量放到服务级 env_file;而少量关键覆盖值继续写在 environment 中。若同一个变量同时由 env_file 和 environment 设置,environment 的值优先。Docker 镜像中通过 ENV 声明的默认值,只有在 Compose 没有用更高优先级来源覆盖时才会生效。([Docker Documentation][3])

yaml
services:
  app:
    image: example/app:1.0
    env_file:
      - ./app.env
    environment:
      APP_ENV: "production"

这是配置片段示例,依赖同目录中的 app.env 与实际存在的 example/app:1.0 镜像。生效后,APP_ENV 使用 environment 中的 production;其他未被覆盖的变量继续从 app.env 读取。可用 docker compose config 检查解析后的服务配置,再进入实际容器用 env 验证运行时值。

不要把环境变量当秘密存储

数据库主机名、运行模式、功能开关适合放进环境变量,但数据库密码、私钥、长期访问令牌不应因为“应用能从环境读取”就直接明文写进 compose.yaml。Docker 官方建议敏感信息使用 secrets 等更合适的机制。([Docker Documentation][2])

实际使用时,可以把 environment 看成容器启动时的“运行参数入口”:镜像保持通用,Compose 在部署现场提供具体值。只要同时明确变量来源、覆盖顺序和敏感信息边界,就能在不改镜像的情况下切换不同运行环境。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

environment 怎样传变量给容器

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通