Docker Compose
能够以单引擎模式进行多容器应用的部署和管理
安装
win10
在win10上安装标准Docker时,默认已经有Docker Compose了,可以通过以下命令查看
docker-compose --version
Linux
使用curl命令下载二进制文件,然后使用chmod命令将其可运行
最新发行的版本地址:https://github.com/docker/compose/releases
#Step1:
sudo curl -L "https://github.com/docker/compose/releases/download/1.24.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
#Step2:
sudo chmod +x /usr/local/bin/docker-compose
#Step3:创建软链接
sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose
配置文件及常用指令
Docker Compose使用YAML来定义多服务的应用。YAML是JSON的子集,因此也可以使用JSON
如下是一个Compose文件的示例
version: "3.5"
services:
web-fe:
build: .
command: python app.py
ports:
- target: 5000
published: 5000
networks:
- counter-net
volumes:
- type: volume
source: counter-vol
target: /code
redis:
image: "redis:alpine"
networks:
counter-net:
networks:
counter-net:
volumes:
counter-vol:
yaml配置指令参考
version
指定本yaml基于的compose哪个版本制定的
build
指定为构建镜像上下文路径:例如webapp服务,指定上下文路径为./dir
version: "3.7"
services:
webapp:
build:
context: ./dir
dockerfile: Dockerfile-alternate
args:
buildno: 1
labels:
- "com.example.description=Accounting webapp"
- "com.example.department=Finance"
- "com.example.label-with-empty-value"
target: prod
- context:上下文路径
- dockerfile:指定构建镜像的Dockerfile文件名
- args:添加构建参数,这是只能在构建过程中访问的环境变量
- labels:设置构建镜像的标签
- target:多层构建情况下,可以指定构建哪一层
cap_add,cap_drop
添加或删除容器拥有的宿主机的内核功能
cap_add:
- ALL #开启全部权限
cap_drop:
- SYS_PTRACE #关闭ptrace功能
cgroup_parent
为容器指定父cgroup组,意味着将继承该组的资源限制
cgroup_parent: m-executor-abcd
command
覆盖容器启动的默认命令
command: ["bundle", "exec", "thin","-p", "3000"]
container_name
指定自定义容器名称,而不是生成的默认名称
container_name: my-web-container
depends_on
设置依赖关系
- docker-compose up:以依赖性顺序启动服务。在以下示例中,先启动db和redis,才会启动web
- docker-compose up SERVICE:自动包含SERVICE的依赖项。在以下示例中,docker-compose up web还将创建并启动db和redis
- docker-compose stop:按依赖关系顺序停止服务。在以下示例中,web在db和redis之前停止
version: "3.7"
services:
web:
build:
depends_on:
- db
- redis
redis:
image: redis
db:
image: postgres
注意:web服务不会等待redis db完全启动之后才启动
deploy
指定与服务的部署和运行有关的配置。只在swarm模式下才会有用
ersion: "3.7"
services:
redis:
image: redis:alpine
deploy:
mode: replicated
replicas: 6
endpoint_mode: dnsrr
labels:
description: "This redis service label"
resources:
limits:
cpus: '0.50'
memory: 50M
reservations:
cpus: '0.25'
memory: 20M
restart_policy:
condition: on-failure
delay: 5s
max_attempts: 3
window: 120s
可选参数:
-
endpoint_mode:访问集群服务的方式
endpoint_mode: vip #docker 集群服务一个对外的虚拟IP。所有的请求都会通过这个虚拟IP到达集群服务内部的机器 endpoint_mode: dnsrr # DNS 轮询(DNSRR)。所有的请求会自动轮询获取到集群ip列表中的一个IP地址
-
labels: 在服务上设置标签。可以用容器上的 labels(跟 deploy 同级的配置) 覆盖 deploy 下的 labels
-
mode:指定服务提供的模式
- replicated:复制服务,复制指定服务到集群的机器上
- global:全局服务,服务将部署至集群的每个节点
图解:下图黄色方块是replicated,灰色方块是global
-
replicas: mode为replicated时,需要使用此参数配置具体运行的节点数量
-
resources:配置服务器资源使用的限制,例如限制cpu的百分比和内存占用
-
restart_policy:配置如何在退出容器时重新启动容器
- condition:可选none,on-failure或者any(默认any)
- delay:设置多久之后重启(默认值:0)
- max_attempts:尝试重新启动容器的次数,超出次数,则不再尝试(默认值:一直重试)
- window:设置容器重启超时时间(默认值:0)
-
rollback_config:配置在更新失败的情况下应如何回滚服务
- parallelism:一次要回滚的容器数。如果设置为0,则所有容器将同时回滚。
- delay:每个容器组回滚之间等待的时间(默认为0s)。
- failure_action:如果回滚失败,该怎么办。其中一个 continue 或者 pause(默认pause)。
- monitor:每个容器更新后,持续观察是否失败了的时间 (ns|us|ms|s|m|h)(默认为0s)。
- max_failure_ratio:在回滚期间可以容忍的故障率(默认为0)。
- order:回滚期间的操作顺序。其中一个 stop-first(串行回滚),或者 start-first(并行回滚)(默认 stop-first )。
-
update_config:配置应如何更新服务,对于配置滚动更新很有用。
- parallelism:一次更新的容器数。
- delay:在更新一组容器之间等待的时间。
- failure_action:如果更新失败,该怎么办。其中一个 continue,rollback 或者pause (默认:pause)。
- monitor:每个容器更新后,持续观察是否失败了的时间 (ns|us|ms|s|m|h)(默认为0s)。
- max_failure_ratio:在更新过程中可以容忍的故障率。
- order:回滚期间的操作顺序。其中一个 stop-first(串行回滚),或者 start-first(并行回滚)(默认stop-first)。
devices
指定设备映射列表
devices:
- "/dev/ttyUSB0:/dev/ttyUSB0"
dns
自定义 DNS 服务器,可以是单个值或列表的多个值
dns: 8.8.8.8
dns:
- 8.8.8.8
- 9.9.9.9
dns_search
自定义 DNS 搜索域。可以是单个值或列表
dns_search: example.com
dns_search:
- dc1.example.com
- dc2.example.com
entrypoint
覆盖容器默认的 entrypoint
entrypoint: /code/entrypoint.sh
entrypoint:
- php
- -d
- zend_extension=/usr/local/lib/php/extensions/no-debug-non-zts-20100525/xdebug.so
- -d
- memory_limit=-1
- vendor/bin/phpunit
env_file
从文件添加环境变量。可以是单个值或列表的多个值
env_file: .env
env_file:
- ./common.env
- ./apps/web.env
- /opt/secrets.env
environment
添加环境变量。您可以使用数组或字典、任何布尔值,布尔值需要用引号引起来,以确保 YML 解析器不会将其转换为 True 或 False
environment:
RACK_ENV: development
SHOW: 'true'
expose
暴露端口,但不映射到宿主机,只被连接的服务访问。
仅可以指定内部端口为参数:
expose:
- "3000"
- "8000"
extra_hosts
添加主机名映射。类似docker client --add-host
extra_hosts:
- "somehost:162.242.195.82"
- "otherhost:50.31.209.229"
以上会在此服务的内部容器中 /etc/hosts 创建一个具有 ip 地址和主机名的映射关系
162.242.195.82 somehost
50.31.209.229 otherhost
healthcheck
用于检测 docker 服务是否健康运行。
healthcheck:
test: ["CMD", "curl", "-f", "http://localhost"] # 设置检测程序
interval: 1m30s # 设置检测间隔
timeout: 10s # 设置检测超时时间
retries: 3 # 设置重试次数
start_period: 40s # 启动后,多少秒开始启动检测程序
image
指定容器运行的镜像。以下格式都可以:
image: redis
image: ubuntu:14.04
image: tutum/influxdb
image: example-registry.com:4000/postgresql
image: a4bc65fd # 镜像id
logging
服务的日志记录配置
driver:指定服务容器的日志记录驱动记录,默认值为json-file。有以下三个选项
driver: "json-file"
driver: "syslog"
driver: "none"
仅在json-file驱动程序下,可以使用以下参数,限制日志的数量和大小
logging:
driver: json-file
options:
max-size: "200k" # 单个文件大小为200k
max-file: "10" # 最多10个文件
达到文件限制上限,会自动删除旧得文件。
syslog 驱动程序下,可以使用 syslog-address 指定日志接收地址。
logging:
driver: syslog
options:
syslog-address: "tcp://192.168.0.42:123"
network_mode
设置网络模式
network_mode: "bridge"
network_mode: "host"
network_mode: "none"
network_mode: "service:[service name]"
network_mode: "container:[container name/id]"
networks
配置容器连接的网络。示例:
services:
some-service:
networks:
some-network:
aliases:
- alias1
other-network:
aliases:
- alias2
networks:
some-network:
# Use a custom driver
driver: custom-driver-1
other-network:
# Use a custom driver which takes special options
driver: custom-driver-2
- aliases :同一网络上的其他容器可以使用服务名称或此别名来连接到对应容器的服务。
restart
- no:是默认的重启策略,在任何情况下都不会重启容器。
- always:容器总是重新启动。
- on-failure:在容器非正常退出时(退出状态非0),才会重启容器。
- unless-stopped:在容器退出时总是重启容器,但是不考虑在Docker守护进程启动时就已经停止了的容器
restart: "no"
restart: always
restart: on-failure
restart: unless-stopped
注:swarm集群模式,请改用restart_policy
secrets
存储敏感数据,例如密码:
version: "3.1"
services:
mysql:
image: mysql
environment:
MYSQL_ROOT_PASSWORD_FILE: /run/secrets/my_secret
secrets:
- my_secret
secrets:
my_secret:
file: ./my_secret.txt
security_opt
修改容器默认的 schema 标签
security-opt:
- label:user:USER # 设置容器的用户标签
- label:role:ROLE # 设置容器的角色标签
- label:type:TYPE # 设置容器的安全策略标签
- label:level:LEVEL # 设置容器的安全等级标签
stop_grace_period
指定在容器无法处理 SIGTERM (或者任何 stop_signal 的信号),等待多久后发送 SIGKILL 信号关闭容器
stop_grace_period: 1s # 等待 1 秒
stop_grace_period: 1m30s # 等待 1 分 30 秒
默认的等待时间是 10 秒
stop_signal
设置停止容器的替代信号。默认情况下使用 SIGTERM
以下示例,使用 SIGUSR1 替代信号 SIGTERM 来停止容器
stop_signal: SIGUSR1
sysctls
设置容器中的内核参数,可以使用数组或字典格式
sysctls:
net.core.somaxconn: 1024
net.ipv4.tcp_syncookies: 0
sysctls:
- net.core.somaxconn=1024
- net.ipv4.tcp_syncookies=0
tmpfs
在容器内安装一个临时文件系统。可以是单个值或列表的多个值
tmpfs: /run
tmpfs:
- /run
- /tmp
ulimits
覆盖容器默认的 ulimit
ulimits:
nproc: 65535
nofile:
soft: 20000
hard: 40000
volumes
将主机的数据卷或着文件挂载到容器里
version: "3.7"
services:
db:
image: postgres:latest
volumes:
- "/localhost/postgres.sock:/var/run/postgres/postgres.sock"
- "/localhost/data:/var/lib/postgresql/data"