目录
一、简介
Compose
是用于定义和运行多容器 Docker 应用程序的工具。通过 Compose
,您可以使用 YML
文件来配置应用程序需要的所有服务。然后,使用一个命令,就可以从YML
文件配置中创建并启动所有服务。
Compose
使用的三个步骤:
- 使用
Dockerfile
定义应用程序的环境。 - 使用
docker-compose.yml
定义构成应用程序的服务,这样它们可以在隔离环境中一起运行。 - 最后,执行
docker-compose up
命令来启动并运行整个应用程序。
二、编写yml文件
1. 示例
[root@bogon ~]# cat docker-compose.yml
version: "3"
services:
redis:
image: redis:alpine
ports:
- "6379"
networks:
- frontend
deploy:
replicas: 2
update_config:
parallelism: 2
delay: 10s
restart_policy:
condition: on-failure
db:
image: postgres:9.4
volumes:
- db-data:/var/lib/postgresql/data
networks:
- backend
deploy:
placement:
constraints: [node.role == manager]
vote:
image: dockersamples/examplevotingapp_vote:before
ports:
- "5000:80"
networks:
- frontend
depends_on:
- redis
deploy:
replicas: 2
update_config:
parallelism: 2
restart_policy:
condition: on-failure
result:
image: dockersamples/examplevotingapp_result:before
ports:
- "5001:80"
networks:
- backend
depends_on:
- db
deploy:
replicas: 1
update_config:
parallelism: 2
delay: 10s
restart_policy:
condition: on-failure
worker:
image: dockersamples/examplevotingapp_worker
networks:
- frontend
- backend
deploy:
mode: replicated
replicas: 1
labels: [APP=VOTING]
restart_policy:
condition: on-failure
delay: 10s
max_attempts: 3
window: 120s
placement:
constraints: [node.role == manager]
visualizer:
image: dockersamples/visualizer:stable
ports:
- "8080:8080"
stop_grace_period: 1m30s
volumes:
- "/var/run/docker.sock:/var/run/docker.sock"
deploy:
placement:
constraints: [node.role == manager]
networks:
frontend:
backend:
volumes:
db-data:
2. yml 配置指令参考
- version 定义了版本信息
- services 定义了服务的配置信息
- networks 定义了网络信息,提供给 services 中的 具体容器使用
- volumes 定义了卷信息,提供给 services 中的 具体容器使用
2.1 container_name
指定容器名称。默认将会使用 项目名称_服务名称_序号 这样的格式。(生产环境中不太经常使用)
container_name: docker-web-container
2.2 在构建时应用的配置选项
2.2.1 bulid
指定 Dockerfile 所在文件夹的路径(可以是绝对路径,或者相对 docker-compose.yml
文件的路径)。 Compose 将会利用它自动构建这个镜像,然后使用这个镜像。
类似于命令行的 docker build .
version: '3'
services:
webapp:
build: ./dir
2.2.2 image
指定为镜像名称或镜像 ID。如果镜像在本地不存在,Compose 将会尝试拉取这个镜像。
image: ubuntu
image: orchardup/postgresql
image: a4bc65fd
如果同时指定了 image
和 build
, image
不在具有单独使用它的意义,而是指定了目前要构建的镜像的名称。 也就是说 Compose
会使用 build
指令中指定的 Dockerfile
构建的镜像,之后构建的镜像名称使用 image
中指定的名字 webapp:tag
命名。
build: ./dir
image: webapp:tag
3. command
使用 command
可以覆盖容器启动后默认执行的命令。
和dockerfile里面的意思一样
command: bundle exec thin -p 3000
4. depends_on
解决容器的依赖、启动先后的问题。以下例子中会先启动容器 db
和 redis
再启动 web
version: '3'
services:
web:
build: .
depends_on:
- db
- redis
redis:
image: redis
db:
image: postgres
注意:web 服务不会等待 redis 和 db 「完全启动」之后才启动。
5. environment
设置环境变量。
你可以使用数组或字典两种格式。
只给定名称的变量会自动获取运行 Compose
主机上对应变量的值,可以用来防止泄露不必要的数据。
environment:
RACK_ENV: development
SESSION_SECRET:
environment:
- RACK_ENV=development
- SESSION_SECRET
6. expose
暴露端口,但不映射到宿主机,只被其他容器连接到此容器时使用。
仅可以指定容器内部的端口为参数
expose:
- "3000"
- "8000"
7. ports
映射端口信息。
格式:
宿主端口:容器端口 (即:HOST:CONTAINER
) 的格式格式,或者仅仅指定容器的端口(宿主将会随机选择端口)都可以。
ports:
- "3000"
- "8000:8000"
- "49100:22"
- "127.0.0.1:8001:8001"
8. extra_hosts
类似 Docker 中的 --add-host
参数,指定额外的 host
名称映射信息
extra_hosts:
- "googledns:8.8.8.8"
- "dockerhub:52.1.157.61"
会在启动后的容器中 /etc/hosts
文件中添加如下两条条目。
8.8.8.8 googledns
52.1.157.61 dockerhub
9. networks
要加入的网络,使用*networks
定义下的条目 。
services:
some-service:
networks:
- some-network
- other-network
networks:
some-network:
other-network:
9.1 指定 IPv4
version: "2.4"
services:
app:
image: busybox
command: ifconfig
networks:
app_net:
ipv4_address: 172.16.238.10
# 创建网络
networks:
app_net:
driver: bridge
ipam:
driver: default
config:
- subnet: 172.16.238.0/24
gateway: 172.16.238.1
10. aliases
网络上此服务的别名(备用主机名)。同一网络上的其他容器可以使用服务名称或此别名连接到其中一个服务的容器。
由于aliases
是网络范围的,因此相同的服务可以在不同的网络上具有不同的别名。
services:
some-service:
networks:
some-network:
aliases:
- alias1
other-network:
aliases:
- alias2
11. healthcheck
通过命令检查容器是否健康运行。
healthcheck:
test: ["CMD", "curl", "-f", "http://localhost"]
interval: 1m30s
timeout: 10s
retries: 3
12. logging
配置日志选项。
logging:
driver: syslog
options:
syslog-address: "tcp://192.168.0.42:123"
13. volumes
数据卷所挂载路径设置。可以设置宿主机路径 (HOST:CONTAINER) 或加*问模式 (HOST:CONTAINER:ro)。
该指令中路径支持相对路径。
volumes:
- /var/lib/mysql
- cache/:/tmp/cache
- ~/configs:/etc/configs/:ro
13.2 卷的 bind 和 volume 的混合使用示例
version: "3.2"
services:
web:
image: nginx:alpine
volumes:
# 卷 (volume)
- type: volume
source: mydata
target: /data
volume:
nocopy: true
# 挂载 (bind)
- type: bind
source: ./static
target: /opt/app/static
db:
image: postgres:latest
volumes:
- "/var/run/postgres/postgres.sock:/var/run/postgres/postgres.sock"
- "dbdata:/var/lib/postgresql/data"
volumes:
mydata:
dbdata:
14. 关于容器的限制的参数
14.1 sysctls
配置容器内核参数。
sysctls:
net.core.somaxconn: 1024
net.ipv4.tcp_syncookies: 0
sysctls:
- net.core.somaxconn=1024
- net.ipv4.tcp_syncookies=0
14.2 ulimits
指定容器的 ulimits 限制值。
例如,指定最大进程数为 65535,指定文件句柄数为 20000(软限制,应用可以随时修改,不能超过硬限制) 和 40000(系统硬限制,只能 root 用户提高)。
ulimits:
nproc: 65535
nofile:
soft: 20000
hard: 40000