Docker-compose

docker-compose是一个使用python编写的命令行工具，用于docker应用之间的编排，可以在单主机下使用，也可以使用在docker swarm集群或docker1.12+的swarm mode下。

docker1.13以前docker-compose是一个独立的安装的命令行工具，文档如下https://docs.docker.com/compose/overview/，下面要讲的是compose file，已经在docker1.13种集成了docker的应用编排功能，可以在提供了docker-compose.yml文件的情况下使用docker stack deploy -f docker-compose.yml直接部署应用。

Compose file

Docker compose file到目前共有3个版本，docker1.13使用的compose file v3版本。官方文档：https://docs.docker.com/compose/compose-file/

Compose file使用yaml格式定义，默认名称为docker-compose.yml。

Dockerfile中的CMD，EXPOSE，VOLUME，ENV命令可以不必在docker-compose.yml中再定义。

build

build命令在docker swarm mode下使用docker stack deploy命令时是无效的，只有在本地使用docker-compose命令时才会创建image。

ARGS

假如Dockerfile中有如下两个变量$buildno和$password

  1. ARG buildno
  2. ARG password
  4. RUN echo "Build number: $buildno"
  5. RUN script-requiring-password.sh "$password"

docker-compose.yml中可以使用args来定义这两个变量的值。

  1. build:
  2.   context: .
  3.   args:
  4.     buildno: 1
  5.     password: secret
  7. build:
  8.   context: .
  9.   args:
  10.     - buildno=1
  11.     - password=secret

使用docker-compose build的时候就会替换这两个变量的值。

也可以忽略这两个变量。

  1. args:
  2.   - buildno
  3.   - password

command

  1. command: bundle exec thin -p 3000

替换Dockerfile中默认的CMD。

deploy

Compose file v3才支持的功能，也是重点功能。

  1. deploy:
  2.   replicas: 6
  3.   update_config:
  4.     parallelism: 2
  5.     delay: 10s
  6.   restart_policy:
  7.     condition: on-failure

deploy有如下几个子选项

  • Mode：可以为global或replicated，global能够规定服务在每台主机一个容器。replicated可以自定义service的容器个数。
  • replicas：使用replicas定义service的容器个数，只有在replicated mode下可用。
  • placement：用来限定容器部署在哪些主机上。使用constraints约束。
  • Update_config：定义service升级策略。
    • Parrallism：一次性同时升级的容器数
    • delay：两次升级之间的间隔
    • failure_action：升级失败后可以pause或continue，默认pause
    • monitor：升级后监控failure的间隔，格式(ns|us|ms|s|m|h)，默认0s
    • max_failure_ratio：可容忍的失败率
  • resources：service的资源数量限定，包括如下几个值cpu_shares, cpu_quota,cpuset, mem_limit, memswap_limit, mem_swappiness。
    • restart_policy：condition：one、on-failure、any默认any，delay，max_attempts，window
    • labels：为service打标签

docker-compose.yml还支持的配置有

  • devices：devices mapping
  • depends_on：定义service依赖关系，影响启动顺序
  • dns：自定义DNS，可以是单条也可以为列表
  • dns_search：自定义DNS搜索域
  • tmpfs：挂载临时文件系统
  • entrypoint：覆盖dockerfile中国年的entrypoint
  • env_file：定义env的文件，可以为一个列表
  • environment：定义环境变量
  • expose
  • external_links：链接外部docker-compose.yml外部启动的容器
  • extra_hosts：添加外部hosts
  • group_add
  • healthcheck：检查service的健康状况
  • Image
  • Isolation：linux只支持default，windows还有其他选项
  • labels：给容器打标签，建议用DNS的反向字符串定义
  • links：链接其他service
  • logging：日志配置，可以配置日志的driver、地址等
  • network_mode
  • networks：可以连接的定义网络名称，分配IP地址，设置网络别名，LINK_LOCAL_IPS选项可以连接外部非docker管理的IP。还可以定义的选项有driver、driver_opts、enable_ipv6、ipam、internal、labels、external等
  • pid
  • ports：对外暴露的端口
  • secret：定义service可以访问的secret文件
  • security_opts
  • stop_grace_period
  • stop_signal
  • sysctls
  • ulimits
  • userns_mode
  • volumes：可以定义driver、driver_opts、external、labels等

networks和volumes的子选项比较多，定义的时候请参照详细文档。