容器与云原生 / 系统课时
使用 ARG 与 ENV
使用 ARG 与 ENV
Dockerfile 中的 ARG 与 ENV 都能保存变量,但它们作用阶段完全不同。本课将通过构建和运行流程理解两者边界,避免把敏感信息或环境差异错误写入镜像。
学习目标
- 区分 ARG 构建参数和 ENV 环境变量的生命周期。
- 掌握在 Dockerfile 中声明和使用变量的方法。
- 了解密钥、配置项和环境差异的正确管理方式。
理解 ARG 与 ENV 的作用范围
ARG 是构建阶段变量,只存在于镜像构建过程。构建完成后,运行中的容器默认无法读取 ARG 值。
ENV 是镜像运行阶段环境变量,会写入镜像元数据,并在容器启动时提供给应用读取。
两者关系可以简单理解为:ARG 服务于“如何构建镜像”,ENV 服务于“容器启动后应用如何运行”。
使用 ARG 控制构建行为
ARG 常用于选择基础镜像版本、控制编译选项或切换构建流程。它不会自动成为运行环境变量。
dockerfile
FROM node:22
ARG APP_ENV=production
WORKDIR /app
COPY package*.json ./
RUN echo "building for ${APP_ENV}" && npm install预期结果
text
构建阶段输出:building for production
镜像运行时无法直接读取 APP_ENV构建时可以通过 --build-arg 修改 ARG 值,但需要注意不要将密码、访问令牌等敏感数据作为 ARG 传入,因为构建历史和缓存可能留下相关信息。
使用 ENV 提供运行配置
ENV 适合应用运行时需要读取的默认配置,例如时区、运行模式或服务端口。
dockerfile
FROM node:22
WORKDIR /app
COPY . .
ENV NODE_ENV=production
ENV PORT=<PORT>
CMD ["node", "server.js"]预期结果
text
容器启动后:
NODE_ENV=production
PORT=<PORT>
应用读取环境变量完成启动运行容器时可以覆盖 ENV 值,例如通过 docker run -e 提供不同环境配置,而不必重新构建镜像。
避免固化敏感信息
数据库密码、API 密钥和访问令牌不应该写入 ARG 或 ENV 默认值。镜像可能被多人下载、扫描或缓存,敏感信息容易泄露。
生产环境通常将敏感配置交给运行平台注入,例如 Docker Compose secrets、Kubernetes Secret 或外部密钥管理系统。
bash
docker run -e DATABASE_PASSWORD=<PASSWORD> <IMAGE>预期结果
text
容器启动后应用通过环境变量读取 DATABASE_PASSWORD
镜像内容不包含固定密码对比构建参数与运行变量
| 项目 | ARG | ENV |
|---|---|---|
| 生效阶段 | 构建阶段 | 运行阶段 |
| 是否进入容器环境 | 否 | 是 |
| 常见用途 | 构建选项、版本控制 | 应用配置、默认参数 |
| 是否适合保存密钥 | 否 | 否 |
正确使用 ARG 和 ENV 可以让同一个镜像适配多个环境,同时保持构建流程和运行配置分离。
按自己的节奏,确认真正理解。