容器与云原生 / 系统课时
使用 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;涉及敏感信息时,应使用构建密钥或运行时密钥管理机制。
环境变量最终都是字符串。应用读取端口、布尔值或列表时,应在程序中完成类型转换和合法性校验,避免把无效配置带到运行阶段。
按自己的节奏,确认真正理解。