容器与云原生 / 系统课时

管理环境变量与配置

管理环境变量与配置

本课学习如何在 Docker Compose 中管理应用配置,通过 env_file、environment 和变量插值控制不同环境的参数来源,同时避免将数据库密码等敏感信息直接提交到代码仓库。

学习目标

  • 理解 Compose 中环境变量的来源和优先级关系。
  • 掌握 env_file、environment 与变量插值的使用方式。
  • 能够设计不暴露密钥的配置管理方案。

理解 Compose 配置来源

Docker Compose 支持多种方式向容器注入配置。常见来源包括宿主机环境变量、项目目录中的 .env 文件、Compose 文件中的 environment 字段,以及独立的 env_file 文件。

这些配置最终会成为容器进程启动时可以读取的环境变量。应用程序通常通过环境变量读取数据库地址、端口、运行模式和第三方服务凭据。

使用 env_file 管理环境文件

env_file 适合保存一组环境变量定义,可以将开发、测试和生产环境拆分为不同文件。

yaml
services:
  api:
    image: example/api:<TAG>
    env_file:
      - ./config/app.env
    ports:
      - "<PORT>:8080"

预期结果

text
容器启动后,api 服务进程可以读取 app.env 中定义的环境变量。

例如 app.env 可以保存非代码配置:

text
APP_ENV=development
DB_HOST=mysql
DB_PORT=3306

预期结果

text
应用读取 APP_ENV、DB_HOST 和 DB_PORT 等配置值。

生产环境中不要把包含密码的文件直接提交到 Git,应通过安全存储或部署系统注入敏感变量。

使用 environment 覆盖指定变量

environment 用于在 Compose 文件中显式声明变量,也可以覆盖 env_file 中同名变量。

yaml
services:
  api:
    image: example/api:<TAG>
    env_file:
      - ./config/app.env
    environment:
      APP_ENV: production
      LOG_LEVEL: info

预期结果

text
容器中的 APP_ENV 值为 production,LOG_LEVEL 值为 info。

当团队需要明确展示关键运行参数时,可以使用 environment;当配置项较多时,通常使用 env_file 保持 Compose 文件简洁。

掌握变量插值规则

Compose 文件支持使用 ${变量名} 读取宿主机环境变量或 .env 文件中的值。

yaml
services:
  web:
    image: "example/web:${VERSION}"
    ports:
      - "${HTTP_PORT}:80"

预期结果

text
VERSION=1.2.0 和 HTTP_PORT=<PORT> 被替换后生成实际配置。

变量不存在时,可以使用默认值避免启动失败:

yaml
services:
  web:
    image: "example/web:${VERSION:-latest}"

预期结果

text
未设置 VERSION 时,Compose 使用 latest 作为镜像标签。

配置优先级与安全边界

实际排查配置问题时,需要先确认变量最终进入容器的结果,而不是只查看某一个配置文件。

bash
docker compose config

预期结果

text
输出展开后的 Compose 配置,显示变量替换后的最终内容。

通常需要遵循以下原则:

  • 开发默认值可以放入 .env。
  • 环境差异配置使用独立 env_file。
  • 密钥不要写入镜像、Compose 文件或公开仓库。
  • 生产环境优先使用专用密钥管理方案。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

管理环境变量与配置

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

登录哪都通