容器与云原生 / 系统课时

使用 WORKDIR 与 ENV

使用 WORKDIR 与 ENV

本课解决“Dockerfile 中路径和配置容易分散、难以复用”的问题。完成后,你将能用 WORKDIR 固定后续操作目录,用 ENV 提供镜像默认配置,并理解运行时覆盖环境变量的规则。

学习目标

  • 使用 WORKDIR 统一相对路径的基准目录
  • 使用 ENV 定义可继承的环境变量
  • 在运行容器时覆盖默认环境变量

WORKDIR 统一路径

WORKDIR 会设置后续 RUN、COPY、CMD 和 ENTRYPOINT 等指令使用的工作目录。目录不存在时,Docker 会在构建过程中创建它。

相比在每条命令中反复执行 cd /app,WORKDIR /app 更清晰,也不会受到不同 Shell 会话的影响。多个 WORKDIR 可以叠加,相对路径会基于前一个工作目录继续计算,但生产 Dockerfile 通常使用明确的绝对路径。

ENV 提供默认配置

ENV 写入镜像元数据,后续构建指令和容器运行进程都可以读取。它适合保存环境名称、默认端口和应用目录等非敏感配置,不应保存密码、令牌或私钥。

下面的完整 Dockerfile 同时展示工作目录和默认环境变量:

dockerfile
FROM alpine:3.20
WORKDIR /workspace
ENV APP_ENV=production
ENV APP_PORT=8080
CMD ["sh", "-c", "printf 'env=%s\nport=%s\npwd=%s\n' \"$APP_ENV\" \"$APP_PORT\" \"$PWD\""]

构建镜像:

bash
docker build -q -t workdir-env-demo:1.0 .

预期输出:

text
<IMAGE_ID>

使用默认配置运行:

bash
docker run --rm workdir-env-demo:1.0

预期输出:

text
env=production
port=8080
pwd=/workspace

运行时覆盖 ENV

镜像中的 ENV 是默认值,不是不可修改的常量。运行容器时可以使用 -e 覆盖:

bash
docker run --rm -e APP_ENV=test -e APP_PORT=9090 workdir-env-demo:1.0

预期输出:

text
env=test
port=9090
pwd=/workspace

这使同一镜像可以在测试、预发布和生产环境复用。环境差异应由运行参数或编排平台注入,而不是为每个环境重新复制一份 Dockerfile。

常见边界

ARG 主要服务于构建阶段,ENV 会保留到最终镜像并传递给容器进程。需要参与构建但不应留在运行环境中的值,优先考虑 ARG;涉及敏感信息时,应使用构建密钥或运行时密钥管理机制。

环境变量最终都是字符串。应用读取端口、布尔值或列表时,应在程序中完成类型转换和合法性校验,避免把无效配置带到运行阶段。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用 WORKDIR 与 ENV

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

登录哪都通