Docker-compose(多容器编排工具)

docker-compose(多容器编排工具)

（一）.docker-compose介绍

docker-compose是docker官方的多容器编排工具，用于定义和运行多容器 Docker 应用程序的工具。在学习使用docker-compose之前必须要了解YAML语言的用法。YAML语言是一种非常简单的语言，非常适合人类逻辑去理解，下一篇笔者会具体介绍。

（二）.docker-compose使用步骤

1.使用 docker-compose.yml 定义构成应用程序的服务和环境，这样它们可以在隔离环境中一起运行
2.用docker-compose up 来启动整个docker应用程序的运行

（三）.docker-compose使用安装实例

1.docker-compose的安装检测
（1）.安装docker-compose
(最新发行的版本地址：https://github.com/docker/compose/releases)
[root@localhost ~]# curl -L “https://github.com/docker/compose/releases/download/1.24.1/docker-compose-$(uname-s)-$(uname -m)” -o /usr/local/bin/docker-compose
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 651 100 651 0 0 374 0 0:00:01 0:00:01 --:–:-- 374

(2).给docker-compose添加执行权限
[root@localhost ~]# cd /usr/local/bin/
[root@localhost bin]# chmod a+x docker-compose

(3).创建软连接
[root@localhost bin]# ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

(4).测试镜像是否成功
[root@localhost bin]# docker-compose --version
docker-compose version 1.24.1, build 4667896b

2.配置docker-compose.yml文件
vim docker-compose.yml
version: ‘2’

services:
db:
image: mysql:5.7
restart: always
environment:
MYSQL_ROOT_PASSWORD: somewordpress
MYSQL_DATABASE: wordpress
MYSQL_USER: wordpress
MYSQL_PASSWORD: wordpress

wordpress:
depends_on:
- db
image: wordpress:latest
restart: always
ports:
- “8000:80”
environment:
WORDPRESS_DB_HOST: db:3306
WORDPRESS_DB_USER: wordpress
WORDPRESS_DB_PASSWORD: wordpress

3.docker-compose启动及检测
[root@localhost bin]# docker-compose up
Pulling db (mysql:5.7)…

docker-compose常用命令

1.docker-compose -f 路径 start/stop（指定yml文件位置）
[root@localhost local]# docker-compose -f /usr/local/bin/docker-compose.yml stop
Stopping bin_wordpress_1 … done
Stopping bin_db_1 … done

2.docker-compose ps(显示所有容器信息)
[root@localhost bin]# docker-compose ps Name Command State Ports

bin_db_1 docker-entrypoint.sh mysqld Exit 0
bin_wordpress_1 docker-entrypoint.sh apach … Exit 0

3.docker-compose start/stop(启动)
4.docker-compose logs(查看日志)
5.docker-compose pause/unpause（暂停/启动）
6.docker-compose config -q (验证配置文件是否正确)
7.docker-compose rm (删除容器)
8.docker-compose up -d (启动容器项目)
#和docker常用命令差不多

(四).yml文件配置文件详解

1.version：指定本 yml 依从的 compose 哪个版本制定的。
2.build：指定为构建镜像上下文路径：
例如 webapp 服务，指定为从上下文路径 ./dir/Dockerfile 所构建的镜像：
version: “3.7”
services:
webapp:
build: ./dir
或者，作为具有在上下文指定的路径的对象，以及可选的 Dockerfile 和 args：

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：多层构建，可以指定构建哪一层。

3.cap_add，cap_drop
添加或删除容器拥有的宿主机的内核功能。
cap_add:

• ALL # 开启全部权限
  cap_drop:
• SYS_PTRACE # 关闭 ptrace权限

4.cgroup_parent
为容器指定父 cgroup 组，意味着将继承该组的资源限制。
cgroup_parent: m-executor-abcd

5.command
覆盖容器启动的默认命令。
command: [“bundle”, “exec”, “thin”, “-p”, “3000”]

6.container_name
指定自定义容器名称，而不是生成的默认名称。
container_name: my-web-container

7.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 之前停止。

8.deploy
指定与服务的部署和运行有关的配置。只在 swarm 模式下才会有用。

9.endpoint_mode：访问集群服务的方式。
endpoint_mode: vip
#Docker 集群服务一个对外的虚拟 ip。所有的请求都会通过这个虚拟 ip 到达集群服务内部的机器。
endpoint_mode: dnsrr
#DNS 轮询（DNSRR）。所有的请求会自动轮询获取到集群 ip 列表中的一个 ip 地址。

10.labels：在服务上设置标签。可以用容器上的 labels（跟 deploy 同级的配置） 覆盖 deploy 下的 labels。
11.mode：指定服务提供的模式。
12.replicated：复制服务，复制指定服务到集群的机器上。
13.global：全局服务，服务将部署至集群的每个节点。
14.replicas：mode 为 replicated 时，需要使用此参数配置具体运行的节点数量。
15.resources：配置服务器资源使用的限制，例如上例子，配置 redis 集群运行需要的 cpu 的百分比 和 内存的占用。避免占用资源过高出现异常。
16.restart_policy：配置如何在退出容器时重新启动容器。
condition：可选 none，on-failure 或者 any（默认值：any）。
delay：设置多久之后重启（默认值：0）。
max_attempts：尝试重新启动容器的次数，超出次数，则不再尝试（默认值：一直重试）。
window：设置容器重启超时时间（默认值：0）。

17.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 ）。

18update_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）。
注：仅支持 V3.4 及更高版本。

19.devices
指定设备映射列表。
devices:

• “/dev/ttyUSB0:/dev/ttyUSB0”

20.dns
自定义 DNS 服务器，可以是单个值或列表的多个值。
dns: 8.8.8.8

dns:

• 8.8.8.8
• 9.9.9.9

21.dns_search
自定义 DNS 搜索域。可以是单个值或列表。
dns_search: example.com

dns_search:

• dc1.example.com
• dc2.example.com

22.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

23.env_file
从文件添加环境变量。可以是单个值或列表的多个值。
env_file: .env
也可以是列表格式：

env_file:

• ./common.env
• ./apps/web.env
• /opt/secrets.env

24.environment
添加环境变量。您可以使用数组或字典、任何布尔值，布尔值需要用引号引起来，以确保 YML 解析器不会将其转换为 True 或 False。
environment:
RACK_ENV: development
SHOW: ‘true’

25.expose
暴露端口，但不映射到宿主机，只被连接的服务访问。
仅可以指定内部端口为参数：
expose:

• “3000”
• “8000”

26.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

27.healthcheck
用于检测 docker 服务是否健康运行。
healthcheck:
test: [“CMD”, “curl”, “-f”, “http://localhost”] # 设置检测程序
interval: 1m30s # 设置检测间隔
timeout: 10s # 设置检测超时时间
retries: 3 # 设置重试次数
start_period: 40s # 启动后，多少秒开始启动检测程序

28.image
指定容器运行的镜像。以下格式都可以：
image: redis
image: ubuntu:14.04
image: tutum/influxdb
image: example-registry.com:4000/postgresql
image: a4bc65fd # 镜像id

29.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”

30.network_mode
设置网络模式。
network_mode: “bridge”
network_mode: “host”
network_mode: “none”
network_mode: “service:[service name]”
network_mode: “container:[container name/id]”
networks

配置容器连接的网络，引用顶级 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

31.aliases ：同一网络上的其他容器可以使用服务名称或此别名来连接到对应容器的服务。

32.restart
no：是默认的重启策略，在任何情况下都不会重启容器。
always：容器总是重新启动。
on-failure：在容器非正常退出时（退出状态非0），才会重启容器。
unless-stopped：在容器退出时总是重启容器，但是不考虑在Docker守护进程启动时就已经停止了的容器
restart: “no”
restart: always
restart: on-failure
restart: unless-stopped
注：swarm 集群模式，请改用 restart_policy。

33.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

34.security_opt
修改容器默认的 schema 标签。
security-opt：

• label:user:USER # 设置容器的用户标签
• label:role:ROLE # 设置容器的角色标签
• label:type:TYPE # 设置容器的安全策略标签
• label:level:LEVEL # 设置容器的安全等级标签

35.stop_grace_period
指定在容器无法处理 SIGTERM (或者任何 stop_signal 的信号)，等待多久后发送 SIGKILL 信号关闭容器。
stop_grace_period: 1s # 等待 1 秒
stop_grace_period: 1m30s # 等待 1 分 30 秒
默认的等待时间是 10 秒。

36.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

37.tmpfs
在容器内安装一个临时文件系统。可以是单个值或列表的多个值。
tmpfs: /run
tmpfs:
/run
/tmp

38.ulimits
覆盖容器默认的 ulimit。
ulimits:
nproc: 65535
nofile:
soft: 20000
hard: 40000

39.volumes
将主机的数据卷或着文件挂载到容器里。
version: “3.7”
services:
db:
image: postgres:latest
volumes:
- “/localhost/postgres.sock:/var/run/postgres/postgres.sock”
- “/localhost/data:/var/lib/postgresql/data”