### Dockerfile 的基本语法和格式说明 Dockerfile 是由一系列命令和参数构成的脚本，用于定义构建镜像的完整过程。通过 `docker build` 命令执行 Dockerfile 中的一系列指令，可以自动构建镜像[^1]。 #### 1. 指令概述 Dockerfile 支持多种指令，常见的指令包括但不限于以下几种： - **FROM**：指定基础镜像，所有 Dockerfile 必须以 FROM 指令开头。 - **LABEL**：为镜像添加元数据，例如作者信息、版本号等[^5]。 - **RUN**：在镜像中执行命令，通常用于安装软件或配置环境。 - **CMD**：定义容器启动时默认执行的命令，每个 Dockerfile 中只能有一个 CMD 指令[^3]。 - **ENTRYPOINT**：定义容器启动时运行的命令，与 CMD 类似但优先级更高[^2]。 - **ENV**：设置环境变量，供后续指令使用。 - **COPY** 和 **ADD**：将文件从主机复制到镜像中。 - **WORKDIR**：设置工作目录，后续指令将在该目录下执行。 - **EXPOSE**：声明容器运行时监听的端口，仅供参考。 - **VOLUME**：创建挂载点，允许数据在容器之间或主机与容器之间共享。 #### 2. 指令示例 以下是一个完整的 Dockerfile 示例，展示了常用指令的用法： ```dockerfile # 指定基础镜像 FROM centos:7 # 设置环境变量 ENV APP_HOME=/usr/local/app \ APP_VERSION=1.0 # 创建工作目录 WORKDIR $APP_HOME # 安装依赖 RUN yum update -y && \ yum install -y vim net-tools && \ yum clean all # 复制文件到镜像中 COPY src/ . # 暴露端口 EXPOSE 8080 # 设置标签 LABEL maintainer="example@example.com" \ version="1.0" # 定义启动命令 CMD ["bash", "-c", "echo Hello World"] ``` #### 3. 指令详解 - **FROM**：指定基础镜像，格式为 `FROM <image>:<tag>`，例如 `FROM centos:7`。这是 Dockerfile 的第一个指令，用于定义镜像的基础环境[^1]。 - **LABEL**：为镜像添加元数据，支持键值对形式。例如： ```dockerfile LABEL "com.example.vendor"="ACME Incorporated" ``` 可以有多个 LABEL 指令[^5]。 - **RUN**：执行命令，通常用于安装软件包或配置环境。推荐将多条命令合并为一条，以减少镜像层数。例如： ```dockerfile RUN yum update -y && yum install -y vim && yum clean all ``` - **CMD** 和 **ENTRYPOINT**：两者都用于定义容器启动时执行的命令，但 ENTRYPOINT 更适合定义不可变的入口点，而 CMD 则作为默认参数。例如： ```dockerfile CMD ["echo", "Hello World"] ENTRYPOINT ["/bin/bash", "-c"] ``` - **ENV**：设置环境变量，供后续指令使用。例如： ```dockerfile ENV APP_HOME=/usr/local/app ``` - **COPY** 和 **ADD**：将文件从主机复制到镜像中。区别在于 ADD 支持更多功能（如解压归档文件），但 COPY 更加直观和安全。例如： ```dockerfile COPY src/ $APP_HOME/ ``` - **WORKDIR**：设置工作目录，后续指令将在该目录下执行。例如： ```dockerfile WORKDIR /app ``` - **EXPOSE**：声明容器运行时监听的端口，仅供 Docker 客户端参考。例如： ```dockerfile EXPOSE 8080 ``` #### 4. 构建镜像 编写完成后，可以通过以下命令构建镜像： ```bash docker build -t my-image:1.0 . ``` 其中 `-t` 参数用于指定镜像名称和标签，`.` 表示 Dockerfile 所在的上下文目录[^4]。 ---