Dockerfile完全指南：构建镜像的核心技术详解
Dockerfile基础概念
Dockerfile是一个采用特殊语法编写的文本文件，其中包含了构建Docker镜像所需的各种指令。通过解析这些指令，Docker能够自动化地创建符合预期的镜像文件。在实际项目中，开发者通常使用docker build命令来读取Dockerfile并执行构建流程。
如果Dockerfile位于非标准路径，可以通过-f参数显式指定文件位置：
docker build -f /path/to/a/Dockerfile
Dockerfile的内部组织结构
标准的Dockerfile通常由四个核心部分组成：基础镜像声明区、Metadata信息区、构建指令区和容器启动配置区。在Dockerfile中，使用#符号开头的行表示注释，解析器会自动忽略这些内容。
Docker引擎按照指令在文件中出现的顺序依次执行它们。第一条有效指令必须指定基础镜像，这意味着FROM指令通常位于文件开头位置。
核心指令详解
FROM：指定构建基础镜像
格式：
FROM <image>
FROM <image>:<tag>
FROM <image>@<digest>
示例：
FROM nginx:alpine
FROM python:3.9-slim
该指令用于指定构建过程所基于的初始镜像。如果不指定tag标签，系统会自动采用latest标签对应的镜像版本。
MAINTAINER：镜像维护者信息
格式：
MAINTAINER <name>
示例：
MAINTAINER zhangsan@example.com
MAINTAINER lisi <lisi@example.com>
用于记录镜像的维护者联系方式，虽然该指令不影响镜像功能，但有助于问题追踪和责任明确。
RUN：镜像构建时执行的命令
RUN执行方式一：shell模式
RUN <command>
RUN执行方式二：exec模式（推荐）
RUN ["executable", "param1", "param2"]
示例：
RUN apt-get update
RUN ["python", "-m", "pip", "install", "requests"]
RUN /bin/sh -c "echo hello"
RUN指令会在当前镜像层中执行命令并提交结果。构建缓存机制会自动复用已有的中间镜像层。如需禁用缓存，可添加--no-cache参数。
COPY：复制本地文件到镜像
格式：
COPY <src>... <dest>
COPY ["<src>",... "<dest>"] # 支持包含空格的路径
示例：
COPY app.py /app/
COPY requirements.txt /app/
COPY ["my files", "/app/directory"]
COPY指令与ADD类似，但功能更为基础。它不支持自动解压tar文件，也无法直接访问网络资源。
ADD：高级文件复制功能
格式：
ADD <src>... <dest>
ADD ["<src>",... "<dest>"]
示例：
ADD config.json /etc/app/
ADD dist/*.js /var/www/html/
ADD package.tar.gz /opt/
ADD指令在COPY的基础上增加了两个特性：支持tar文件自动解压、能够从URL下载网络资源。
CMD：容器启动时的默认命令
格式：
CMD ["executable","param1","param2"] # 优先执行形式
CMD ["param1","param2"] # 传递给ENTRYPOINT的参数形式
CMD command param1 param2 # shell内部执行形式
示例：
CMD ["python", "app.py"]
CMD echo "Container started" && /bin/bash
每个Dockerfile只能存在一个CMD指令，多余的会被覆盖。CMD在镜像构建时不执行，仅在容器启动时起作用。
ENTRYPOINT：容器入口点配置
格式：
ENTRYPOINT ["executable", "param1", "param2"]
ENTRYPOINT command param1 param2
示例：
FROM ubuntu
ENTRYPOINT ["ls", "-la"]
CMD ["/var/log"]
ENTRYPOINT与CMD的配合使用是常见模式：ENTRYPOINT定义可执行程序，CMD提供默认参数。运行容器时传递的参数会追加到ENTRYPOINT之后。注意Dockerfile中只允许一个ENTRYPOINT指令。
LABEL：镜像元数据标签
格式：
LABEL <key>=<value> <key>=<value> ...
示例：
LABEL version="2.0" maintainer="team@example.com"
LABEL description="Web应用镜像" org.opencontainers.image.source="https://github.com/example"
通过LABEL可以为镜像添加各种元数据信息。建议将所有标签合并到一条指令中，避免生成过多中间镜像层。
ENV：环境变量设置
格式：
ENV <key> <value>
ENV <key>=<value> ...
示例：
ENV APP_ENV production
ENV JAVA_HOME=/usr/lib/jvm/java-11
ENV PATH=$PATH:/usr/local/bin
ENV指令用于在镜像中设置持久化的环境变量。这些变量在容器运行时会自动生效。复杂值可以使用反斜杠进行换行。
EXPOSE：声明容器监听端口
格式：
EXPOSE <port> [<port>...]
示例：
EXPOSE 8080
EXPOSE 443 80
EXPOSE 3306/tcp 3306/udp
EXPOSE仅起到文档声明作用，不会自动将端口映射到宿主机。实际访问需要通过docker run -p参数进行端口映射。
VOLUME：定义持久化存储卷
格式：
VOLUME ["/path/to/dir"]
示例：
VOLUME ["/var/data"]
VOLUME ["/var/logs", "/var/www"]
特性说明：
1. 允许多个容器共享同一数据卷
2. 数据卷独立于容器生命周期
3. 对卷的修改立即生效且不影响镜像
4. 容器停止后数据仍然保留
WORKDIR：设置工作目录
格式：
WORKDIR /path/to/workdir
示例：
WORKDIR /workspace
WORKDIR $APP_HOME/src
WORKDIR /project/backend
WORKDIR为后续的RUN、CMD、ENTRYPOINT、ADD、COPY等指令设置工作目录。路径可以是绝对路径，也可以是相对路径。可以使用-w参数在运行时覆盖。
USER：指定运行用户身份
格式：
USER username
USER username:groupname
USER uid
UID:gid
示例：
USER appuser
USER appuser:appgroup
USER 1001
USER指令改变后续指令执行时的用户身份。合理使用可以增强容器安全性，避免以root用户运行服务。运行时可通过-u参数覆盖。
ARG：构建时参数定义
格式：
ARG <name>[=<default value>]
示例：
ARG version
ARG build_mode=debug
ARG base_image=ubuntu:22.04
ARG定义的是构建阶段可见的变量，不同于ENV，这些变量不会持久化到最终镜像中。可以通过docker build --build-arg传递实际值。
ONBUILD：触发器机制
格式：
ONBUILD [INSTRUCTION]
示例：
ONBUILD ADD sources /app/src
ONBUILD RUN npm install
ONBUILD定义的指令不会在当前构建中执行，而是作为元数据存储在镜像中。当其他镜像将该镜像作为基础镜像进行构建时，这些指令会被触发执行。
综合示例：构建Nginx镜像
# 基础镜像选择
FROM centos:7
# 维护者信息
MAINTAINER techteam <support@example.com>
# 设置环境变量
ENV NGINX_VERSION=1.24.0
ENV PATH=/usr/local/nginx/bin:$PATH
# 复制所需文件
ADD nginx-${NGINX_VERSION}.tar.gz /usr/local/
ADD run.sh /usr/local/nginx/bin/
# 安装系统依赖
RUN yum install -y \
openssl \
pcre \
pcre-devel \
gcc \
make \
wget \
&& yum clean all \
&& useradd -r -s /sbin/nologin nginxuser
# 设置工作目录
WORKDIR /usr/local/nginx-${NGINX_VERSION}
# 编译安装Nginx
RUN ./configure \
--prefix=/usr/local/nginx \
--user=nginxuser \
--group=nginxuser \
--with-http_ssl_module \
--with-pcre \
&& make \
&& make install
# 配置Nginx为前台运行
RUN echo "daemon off;" >> /usr/local/nginx/conf/nginx.conf
# 声明服务端口
EXPOSE 80 443
# 启动命令
CMD ["/usr/local/nginx/bin/nginx"]
核心指令执行流程图
以下图表展示了各指令在镜像构建和容器运行阶段的执行时机：
