一起养成写作习惯！这是我参与「掘金日新计划 · 4 月更文挑战」的第9天，点击查看活动详情

1、序言

前面几篇文章介绍了Docker的基础以及常用命令，然而在日常的工作中，往往都是微服务架构，需要部署许多服务，每个服务一般都会部署多个实例，如果每个微服务都要手动启停，那么会增加运维的负担以及工作量，所以需要一个批量管理或者批量执行的工作来解决这个问题。

Docker Compose 是用于定义和运行多容器的工具，通过Compose文件以及命令，可以一次性的从文件配置中创建、启动所有服务。

官方文档

2、安装

从网上摘抄的比较简单的安装方式：

# 根据当前版本自适应选择系统等信息
sudo curl -L https://github.com/docker/compose/releases/download/1.20.0/docker-compose-$(uname -s)-$(uname -m) -o /usr/local/bin/docker-compose
# 增加执行权限
sudo chmod +x /usr/local/bin/docker-compose

说明：部分环境，需要额外安装以下依赖包，安装命令为： yum install -y py-pip python-dev libffi-dev openssl-dev gcc libc-dev make

安装完成之后，运行docker-compose --version验证是否安装成功。

[root@mengli ~]# docker-compose --version
docker-compose version 1.20.0, build ca8d3c6

3、使用

3.1 docker-compose.yml

这个文件跟DockerFile差距比较大，主要的还是上面介绍的那样，一个是单服务部署，一个是集群样子的部署，下面是官方提供的配置文件例子，根据官方配置的文件，来了解以下。

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:

3.1.1 一级配置

• version 定义了当前这个文件的版本是什么，现在有3个版本,分别为1, 2.x和3.x，目前主流的为3.x，其支持docker 1.13.0及其以上的版本，未来版本1会弃用；

• services 定义了服务的配置信息，包含了当前编排的所有容器以及服务信息；

• networks 定义了网络信息，提供给services中的服务容器使用；

• volumes 定义了卷信息，提供给services 中的服务容器使用；

3.1.2 二级配置services

services下，隔行配置各个容器的名称，然后开始二级配置的关键字，常用关键字如下：

• image

image是指定服务的镜像名称或镜像ID。

如果镜像在本地不存在，Compose将会尝试拉取镜像。

services: 
    redis: 
    image: redis:alpine

• build

服务除了可以基于指定的镜像，还可以基于一份Dockerfile，在使用up启动时执行构建任务，构建标签是build，可以指定Dockerfile所在文件夹的路径。Compose将会利用Dockerfile自动构建镜像，然后使用镜像启动服务容器。

build: /path/to/build/dir

也可以是相对路径，只要上下文确定就可以读取到Dockerfile。

build: ./dir

设定上下文根目录，然后以该目录为准指定Dockerfile。

build:
  context: ../
  dockerfile: path/of/Dockerfile

build都是一个目录，如果要指定Dockerfile文件需要在build标签的子级标签中使用dockerfile标签指定。 如果同时指定image和build两个标签，那么Compose会构建镜像并且把镜像命名为image值指定的名字。

• context

context选项可以是Dockerfile的文件路径，也可以是到链接到git仓库的url，当提供的值是相对路径时，被解析为相对于撰写文件的路径，此目录也是发送到Docker守护进程的context

build:
  context: ./dir

• dockerfile

使用dockerfile文件来构建，必须指定构建路径

build:
  context: .
  dockerfile: Dockerfile-alternate

• commond

command: bundle exec thin -p 3000

• container_name

Compose的容器名称格式是：<项目名称><服务名称><序号>
可以自定义项目名称、服务名称，但如果想完全控制容器的命名，可以使用标签指定：

container_name: app

3.2 docker-compose 常用命令

docker-compose的常用命令基本跟docker的命令一样，无非两个命令操作的对象不一样；

docker命令主要针对DockerFile文件以及其生成的镜像以及容器的操作；

docker-compose 以及 docker compose 这两个命令更多的是针对与docker-compose.yml文件的命令；但是docker-compose命令在docker命令的基础上扩展了比较多参数，可以更好的管理容器，下面就列一些常用的命令。

点击命令超链接跳转的是官方文档

• docker-compose up

docker-compose up [options] [--scale SERVICE=NUM...] [SERVICE...]
选项包括：
-d 在后台运行服务容器
-no-color 不是有颜色来区分不同的服务的控制输出
-no-deps 不启动服务所链接的容器
--force-recreate 强制重新创建容器，不能与-no-recreate同时使用
–no-recreate 如果容器已经存在，则不重新创建，不能与–force-recreate同时使用
–no-build 不自动构建缺失的服务镜像
–build 在启动容器前构建服务镜像
–abort-on-container-exit 停止所有容器，如果任何一个容器被停止，不能与-d同时使用
-t, –timeout TIMEOUT 停止容器时候的超时（默认为10秒）
–remove-orphans 删除服务中没有在compose文件中定义的容器

• docker-compose rm

docker-compose rm [options] [SERVICE...]
删除所有（停止状态的）服务容器。
选项包括：
–f, –force，强制直接删除，包括非停止状态的容器
-v，删除容器所挂载的数据卷
docker-compose rm
删除所有（停止状态的）服务容器。推荐先执行docker-compose stop命令来停止容器。

• docker-compose start

docker-compose start [SERVICE...]
docker-compose start
启动已经存在的服务容器。

• docker-compose ps

docker-compose  ps [options] [SERVICE...]
列出项目中所有在运行的容器

• docker-compose stop

docker-compose stop [options] [SERVICE...]
选项包括
-t, –timeout TIMEOUT 停止容器时候的超时（默认为10秒）
docker-compose stop
停止正在运行的容器，可以通过docker-compose start 再次启动

• docker-compose down

docker-compose down [options]
停止和删除容器、网络、卷、镜像。
选项包括：
–rmi type，删除镜像，类型必须是：all，删除compose文件中定义的所有镜像；local，删除镜像名为空的镜像
-v, –volumes，删除已经在compose文件中定义的和匿名的附在容器上的数据卷
–remove-orphans，删除服务中没有在compose中定义的容器
docker-compose down
停用移除所有容器以及网络相关

• docker-compose logs

docker-compose logs [options] [SERVICE...]
查看服务容器的输出。默认情况下，docker-compose将对不同的服务输出使用不同的颜色来区分。可以通过–no-color来关闭颜色。
docker-compose logs
查看服务容器的输出 
-f 跟踪日志输出

• docker-compose bulid

docker-compose build [options] [--build-arg key=val...] [SERVICE...]
构建（重新构建）项目中的服务容器。
选项包括：
–compress 通过gzip压缩构建上下环境
–force-rm 删除构建过程中的临时容器
–no-cache 构建镜像过程中不使用缓存
–pull 始终尝试通过拉取操作来获取更新版本的镜像
-m, –memory MEM为构建的容器设置内存大小
–build-arg key=val为服务设置build-time变量
服务容器一旦构建后，将会带上一个标记名。可以随时在项目目录下运行docker-compose build来重新构建服务