Docker进阶之01-Docker Compose编排工具

Docker Compose是什么

可以按项目为单位管理多个Docker容器，Python语言开发，底层调用Docker的API接口。

Docker Compose解决的是单个主机上快速启停多个容器，以及管理容器之间依赖关系的问题。

如何安装

# 安装1.2.0版本的docker compose，一定要注意docker compose版本，如果版本不对，在运行时可能会报错："Unsupported config option"

$ sudo curl -L https://github.com/docker/compose/releases/download/1.2.0/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose

$ sudo chmod a+x /usr/local/bin/docker-compose

命令行

docker-compose [-f <arg>...] [--profile <name>...] [options] [--] [COMMAND] [ARGS...]

	-f，--file        ：指定yaml配置文件，默认：docker-compose.yml

	-p，--project-name：指定项目名，默认：执行docker-compose命令所在的目录名（注：如果启动服务时指定了-p参数，那么停止服务时也必须指定-p参数）

	--log-level LEVEL ：指定日志级别，可选值：DEBUG, INFO, WARNING, ERROR, CRITICAL

	--verbose         ：输出更多调试信息

Commands:

  build              Build or rebuild services

  config             Validate and view the Compose file

  create             Create services

  down               Stop and remove resources

  events             Receive real time events from containers

  exec               Execute a command in a running container

  help               Get help on a command

  images             List images

  kill               Kill containers

  logs               View output from containers

  pause              Pause services

  port               Print the public port for a port binding

  ps                 List containers

  pull               Pull service images

  push               Push service images

  restart            Restart services

  rm                 Remove stopped containers

  run                Run a one-off command

  scale              Set number of containers for a service

  start              Start services

  stop               Stop services

  top                Display the running processes

  unpause            Unpause services

  up                 Create and start containers

  version            Show version information and quit

yaml文件指令

Docker Compose编排容器是通过配置yaml文件配置的，默认的文件名称是docker-compose.yml，其中定义的每个服务都必须通过image指令指定镜像或 build 指令（需要 Dockerfile）来自动构建。

可以在配置文件中使用的指令如下阐述。

1.image

指定为镜像名称或镜像 ID，如果镜像在本地不存在，Compose 将会尝试拉去这个镜像。

image: ubuntu

image: orchardup/postgresql

image: a4bc65fd

2.build

指定Dockerfile所在文件夹的路径，Compose将会利用它自动构建这个镜像，然后使用这个镜像。

build: /path/to/build/dir

3.command

覆盖容器启动后默认执行的命令。

command: bundle exec thin -p 3000

4.links

链接到其它服务中的容器。使用“服务名称”（同时作为别名）或“服务名称：服务别名”（SERVICE:ALIAS）格式都可以。

links:

 - db

 - db:database

 - redis

使用的别名将会自动在服务容器中的/etc/hosts里创建，例如：

172.17.2.186  db

172.17.2.186  database

172.17.2.187  redis

相应的环境变量也将被创建。

5.external_links

链接到docker-compose.yml外部的容器，甚至并非Compose管理的容器。参数格式跟links类似。

external_links:

 - redis_1

 - project_db_1:mysql

 - project_db_1:postgresql

6.ports

暴露端口信息。

使用“宿主：容器”（HOST:CONTAINER）格式或者仅仅指定容器的端口（宿主将会随机选择端口）都可以。

ports:

 - "3000"

 - "8000:8000"

 - "49100:22"

 - "127.0.0.1:8001:8001"

注意：当使用HOST:CONTAINER格式来映射端口时，如果你使用的容器端口小于60可能会得到错误得结果，因为YAML将会解析xx:yy这种数字格式为60进制，所以建议采用字符串格式。

7.expose

暴露端口，但不映射到宿主机，只被连接的服务访问。

仅可以指定容器内部端口为参数：

expose:

 - "3000"

 - "8000"

8.volumes

卷挂载路径设置。

可以设置宿主机路径（主机路径:容器路径）或加上访问模式（主机路径:容器路径:ro）。

volumes:

 - /var/lib/mysql

 - cache/:/tmp/cache

 - ~/configs:/etc/configs/:ro

9.volumes_from

从另一个服务或容器挂载它的所有卷。

volumes_from:

 - service_name

 - container_name

10.environment

设置环境变量，可以使用数组或字典两种格式。

只给定名称的变量会自动获取它在Compose主机上的值，可以用来防止泄露不必要的数据。

environment:

  RACK_ENV: development

  SESSION_SECRET:

environment:

  - RACK_ENV=development

  - SESSION_SECRET

11.env_file

从文件中获取环境变量，可以为单独的文件路径或列表。

如果通过docker-compose -f FILE指定了模板文件，则env_file中路径会基于模板文件路径。

如果有变量名称与environment指令冲突，则以后者为准。

env_file: .env

env_file:

  - ./common.env

  - ./apps/web.env

  - /opt/secrets.env

环境变量文件中每一行必须符合格式，支持#开头的注释行。

# common.env: Set Rails/Rack environment

RACK_ENV=development

12.extends

基于已有的服务进行扩展，例如我们已经有了一个webapp服务，模板文件为common.yml。

# common.yml

webapp:

  build: ./webapp

  environment:

    - DEBUG=false

    - SEND_EMAILS=false

编写一个新的development.yml文件，使用common.yml中的webapp服务进行扩展。

# development.yml

web:

  extends:

    file: common.yml

    service: webapp

  ports:

    - "8000:8000"

  links:

    - db

  environment:

    - DEBUG=true

db:

  image: postgres

后者会自动继承 common.yml 中的 webapp 服务及相关环节变量。

13.net

设置网络模式，使用和docker client的--net参数一样的值。

net: "bridge"

net: "none"

net: "container:[name or id]"

net: "host"

14.pid

跟主机系统共享进程命名空间，打开该选项的容器可以相互通过进程ID来访问和操作。

pid: "host"

15.dns

配置DNS服务器，可以是一个值，也可以是一个列表。

dns: 8.8.8.8

dns:

  - 8.8.8.8

  - 9.9.9.9

16.dns_search

配置DNS搜索域，可以是一个值，也可以是一个列表。

dns_search: example.com

dns_search:

  - domain1.example.com

  - domain2.example.com

17.cap_add, cap_drop

添加或放弃容器的 Linux 能力（Capabiliity）。

cap_add:

  - ALL

cap_drop:

  - NET_ADMIN

  - SYS_ADMIN

18.working_dir, entrypoint, user, hostname, domainname, mem_limit, privileged, restart, stdin_open, tty, cpu_shares

这些都是和docker run支持的选项类似。

cpu_shares: 73

working_dir: /code

entrypoint: /code/entrypoint.sh

user: postgresql

hostname: foo

domainname: foo.com

mem_limit: 1000000000

privileged: true

restart: always

stdin_open: true

tty: true

【参考】

https://www.runoob.com/docker/docker-compose.html Docker Compose

https://docs.docker.com/engine/reference/commandline/compose/ Docker Compose命令行

https://www.jianshu.com/p/658911a8cff3 Docker：Docker Compose 详解

http://www.dockerinfo.net/docker-compose-项目 Docker Compose 项目

https://juejin.cn/post/6870401513357836302 14个用于DevOps的容器编排工具

https://blog.51cto.com/devopsvip/3196552 10个最佳的Docker容器集群编排工具

https://www.infoq.cn/article/6itsptlczt6sbkdevokn 这可能是网上最全的 Docker 工具集合