Dockerfile是什么，你如何编写一个？

Question

Accepted Answer

一个**Dockerfile**是一个文本文件，包含**构建Docker镜像**的指令——它描述基础镜像、依赖项、要复制的文件，以及如何运行应用程序。它使镜像构建可重复和版本可控。

## 基本Dockerfile

```dockerfile
# FROM — the base image to build on
FROM node:20-alpine

# WORKDIR — set the working directory inside the image
WORKDIR /app

# COPY dependency files first (for better layer caching)
COPY package*.json ./
# RUN — execute a command during the BUILD (install dependencies)
RUN npm install

# COPY the rest of the application code
COPY . .

# EXPOSE — document the port the app listens on
EXPOSE 3000

# CMD — the command to run when a CONTAINER starts
CMD ["node", "server.js"]
```

## 关键指令

```text
FROM     → the base image (starting point) — REQUIRED, usually first
WORKDIR  → set the working directory for subsequent instructions
COPY/ADD → copy files from the host into the image
RUN      → execute a command at BUILD time (install packages, compile) → creates a layer
ENV      → set environment variables
EXPOSE   → document which port(s) the container listens on
CMD      → the default command to run when the container STARTS (one per Dockerfile)
ENTRYPOINT → the executable that runs (CMD provides default args to it)
ARG      → build-time variables
```

## RUN与CMD与ENTRYPOINT（常见混淆）

```text
RUN        → runs at BUILD time (builds the image — e.g. install dependencies)
CMD        → runs at CONTAINER START (the default command; overridable at run)
ENTRYPOINT → the main executable at start (CMD becomes its default arguments)
→ RUN builds the image; CMD/ENTRYPOINT define what runs when it starts.
```

## 为什么这很重要

理解Dockerfile是必要的，因为这是Docker镜像的构建方式，所以编写它是一项基础的、日常的Docker技能。

Dockerfile提供了**可重复、版本可控的镜像构建**——用代码精确描述如何构造镜像（基础镜像、依赖项、文件、配置和运行命令），使任何人都能一致地构建相同的镜像，这是Docker可重复性价值的核心。

理解**关键指令**是必要的——`FROM`（基础镜像）、`WORKDIR`、`COPY`（引入文件）、`RUN`（执行构建时命令，如安装依赖项）、`ENV`、`EXPOSE`，以及`CMD`/`ENTRYPOINT`（定义容器启动时运行的内容）——这对于为真实应用程序编写有效的Dockerfile是必需的。

一个特别重要且常见的混淆点是**`RUN`与`CMD`与`ENTRYPOINT`的区别**：`RUN`在**构建时**执行（构造镜像，例如安装包），而`CMD`/`ENTRYPOINT`定义**容器启动时**运行的内容（应用程序命令）——理解这一点可以防止常见错误。

了解实际模式（例如在代码之前复制依赖文件以获得更好的层缓存）反映了编写高效Dockerfile的能力。

由于构建镜像是使用Docker的基础（每个Docker工作流都涉及镜像，而Dockerfile是自定义镜像的构建方式），并且由于理解指令和构建时与运行时的区别是创建正确、高效镜像的必要条件，理解Dockerfile是必要的、经常应用的Docker知识——对于任何使用Docker的人来说都是核心技能，是将Docker的可重复性承诺转化为实践的机制，也是容器化应用程序的几乎通用要求。