Docker Build 指定环境变量详解
在使用 Docker 进行应用容器化时，docker build 是构建镜像的重要指令。通过指定环境变量，我们可以灵活地调整镜像构建的各种参数。本文将介绍如何在 Dockerfile 中通过 ARG 和 ENV 指令使用环境变量，并提供相应的代码示例。
概念介绍
在 Dockerfile 中，环境变量主要有两种类型：
- ARG：用于在构建时传递参数。这种变量只在构建过程中可见，构建完成后会消失。
- ENV：用于设置容器运行时的环境变量。这种变量在镜像中留存，可在容器运行时使用。
下面我们将详细介绍如何使用这些变量。
使用 ARG 指令
使用 ARG 指令定义的变量可以在 docker build 命令中通过 --build-arg 进行传递。
代码示例
以下是一个简单的 Dockerfile 示例，展示如何使用 ARG 指令：
# 使用基础镜像
FROM ubuntu:20.04
# 定义构建参数
ARG APP_VERSION
# 安装应用及其依赖
RUN apt-get update && \
apt-get install -y curl
# 复制应用文件
COPY myapp /usr/local/bin/myapp
# 显示应用版本
RUN echo "Application version is ${APP_VERSION}"
在构建该镜像时，通过命令行传递 APP_VERSION 参数：
docker build --build-arg APP_VERSION=1.0 -t myapp:1.0 .
通过上述命令，构建过程将会打印出指定的应用版本。
使用 ENV 指令
ENV 指令用于为容器设置环境变量。当我们需要让容器运行时能够访问某些变量时，使用 ENV 显得尤为重要。
代码示例
下面的 Dockerfile 示例展示了如何使用 ENV 指令定义环境变量：
# 使用基础镜像
FROM python:3.9
# 设置环境变量
ENV APP_HOME /usr/src/app
# 创建工作目录
RUN mkdir -p $APP_HOME
# 设置工作目录
WORKDIR $APP_HOME
# 复制应用文件
COPY . .
# 安装依赖
RUN pip install -r requirements.txt
# 运行应用
CMD ["python", "app.py"]
在这个示例中，APP_HOME 是一个环境变量，在容器运行时可以用来访问应用目录。
环境变量对比表格
| 变量类型 | 作用范围 | 作用 |
|---|---|---|
| ARG | 构建阶段 | 仅在镜像构建时可用 |
| ENV | 运行阶段 | 在容器内部可用，持续有效 |
关系图示
为了更好地理解 Dockerfile 中的环境变量，下面通过 ER 图展现它们之间的关系：
erDiagram
ARG {
string APP_VERSION
}
ENV {
string APP_HOME
}
docker_build ||--o{ ARG : uses
docker_build ||--o{ ENV : sets
docker_build ||--o{ RUN : executes
结论
通过使用 ARG 和 ENV 指令，我们可以在 Docker 构建过程中灵活地对环境变量进行管理。ARG 适合于一次性的构建参数，而 ENV 更适合于需要在容器运行时保持的配置。理解这两种变量的使用方式，对于优化 Dockerfile、提高构建效率至关重要。希望本文能帮助你更好地掌握 Docker 的使用！
