打包您的软件
Dockerfile
一切从 Dockerfile 开始。
Docker 通过读取 Dockerfile 中的指令来构建镜像。Dockerfile 是一个文本文件,其中包含构建源代码的指令。Dockerfile 指令语法由Dockerfile 参考中的规范参考定义。
以下是最常见的指令类型
指令 | 描述 |
---|---|
FROM <image> | 定义镜像的基础。 |
RUN <command> | 在当前镜像之上执行新层中的任何命令,并提交结果。RUN 还有用于运行命令的 shell 形式。 |
WORKDIR <directory> | 为之后的任何RUN 、CMD 、ENTRYPOINT 、COPY 和 ADD 指令设置工作目录。 |
COPY <src> <dest> | 从 <src> 复制新文件或目录,并将它们添加到容器的文件系统中的 <dest> 路径。 |
CMD <command> | 让您定义启动基于此镜像的容器后运行的默认程序。每个 Dockerfile 只有一个 CMD ,并且只有最后一个 CMD 实例在多个实例存在时有效。 |
Dockerfile 是镜像构建的关键输入,可以根据您的独特配置促进自动化的多层镜像构建。Dockerfile 可以从简单开始,随着您的需求增长,支持更复杂的情况。
文件名
Dockerfile 的默认文件名是 Dockerfile
,没有文件扩展名。使用默认名称允许您运行 docker build
命令,而无需指定其他命令标志。
某些项目可能需要针对特定目的的不同 Dockerfile。一个常见的约定是将这些文件命名为 <something>.Dockerfile
。您可以使用 docker build
命令的 --file
标志指定 Dockerfile 文件名。请参阅docker build
CLI 参考以了解有关 --file
标志的信息。
注意
我们建议您为项目的首要 Dockerfile 使用默认值 (
Dockerfile
)。
Docker 镜像
Docker 镜像由层组成。每层都是 Dockerfile 中构建指令的结果。层按顺序堆叠,每个层都是表示对前一层所做的更改的增量。
示例
以下是使用 Docker 构建应用程序的典型工作流程。
以下示例代码展示了一个用 Python 编写的简单“Hello World”应用程序,它使用 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 的第一行是 # syntax
解析器指令。虽然可选,但此指令指示 Docker 构建器在解析 Dockerfile 时使用什么语法,并允许使用 启用 BuildKit 的较旧 Docker 版本在开始构建之前使用特定的 Dockerfile 前端。 解析器指令 必须出现在 Dockerfile 中的任何其他注释、空格或 Dockerfile 指令之前,并且应该是 Dockerfile 的第一行。
# syntax=docker/dockerfile:1
提示
我们建议使用
docker/dockerfile:1
,它始终指向版本 1 语法的最新版本。BuildKit 会在构建之前自动检查语法的更新,确保您使用的是最新版本。
基础镜像
语法指令后面的行定义要使用的基础镜像
FROM ubuntu:22.04
The FROM
instruction 将您的基础镜像设置为 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
This RUN
instruction 在 Ubuntu 中执行一个 shell,它会更新 APT 包索引并在容器中安装 Python 工具。
注释
注意 # install app dependencies
行。这是一个注释。Dockerfile 中的注释以 #
符号开头。随着 Dockerfile 的发展,注释对于记录 Dockerfile 的工作原理至关重要,以供将来阅读和编辑该文件的所有人员使用,包括您自己!
注意
您可能已经注意到,注释使用与 语法指令 相同的符号来表示,该指令位于文件的首行。如果模式与指令匹配并且出现在 Dockerfile 的开头,则该符号仅被解释为指令。否则,它将被视为注释。
安装依赖项
第二个 RUN
指令安装 Python 应用程序所需的 flask
依赖项。
RUN pip install flask==3.0.*
此指令的先决条件是将 pip
安装到构建容器中。第一个 RUN
命令安装了 pip
,它确保我们可以使用该命令来安装 Flask Web 框架。
复制文件
下一个指令使用 COPY
指令 将 hello.py
文件从本地构建上下文复制到镜像的根目录。
COPY hello.py /
一个 构建上下文 是您可以在 Dockerfile 指令(如 COPY
和 ADD
)中访问的一组文件。
在 COPY
指令之后,hello.py
文件将被添加到构建容器的文件系统中。
设置环境变量
如果您的应用程序使用环境变量,则可以使用 ENV
指令 在 Docker 构建中设置环境变量。
ENV FLASK_APP=hello
这会设置一个稍后将需要使用的 Linux 环境变量。本例中使用的框架 Flask 使用此变量来启动应用程序。如果没有此变量,Flask 不会知道在哪里找到我们的应用程序才能运行它。
公开端口
The EXPOSE
instruction 标记最终镜像上有一个服务正在监听端口 8000
。
EXPOSE 8000
此指令不是必需的,但它是一种最佳实践,可以帮助工具和团队成员了解此应用程序正在执行的操作。
启动应用程序
最后,CMD
instruction 设置用户启动基于此镜像的容器时运行的命令。
CMD ["flask", "run", "--host", "0.0.0.0", "--port", "8000"]
此命令启动监听所有地址上的端口 8000
的 Flask 开发服务器。此处的示例使用 CMD
的“exec 形式”。也可以使用“shell 形式”
CMD flask run --host 0.0.0.0 --port 8000
这两个版本之间存在细微差异,例如它们捕获信号(如SIGTERM
和 SIGKILL
)的方式不同。有关这些差异的更多信息,请参阅 Shell 和 exec 形式
构建
要使用 上一节 中的 Dockerfile 示例构建容器镜像,请使用 docker build
命令
$ docker build -t test:latest .
-t test:latest
选项指定镜像的名称和标签。
命令末尾的单点 (.
) 将 构建上下文 设置为当前目录。这意味着构建期望在调用命令的目录中找到 Dockerfile 和 hello.py
文件。如果这些文件不存在,则构建失败。
镜像构建完成后,您可以使用 docker run
运行应用程序作为容器,并指定镜像名称
$ docker run -p 127.0.0.1:8000:8000 test:latest
这将容器的端口 8000 发布到 Docker 主机上的 http://localhost:8000
。
其他资源
如果您对其他语言(如 Go)的示例感兴趣,请查看我们指南部分中的 特定于语言的指南。
有关构建的更多信息,包括高级用例和模式,请参阅 使用 Docker 构建 指南。