Dockerfile语法详解

Dockerfile是用于创建Docker镜像的脚本，包含了一系列指令，用来指定基础镜像、安装软件、复制文件、配置环境变量以及定义容器启动命令等。本篇文章将详细讲解Dockerfile的基本语法及常用指令，帮助大家理解和编写Dockerfile。

Dockerfile常用语法

在Dockerfile中，每一条指令都指定了如何构建镜像的一个层面。以下是一些最常见的指令及其描述：

  • FROM <image>：定义了用作镜像基础的基础镜像。所有Dockerfile都必须从一个FROM指令开始，除非是用作另一个构建阶段的基础的Dockerfile。
  • RUN <command>：在当前镜像上的新层中执行任何命令，并提交结果。这意味着每个RUN指令添加了新的镜像层。RUN有两种形式：一种是shell形式（RUN <command>），另一种是exec形式（RUN ["executable", "param1", "param2"]）。
  • WORKDIR <directory>：设置任何随后的RUN、CMD、ENTRYPOINT、COPY和ADD指令的工作目录。如果指定的目录不存在，Docker会自动为你创建这个目录。
  • COPY <src> <dest>：从构建上下文复制新文件或目录到镜像中的路径<dest>。构建上下文是指Dockerfile所在目录的路径。
  • CMD <command>：定义容器启动时默认运行的程序。每个Dockerfile中只能有一个CMD指令，如果存在多个，只有最后一个CMD会被采用。

Dockerfile是构建Docker镜像的关键输入之一，能够基于你的独特配置来促进基于多层的自动化镜像构建。Dockerfile可以从简单的开始，随着你的需求增长，它可以支持更复杂的场景。

FROM 指令

FROM指令用于指定构建新镜像所基于的基础镜像。每一个Dockerfile必须以FROM指令开始，除非使用的是ARG指令来定义参数化的基础镜像。

FROM ubuntu:20.04

RUN 指令

RUN指令用于在镜像内执行命令，通常用于安装软件包。RUN指令可以有两种形式：shell形式和exec形式。

  • Shell形式：在shell中执行命令，默认使用/bin/sh -c。
RUN apt-get update && apt-get install -y nginx
  • Exec形式：提供一个JSON数组，直接执行可执行文件。
RUN ["apt-get", "update"]

CMD 指令

CMD指令用于指定容器启动时要执行的命令。一个Dockerfile中只能有一个CMD指令，如果指定了多个，只有最后一个生效。CMD指令也有两种形式：shell形式和exec形式。

  • Shell形式：
CMD echo "Hello, World!"
  • Exec形式：
CMD ["echo", "Hello, World!"]

ENTRYPOINT 指令

ENTRYPOINT指令与CMD类似，用于指定容器启动时执行的命令，但ENTRYPOINT的优先级高于CMD。ENTRYPOINT也有两种形式：shell形式和exec形式。

  • Shell形式：
ENTRYPOINT echo "Hello, World!"
  • Exec形式：
ENTRYPOINT ["echo", "Hello, World!"]

COPY 指令

COPY指令用于将文件或目录从构建上下文复制到镜像文件系统中。COPY指令有两个参数：源路径和目标路径。

COPY ./myapp /app

ADD 指令

ADD指令与COPY类似，但功能更为强大。除了复制文件外，ADD还可以解压缩tar文件并支持URL。

ADD myapp.tar.gz /app
ADD http://example.com/file /file

ENV 指令

ENV指令用于设置环境变量，这些环境变量在构建镜像以及运行容器时均可用。

ENV APP_ENV=production

EXPOSE 指令

EXPOSE指令用于声明容器运行时监听的端口，但不会实际开放端口，需要在运行容器时使用-p参数来映射端口。

EXPOSE 80

VOLUME 指令

VOLUME指令用于指定容器挂载的卷，卷可以用于持久化数据。

VOLUME /data

USER 指令

USER指令用于指定运行容器时的用户。

USER appuser

WORKDIR 指令

WORKDIR指令用于设置工作目录，后续的指令（如RUN、CMD、ENTRYPOINT等）都将在这个目录下执行。

WORKDIR /app

HEALTHCHECK 指令

HEALTHCHECK指令用于指定容器的健康检查命令及其参数。

HEALTHCHECK --interval=30s --timeout=10s --retries=3 CMD curl -f http://localhost/ || exit 1

QA

什么是基础镜像？

基础镜像（Base Image）是Docker镜像中最底层的镜像，它提供了构建新镜像的基础环境。基础镜像通常是操作系统的最小化版本，例如Ubuntu、Alpine、CentOS等，或者是一些预先配置好的应用环境，如Node.js、Python等。这些镜像可以直接从Docker Hub或其他镜像仓库中获取，并作为构建自定义镜像的起点。

为什么使用基础镜像？

使用基础镜像的主要原因是可以重用现有的环境配置，避免从零开始构建操作系统和软件包。这样不仅可以节省时间，还能确保一致性和可靠性。例如，如果你需要一个运行Node.js应用的容器，可以直接使用官方的Node.js基础镜像，这样可以确保你的应用运行在一个已经配置好并经过测试的环境中。