编写 Dockerfile

解释

Dockerfile 是一个基于文本的文档，用于创建容器镜像。它向镜像构建器提供指令，说明要运行的命令、要复制的文件、启动命令等。

例如，以下 Dockerfile 将生成一个可立即运行的 Python 应用程序

FROM python:3.13
WORKDIR /usr/local/app

# Install the application dependencies
COPY requirements.txt ./
RUN pip install --no-cache-dir -r requirements.txt

# Copy in the source code
COPY src ./src
EXPOSE 5000

# Setup an app user so the container doesn't run as the root user
RUN useradd app
USER app

CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8080"]

常用指令

Dockerfile 中一些最常见的指令包括

• FROM <image> - 这指定了构建将要扩展的基础镜像。
• WORKDIR <path> - 此指令指定了“工作目录”或镜像中将要复制文件和执行命令的路径。
• COPY <host-path> <image-path> - 此指令告诉构建器从主机复制文件并将其放入容器镜像中。
• RUN <command> - 此指令告诉构建器运行指定的命令。
• ENV <name> <value> - 此指令设置一个环境变量，正在运行的容器将使用该变量。
• EXPOSE <port-number> - 此指令在镜像上设置配置，指示镜像希望公开的端口。
• USER <user-or-uid> - 此指令为所有后续指令设置默认用户。
• CMD ["<command>", "<arg1>"] - 此指令设置使用此镜像的容器将运行的默认命令。

要通读所有指令或了解更多详细信息，请查看 Dockerfile 参考。

试一试

正如您在前面的示例中看到的，Dockerfile 通常遵循以下步骤

1. 确定您的基础镜像
2. 安装应用程序依赖项
3. 复制任何相关的源代码和/或二进制文件
4. 配置最终镜像

在这个快速实践指南中，您将编写一个 Dockerfile 来构建一个简单的 Node.js 应用程序。如果您不熟悉基于 JavaScript 的应用程序，请不要担心。这对于遵循本指南不是必需的。

设置

下载此 ZIP 文件 并将其内容解压到您计算机上的一个目录中。

如果您不想下载 ZIP 文件，请克隆 https://github.com/docker/getting-started-todo-app 项目并检出 build-image-from-scratch 分支。

创建 Dockerfile

现在您已经拥有了项目，可以开始创建 Dockerfile 了。

1. 下载并安装 Docker Desktop。

2. 在与 package.json 文件相同的文件夹中创建一个名为 Dockerfile 的文件。

   Dockerfile 文件扩展名

   需要注意的是，Dockerfile 没有 文件扩展名。一些编辑器会自动为文件添加扩展名（或抱怨它没有扩展名）。

3. 在 Dockerfile 中，通过添加以下行来定义您的基础镜像

   FROM node:22-alpine

4. 现在，使用 WORKDIR 指令定义工作目录。这将指定未来命令的运行位置以及文件将复制到容器镜像内的目录。

   WORKDIR /app

5. 通过使用 COPY 指令将您计算机上项目中的所有文件复制到容器镜像中

   COPY . .

6. 使用 yarn CLI 和包管理器安装应用的依赖项。为此，请使用 RUN 指令运行一个命令

   RUN yarn install --production

7. 最后，使用 CMD 指令指定要运行的默认命令

   CMD ["node", "./src/index.js"]

   这样，您应该有了以下 Dockerfile

   FROM node:22-alpine
   WORKDIR /app
   COPY . .
   RUN yarn install --production
   CMD ["node", "./src/index.js"]

此 Dockerfile 尚未达到生产就绪状态

需要注意的是，此 Dockerfile 尚未遵循所有最佳实践（这是有意为之的）。它会构建应用程序，但构建速度不会那么快，镜像也不会那么安全。

继续阅读以了解更多关于如何使镜像最大化利用构建缓存、以非 root 用户身份运行以及多阶段构建的信息。

使用 docker init 快速容器化新项目

docker init 命令会分析您的项目并快速创建一个 Dockerfile、一个 compose.yaml 和一个 .dockerignore，帮助您快速上手。由于您在这里专门学习 Dockerfile，所以现在不会使用它。但是，您可以在此处了解更多信息。

其他资源

要了解更多关于编写 Dockerfile 的信息，请访问以下资源

• Dockerfile 参考
• Dockerfile 最佳实践
• 基础镜像
• Docker Init 入门

后续步骤

现在您已经创建了一个 Dockerfile 并学习了基础知识，是时候了解如何构建、标记和推送镜像了。