Docker Compose 文件格式版本 3 参考
本文档详细介绍了 Compose 文件格式的版本 3,这是目前广泛使用的最新版本。我们将涵盖兼容性矩阵、服务配置、网络与卷管理以及高级特性。
兼容性矩阵
Compose 文件格式包含多个版本(1、2.x、3.x)。下表展示了不同 Compose 文件版本所支持的 Docker 引擎版本:
| 编写文件格式 | Docker 引擎发布 |
|---|---|
| 3.9 | 19.03.0+ |
| 3.8 | 19.03.0+ |
| 3.7 | 18.06.0+ |
| 3.6 | 18.02.0+ |
| 3.5 | 17.12.0+ |
| 3.4 | 17.09.0+ |
| 3.3 | 17.06.0+ |
| 3.2 | 17.04.0+ |
| 3.1 | 1.13.1+ |
| 3.0 | 1.13.0+ |
| 2.4 | 17.12.0+ |
| 2.3 | 17.06.0+ |
| 2.2 | 1.13.0+ |
| 2.1 | 1.12.0+ |
| 2.0 | 1.10.0+ |
最新的 Compose 文件格式由官方定义,并由 Docker Compose 1.27.0+ 实现。注意,文件格式版本的更新并不总是与 Compose 工具本身的版本同步。
服务配置参考
Compose 文件默认路径为 ./docker-compose.yml,也可以使用 .yaml 扩展名。服务定义类似于将命令行参数传递给 docker run,而网络和卷定义则对应 docker network create 和 docker volume create。
提示:在配置值中可以使用类似 Bash 的
${VARIABLE}语法引用环境变量。
build
指定构建时的配置选项。
- 字符串形式:指定构建上下文路径。
version: "3.9"
services:
webapp:
build: ./dir
- 对象形式:指定路径、Dockerfile 名称及构建参数。
version: "3.9"
services:

