Dockerfile 概述

Dockerfile 文件

这一切都始于 Dockerfile。

Docker 通过读取 Dockerfile 中的说明来构建镜像。一个 Dockerfile 是一个文本文件，其中包含构建源的说明法典。Dockerfile 指令语法由规范定义 Dockerfile 引用中的 reference。

以下是最常见的说明类型：

指令	描述
`FROM <image>`	定义镜像的基础。
`RUN <command>`	在当前镜像之上的新层中执行任何命令并提交结果。`RUN`还有一个用于运行命令的 shell 形式。
`WORKDIR <directory>`	设置任何`RUN`,`CMD`,`ENTRYPOINT`,`COPY`和`ADD`说明。
`COPY <src> <dest>`	从中复制新文件或目录`<src>`并将它们添加到路径`<dest>`.
`CMD <command>`	允许您定义在基于此镜像启动容器后运行的默认程序。每个 Dockerfile 只有一个`CMD`，并且只有最后一个`CMD`当存在多个实例时，将遵循 instance。

Dockerfile 是镜像构建的关键输入，可以促进自动化、基于您的独特配置构建多层镜像。Dockerfile 可以从简单开始，然后根据您的需求进行扩展，以支持更复杂的场景。

文件名

用于 Dockerfile 的默认文件名是Dockerfile、没有文件外延。使用默认名称允许您运行docker build命令而无需指定其他命令标志。

某些项目可能需要不同的 Dockerfile 来实现特定目的。常见的惯例是命名这些<something>.Dockerfile.您可以指定 Dockerfile 文件名--fileflag 的docker build命令。请参阅docker buildCLI 参考了解--file旗。

注意
我们建议使用默认的（Dockerfile）用于项目的 primary Dockerfile 文件。

Docker 镜像

Docker 镜像由层组成。每个层都是构建的结果指令。层按顺序堆叠，每个层都是表示应用于上一层的更改的增量。

例

以下是使用 Docker 构建应用程序的典型工作流程。

以下示例代码显示了一个用 Python，使用 Flask 框架。

from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
    return "Hello World!"

为了在没有 Docker Build 的情况下发布和部署此应用程序，您需要需要确保：

所需的运行时依赖项安装在服务器上
Python 代码被上传到服务器的文件系统
服务器使用必要的参数启动您的应用程序

以下 Dockerfile 创建一个容器镜像，其中包含所有依赖项，这会自动启动您的应用程序。

# syntax=docker/dockerfile:1
FROM ubuntu:22.04

# install app dependencies
RUN apt-get update && apt-get install -y python3 python3-pip
RUN pip install flask==3.0.*

# install app
COPY hello.py /

# final configuration
ENV FLASK_APP=hello
EXPOSE 8000
CMD ["flask", "run", "--host", "0.0.0.0", "--port", "8000"]

以下是此 Dockerfile 的用途：

Dockerfile 语法
基本镜像
环境设置
评论
安装依赖项
复制文件
设置环境变量
暴露的端口
启动应用程序

Dockerfile 语法

要添加到 Dockerfile 的第一行是# syntaxparser 指令. 虽然是可选的，但此指令指示 Docker 构建器使用什么语法解析 Dockerfile 时，并允许启用了 BuildKit 的旧版 Docker 在解析开始构建。解析器指令必须出现在您的 Dockerfile，并且应该是 Dockerfile 中的第一行。

# syntax=docker/dockerfile:1

提示
我们建议使用docker/dockerfile:1，它始终指向最新的版本 1 语法的发布。BuildKit 会自动检查语法，确保您使用的是最新版本。

基本镜像

语法指令后面的行定义要使用的基础镜像：

FROM ubuntu:22.04

这FROM指令设置您的基础镜像复制到 Ubuntu 的 22.04 版本。执行以下所有指令在此基础镜像中：Ubuntu 环境。符号ubuntu:22.04遵循这name:tag标准来命名 Docker 镜像。在构建镜像时，您使用此表示法为您的镜像命名。您可以利用，方法是使用 Dockerfile 文件FROM指令。

Docker Hub 包含大量可用于此目的的官方镜像。

环境设置

以下行在基础镜像中执行生成命令。

# install app dependencies
RUN apt-get update && apt-get install -y python3 python3-pip

这RUN指令执行 shell 更新 APT 包索引并在容器。

请注意# install app dependencies线。这是一条评论。评论 Dockerfile 以符号开头。随着 Dockerfile 的发展，注释可以有助于为未来的读者记录 Dockerfile 的工作原理以及文件的编辑者，包括未来的自己！#

注意
您可能已经注意到，注释使用与文件第一行的语法指令相同的符号表示。仅当模式与指令，并显示在 Dockerfile 的开头。否则，它是视为评论。

安装依赖项

第二个RUN指令会安装flask依赖项所需的 Python 应用程序。

RUN pip install flask==3.0.*

此说明的先决条件是pip安装到内部版本中容器。第一个RUN命令安装pip，这确保我们可以使用命令安装 Flask Web 框架。

复制文件

下一条指令使用COPY指令要将hello.py文件从本地构建上下文复制到我们镜像的根目录中。

COPY hello.py /

构建上下文是您可以访问的文件集在 Dockerfile 指令中，例如COPY和ADD.

在COPY指令、hello.pyfile 已添加到文件系统生成容器。

设置环境变量

如果您的应用程序使用环境变量，则可以设置环境变量在 Docker 构建中使用ENV指令.

ENV FLASK_APP=hello

这将设置我们稍后需要的 Linux 环境变量。Flask，框架在此示例中，使用此变量启动应用程序。没有这个， Flask 不知道在哪里可以找到我们的应用程序来运行它。

暴露的端口

这EXPOSE指令标记我们的最终镜像有一个 Service 侦听端口8000.

EXPOSE 8000

此说明不是必需的，但这是一种很好的做法，有助于工具和团队成员了解此应用程序正在做什么。

启动应用程序

最后CMD指令将命令，该命令在用户基于此镜像启动容器时运行。

CMD ["flask", "run", "--host", "0.0.0.0", "--port", "8000"]

此命令启动 Flask 开发服务器，侦听所有地址在端口8000.此处的示例使用 “exec form” 版本的CMD. 也可以使用 “shell form”：

CMD flask run --host 0.0.0.0 --port 8000

这两个版本之间存在细微的差异，例如，在它们如何捕获SIGTERM和SIGKILL. 有关这些差异的更多信息，请参阅 Shell 和 exec 表单

建筑

要使用上一节中的 Dockerfile 示例构建容器镜像，请使用docker build命令：

$ docker build -t test:latest .

这-t test:latestoption 指定镜像的名称和标记。

单个点（.）将 build 上下文设置为当前目录。这意味着 build 需要找到 Dockerfile，并且hello.py目录中的文件其中调用命令。如果这些文件不存在，则构建将失败。

构建镜像后，您可以将应用程序作为容器运行，其中包含docker run，指定镜像名称：

$ docker run -p 127.0.0.1:8000:8000 test:latest

这会将容器的端口 8000 发布到http://localhost:8000在 Docker 主机。

Dockerfile 概述

APP信息