随着 Docker v1.13 版本发布，Compose 的配置文件也发生了改动，官方命名为 v3，今天来看一下相比 v2 的写法，v3有哪些异同。
因为是 YAML 语法，所以无论是 .yml 还是 .yaml 作为后缀名，Compose 都可以识别。
1. build
与上一个版本没有变化，依旧是熟悉的格式：
build:
context: ./dir
dockerfile: Dockerfile-alternate
args:
buildno: 1
2. cap_add, cap_drop
这部分用于调整容器操作内核权限、能力。这部分有一点点变化，就是在 Swarm 模式中，Compose 会忽略这部分参数的值。
cap_add:
- ALL
cap_drop:
- NET_ADMIN
- SYS_ADMIN
大概是出于提高集群安全性的考虑？没怎么用过这个部分的参数。
3. command
没有变化
command: bundle exec thin -p 3000
4. cgroup_parent
与上面第二条一样，在 Swarm 模式中忽略这部分的值。格式没变化：
cgroup_parent: m-executor-abcd
5. container_name
没变化。
6. deploy
这个来了，deploy 加入了正式版，这是 V3 才能使用的语法。
首先这是一个服务于 Swarm 的语法，也就是当用户使用例如：
docker-compose up
docker-compose run
这种方式启动时，Compose 会忽略 deploy 部分的内容。
语法规则：
deploy:
replicas: 6
update_config:
parallelism: 2
delay: 10s
restart_policy:
condition: on-failure
6.1 mode
首先 deploy 提供了一个模式选项，它的值有 global 和 replicated 两个，默认是 replicated 模式。
这两个模式的区别是：
- global：每个集群每个服务实例启动一个容器，就像以前启动 Service 时一样。
- replicated：用户可以指定集群中实例的副本数量。
以前这个功能是无法在 Compose 中直接实现的，以前需要用户先使用 docker-compose bundle 命令将 docker-compose.yml 转换为 .dab 文件，然后才能拿到集群部署，而且很多功能用不了。
但是随着这次更新把 stack 加进来了，deploy 也就水到渠成加进了 Compose 功能中。
6.2 replicas
上面说到可以指定副本数量，其中 replicas 就是用于指定副本数量的选项。
deploy:
replicas: 6
部署服务栈：
docker stack deploy --compose-file docker-compose.yml
6.3 placement
这是 Docker 1.12 版本时就引入的概念，允许用户限制服务容器，具体有什么用我也不知道，笑。
网上能找的资料好少，官方文档只有两句废话，如果我能找到原来的 issue 或者 PR 或许可以理解一些。
6.4 update_config
早在上一个版本中，Swarm 就提供了一个升级回滚的功能。当服务升级出现故障时，超过重试次数则停止升级的功能，这也很方便，避免让错误的应用替代现有正常服务。
这个选项用于告诉 Compose 使用怎样的方式升级，以及升级失败后怎样回滚原来的服务。
- parallelism: 服务中多个容器同时更新。
- delay: 设置每组容器更新之间的延迟时间。
- failure_action: 设置更新失败时的动作，可选值有 continue 与 pause (默认是：pause)。
- monitor: 每次任务更新失败后监视故障的持续时间 (ns|us|ms|s|m|h) (默认：0s)。
- max_failure_ratio: 更新期间容忍的故障率。
6.5 resources
看例子：
resources:
limits:
cpus: '0.001'
memory: 50M
reservations:
cpus: '0.0001'
memory: 20M
知道干啥用了吧，这是一个新的语法选项，替代了之前的类似 cpu_shares, cpu_quota, cpuset, mem_limit, memswap_limit 这种选项。统一起来好看点。
6.6 restart_policy
设置如何重启容器，毕竟有时候容器会意外退出。
- condition：设置重启策略的条件，可选值有 none, on-failure 和 any (默认：any)。
- delay：在重新启动尝试之间等待多长时间，指定为持续时间（默认值：0）。
- max_attempts：设置最大的重启尝试次数，默认是永不放弃，哈哈，感受到一股运维的绝望。
- window：在决定重新启动是否成功之前要等待多长时间，默认是立刻判断，有些容器启动时间比较长，指定一个“窗口期”非常重要。
7. labels
没有变化。
8. devices
基本没变化，Swarm 模式会无视这部分设置。
9. depends_on
和以前一样。
10. dns 和 dns_search
Swarm 模式无视设置，其他一样。
11. tmpfs
没有变化。Swarm 模式无视设置。
12. entrypoint
没有变化。
13. env_file
变量出奇多时可以用这个办法管理变量。没有变化。
14. environment
没有变化。
15. expose
没有变化。
16. external_links
没有变化，但是不建议使用，因为这是一个遗留的选项，现在你可以在 Compose 中使用 networks 代替，效果是一样的，但是后者更加容易管理与理解。
17. extra_hosts
没有变化。
18. group_add 和 healthcheck、image、isolation、links、logging、network_mode、networks、aliases、ipv4_address, ipv6_address、link_local_ips、pid、ports、security_opt、stop_grace_period、stop_signal、sysctls、ulimits、userns_mode、domainname, hostname, ipc, mac_address, privileged, read_only, restart, shm_size, stdin_open, tty, user, working_dir
以上都没有变化，需要提一下的是 links、network_mode、security_opt、stop_signal、sysctls、userns_mode 会在 Swarm 模式中无视。
isolation 提供了三种容器隔离方式：default，process 和 hyperv。
19. secret 管理
新事物，这部分放到以后的文章中。
20. volumes_from
这个去掉了，嗯。需要共享数据用命名卷，例如：
version: "3"
services:
db:
image: db
volumes:
- data-volume:/var/lib/db
backup:
image: backup-service
volumes:
- data-volume:/var/lib/backup/data
volumes:
data-volume:
去除 volume_driver，这种服务全局的东西没有必要，直接针对每个卷使用 volume 键下的 driver 即可。
最后一个官方例子结束本文：
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:
