容器与云原生 / 系统课时

使用 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 可以让同一个镜像适配多个环境,同时保持构建流程和运行配置分离。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用 ARG 与 ENV

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

登录哪都通