这是 docker-compose 的快速参考备忘单。你可以在这里找到最常见的 Docker Compose 使用方式。
Docker-compsoe
是一个开源项目,用于定义和运行多容器 Docker
应用程序的工具。由 Docker
社区维护。YAML
文件来配置应用程序的服务,以便可以使用一个命令启动、停止和重启整个应用程序。Docker
容器,其中运行着应用程序的一个实例。Docker
镜像,用于创建容器的模板。YAML
文件,描述了应用程序的各个服务以及它们之间的关系、配置等信息。version
: Docker-Compose 文件的版本。services
: 定义了各个服务,每个服务都有自己的配置项,如镜像、端口映射、依赖等。networks
: 定义了应用程序使用的网络,可以自定义网络以控制服务之间的通信。volumes
: 定义了应用程序使用的卷,用于持久化数据或与主机共享文件。对于 Ubuntu 和 Debian,运行:
sudo apt-get update
sudo apt-get install docker-compose-plugin
对于基于 RPM 的发行版,运行:
sudo yum update
sudo yum install docker-compose-plugin
通过检查版本来验证 Docker Compose 是否正确安装
docker compose version
# Docker Compose version v2.17.3
docker --version
# Docker version 23.0.5, build bc4487a
docker version
# Client: Docker Engine - Community
# Cloud integration: v1.0.31
# Version: 23.0.5
# API version: 1.42
# <...>
curl -SL https://github.com/docker/compose/releases/download/v2.27.0/docker-compose-linux-x86_64 -o /usr/local/bin/docker-compose
如果命令 docker-compose
安装失败,请检查你的路径。你也可以创建一个符号链接,指向 /usr/bin
或路径中的任何其他目录。例如
$ sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose
对于 Ubuntu 和 Debian,运行:
sudo apt-get update
sudo apt-get install docker-compose-plugin
对于基于 RPM 的发行版,运行:
sudo yum update
sudo yum install docker-compose-plugin
Ubuntu, Debian:
sudo apt-get remove docker-compose-plugin
基于 RPM 的发行版
sudo yum remove docker-compose-plugin
如果您使用curl安装Compose CLI插件,要卸载它,请运行:
rm $DOCKER_CONFIG/cli-plugins/docker-compose
为所有用户删除,或者,如果您已为所有用户安装 Compose,请运行:
rm /usr/local/lib/docker/cli-plugins/docker-compose
docker info --format '{{range .ClientInfo.Plugins}}{{if eq .Name "compose"}}{{.Path}}{{end}}{{end}}'
docker compose命令 | 说明 | 常见参数说明 |
---|---|---|
docker compose up | 启动容器 | -d 后台运行容器 |
docker compose down | 停止容器 | -v 删除容器和卷 |
docker compose logs | 查看容器日志 | -f 跟随日志输出 |
docker compose exec | 进入容器 | -it 启动交互式终端 |
docker compose pull | 拉取镜像 | |
docker compose build | 构建镜像 | |
docker compose images | 列出镜像 | |
docker compose push | 推送镜像 | |
docker compose config | 显示配置信息 | |
docker compose version | 查看版本信息 |
docker compose命令 | 说明 |
---|---|
docker compose stop | 停止容器 |
docker compose start | 启动容器 |
docker compose rm | 删除容器 |
docker compose restart | 重启容器 |
docker compose run | 运行一个临时容器 |
docker compose ps | 查看容器状态 |
docker-compose
的配置文件是一个 YAML
文件,用于定义和运行多容器 Docker 应用程序。通常命名为 docker-compose.yml
,它使用单一的 YAML 文件来定义多个容器的集合,以及它们之间的依赖关系和服务。以下是一份 docker-compose.yml
文件的配置模板,包含了常用配置项和解释:
name: myapp
version: '3' # 已过时
services: # 定义一个或多个服务
service1: # 服务名称
image: nginx:latest # 使用的 Docker 镜像,这里是 Nginx 的最新版本
# 或者使用构建指令来从 Dockerfile 构建镜像
build:
context: ./path/to/Dockerfile # Dockerfile 所在的目录
dockerfile: Dockerfile-alternative # 可选的 Dockerfile 名称,默认是 Dockerfile
# 容器启动时执行的命令,覆盖默认的命令
command:
- "nginx"
- "-g"
- "daemon off;" # 以数组形式指定,防止 shell 解析
ports: # 容器端口与主机端口映射
- "80:80" # 主机 80 端口映射到容器的 80 端口
volumes: # 数据卷挂载
- ./nginx.conf:/etc/nginx/nginx.conf:ro # 将主机上的 nginx.conf
# 挂载到容器的 /etc/nginx/nginx.conf,只读
- ./logs:/var/log/nginx # 将 logs 目录挂载到容器的 /var/log/nginx
environment: # 设置环境变量
- MYSQL_HOST=database # 可以引用其他服务,这里假设有一个名为 database 的服务
- MYSQL_PORT=3306
depends_on: # 服务启动顺序,这里表明 service1 依赖于 database 服务
- database
networks: # 定义网络
- my_network # 参与名为 my_network 的网络
service2: # 另一个服务示例
# ... 类似地定义其他服务
networks: # 定义网络
my_network: # 网络名称
driver: bridge # 网络驱动,通常是 bridge 模式
volumes: # 定义数据卷
nginx_logs: # 卷名称
备忘录事项
docker-compose.yml
文件后,需要重新运行 docker-compose up
来使改动生效。docker-compose build
仅重建镜像,而不启动容器。docker-compose restart
重启容器。与 docker run -e VARIABLE=VALUE ...
相同
web:
environment:
- DEBUG=1
您可以选择不设置值并将环境变量从 shell 直接传递到容器。它的工作方式与 docker run -e VARIABLE ...
相同:
web:
environment:
- DEBUG
web:
environment:
- DEBUG=${DEBUG}
env_file
属性允许您在 Compose 应用程序中使用多个 .env
文件。
它的工作方式与 docker run --env-file=FILE ...
相同。
web:
env_file:
- web-variables.env
env_file:
- path: ./default.env
required: true # default
- path: ./override.env
required: false
.env
文件中声明的环境变量不能在 Compose 文件中单独再次引用。env_file
和 environment
属性,则由 environment
设置的环境变量优先级更高。env_file
属性中指定的 .env
文件的路径是相对于 compose.yml 文件的位置的。.env
文件中的值可以通过使用 docker compose run -e
命令行来从命令行覆盖。--env-file
替换了另一个 .env
,则您的 .env
文件可以被另一个 .env
文件覆盖。required
字段将 .env
文件设置为可选项。当 required
设置为 false
且 .env
文件丢失时,Compose 将静默忽略该条目image: redis
image: redis:5
image: redis@sha256:0ed5d5928d473745...
image: library/redis
image: docker.io/library/redis
image: my_private.registry:5000/redis
ports:
# 将容器的端口 3000 映射到主机的随机端口
- "3000"
# 将容器的端口范围从 3000 到 3005 映射到主机的相同端口范围
- "3000-3005"
# 将容器的端口 8000 映射到主机的端口 8000
- "8000:8000"
# 将容器的端口范围从 8080 到 8081 映射到主机的端口范围从 9090 到 9091
- "9090-9091:8080-8081"
# 将容器的端口 22(SSH端口)映射到主机的端口 49100
- "49100:22"
# 将容器的端口范围从 8000 到 9000 映射到主机的端口 80
- "8000-9000:80"
# 将容器的端口 8001 映射到主机的 127.0.0.1 地址的端口 8001
- "127.0.0.1:8001:8001"
# 将容器的端口范围从 5000 到 5010 映射到主机的 127.0.0.1 地址的相同端口范围
- "127.0.0.1:5000-5010:5000-5010"
# 将容器的 UDP 端口 6060 映射到主机的端口 6060
- "6060:6060/udp"
暴露容器端口
platform: darwin
platform: windows/amd64
platform: linux/arm64/v8
定义了服务容器运行的目标平台。值必须符合 OCI Image Spec 使用的约定
会覆盖容器镜像声明的默认命令,例如 Dockerfile 的 CMD。
command: bundle exec thin -p 3000
该值也可以是一个列表,其方式类似于 Dockerfile:
command: [ "bundle", "exec", "thin", "-p", "3000" ]
如果该值为 null,则使用映像中的默认命令。如果值为 [](空列表)或 ''(空字符串),则忽略图像声明的默认命令,即覆盖为空。
services:
web:
build: .
depends_on:
- db
- redis
redis:
image: redis
db:
image: postgres
服务之间的启动和关闭依赖关系。
下面的示例显示了双服务设置,其中数据库的数据目录作为名为 db-data 的卷与另一个服务共享,以便定期备份。
services:
backend:
image: example/database
volumes:
- db-data:/etc/data
backup:
image: backup-service
volumes:
- db-data:/var/lib/backup/data
volumes:
db-data:
db-data 卷安装在 /var/lib/backup/data
和 /etc/data
容器路径中,分别用于备份和后端。如果卷尚不存在,则运行 docker compose up
会创建该卷。否则,如果在 Compose 外部手动删除现有卷,则会使用并重新创建现有卷。
指定应使用哪个卷驱动程序。如果驱动程序不可用,Compose 将返回错误并且不会部署应用程序。
volumes:
db-data:
driver: foobar
指定一个选项列表,作为键值对传递给此卷的驱动程序。这些选项取决于驾驶员。
volumes:
example:
driver_opts:
type: "nfs"
o: "addr=10.40.0.199,nolock,soft,rw"
device: ":/docker/example"
services:
backend:
image: example/database
volumes:
- db-data:/etc/data
volumes:
db-data:
external: true
在示例中,Compose 不会尝试创建名为 {project_name}_db-data
的卷,而是查找名为 db-data
的现有卷,并将其挂载到后端服务的容器中。
标签用于将元数据添加到卷中。您可以使用数组或字典。
volumes:
db-data:
labels:
com.example.description: "Database volume"
com.example.department: "IT/Ops"
com.example.label-with-empty-value: ""
volumes:
db-data:
labels:
- "com.demo.description=Database volume"
- "com.demo.department=IT/Ops"
- "com.demo.label-with-empty-value"
设置卷的自定义名称。名称字段可用于引用包含特殊字符的卷。该名称按原样使用,并且不受堆栈名称的限制。
volumes:
db-data:
name: "my-app-data"
这使得可以将此查找名称作为 Compose 文件的参数,以便卷的模型 ID 被硬编码,但平台上的实际卷 ID 是在部署期间在运行时设置的。例如,如果 .env
文件中的 DATABASE_VOLUME=my_volume_001
:
volumes:
db-data:
name: ${DATABASE_VOLUME}
它还可以与外部属性结合使用。这意味着用于在平台上查找实际卷的卷名称与用于在 Compose 文件中引用它的名称分开设置:
volumes:
db-data:
external:
name: actual-name-of-volume
services:
some-service:
networks:
- some-network
- other-network
声明网络上服务的替代主机名。同一网络上的其他容器可以使用服务名称或别名来连接到服务的容器之一
services:
some-service:
networks:
some-network:
aliases:
- alias1
- alias3
other-network:
aliases:
- alias2
在以下示例中,服务前端能够通过主机名 backend
或者 back-tier
网络上的数据库来访问 backend
服务。服务 monitoring
能够在 admin 网络上通过主机名 backend
或者 mysql
来访问相同的 backend
服务。
services:
frontend:
image: example/webapp
networks:
- front-tier
- back-tier
monitoring:
image: example/monitoring
networks:
- admin
backend:
image: example/backend
networks:
back-tier:
aliases:
- database
admin:
aliases:
- mysql
networks:
front-tier:
back-tier:
admin:
加入网络时,为服务容器指定静态IP地址。
services:
frontend:
image: example/webapp
networks:
front-tier:
ipv4_address: 172.16.238.10
ipv6_address: 2001:3984:3989::10
networks:
front-tier:
ipam:
driver: default
config:
- subnet: "172.16.238.0/24"
- subnet: "2001:3984:3989::/64"
指定了链接本地IP的列表。链路本地IP是属于知名子网的特殊IP,纯粹由运营商管理,通常取决于部署它们的架构。
services:
app:
image: busybox
command: top
networks:
app_net:
link_local_ips:
- 57.123.22.11
- 57.123.22.13
networks:
app_net:
driver: bridge
设置服务容器连接特定网络时使用的 MAC 地址。
将服务的容器连接到其网络的顺序。如果未指定,默认值为 0。在以下示例中,应用服务首先连接到 app_net_1
,因为它具有最高优先级。然后它连接到 app_net_3
,然后是 app_net_2
,后者使用默认优先级值 0。
services:
app:
image: busybox
command: top
networks:
app_net_1:
priority: 1000
app_net_2:
app_net_3:
priority: 100
networks:
app_net_1:
app_net_2:
app_net_3:
expose:
- "3000"
- "8000"
- "8080-8085/tcp"
定义 Compose 从容器公开的(传入)端口或端口范围。这些端口必须可供链接服务访问,并且不应发布到主机。只能指定内部容器端口。
web:
links:
- db
- db:database
- redis
定义到另一个服务中的容器的网络链接。同时指定服务名称和链接别名 (SERVICE:ALIAS),或者仅指定服务名称。
pids_limit: 10
调整容器的 PID 限制。设置为 -1 以获取无限 PID。
devices:
- "/dev/ttyUSB0:/dev/ttyUSB0"
- "/dev/sda:/dev/xvda:rwm"
定义已创建容器的设备映射列表
HOST_PATH:CONTAINER_PATH[:CGROUP_PERMISSIONS]
dns: 8.8.8.8
dns:
- 8.8.8.8
- 9.9.9.9
定义在容器网络接口配置上设置的自定义 DNS 服务器。它可以是单个值或列表。
dns_opt:
- use-vc
- no-tld-query
列出要传递给容器的 DNS 解析器(Linux 上的 /etc/resolv.conf 文件)的自定义 DNS 选项。
dns_search: example.com
dns_search:
- dc1.example.com
- dc2.example.com
定义在容器网络接口配置上设置的自定义 DNS 搜索域。它可以是单个值或列表。