Docker Compose

简介

       Docker-Compose项目是Docker官方的开源项目，负责实现对Docker容器集群的快速编排。 Compose 是用于定义和运行多容器 Docker 应用程序的工具。通过 Compose，您可以使用 YML 文件来配置应用程序需要的所有服务。然后，使用一个命令，就可以从 YML 文件配置中创建并启动所有服务。

组成

       Docker Compose 将所管理的容器分为三层，分别是工程（project）、服务（service）、容器（container）        Docker Compose 运行目录下的所有文件（docker-compose.yml）组成一个工程,一个工程包含多个服务，每个服务中定义了容器运行的镜像、参数、依赖，一个服务可包括多个容器实例

       Docker-Compose运行目录下的所有文件（docker-compose.yml，extends文件或环境变量文件等）组成一个工程，若无特殊指定工程名即为当前目录名。一个工程当中可包含多个服务，每个服务中定义了容器运行的镜像，参数，依赖。一个服务当中可包括多个容器实例。

       服务（service）：一个应用的容器，实际上可以包括若干运行相同镜像的容器实例。每个服务都有自己的名 字、使用的镜像、挂载的数据卷、所属的网络、依赖哪些其他服务等等，即以容器为粒度，用户需要Compose所完成的任务。        项目（project）：由一组关联的应用容器组成的一个完成业务单元，在docker-compose.yml中定义。即是 Compose的一个配置文件可以解析为一个项目，Compose通过分析指定配置文件，得出配置文件所需完成的所有容器管理与部署操作。

       Docker-Compose的工程配置文件默认为docker-compose.yml，可通过环境变量COMPOSE_FILE或-f参数自定义配置文件，其定义了多个有依赖关系的服务及每个服务运行的容器。        使用一个Dockerfile模板文件，可以让用户很方便的定义一个单独的应用容器。在工作中，经常会碰到需要多个容器相互配合来完成某项任务的情况。 例如：要部署一个Web项目，除了Web服务容器，往往还需要再加上后端的数据库（mysql）服务容器等，甚至还包括负载均衡（nginx）容器等。

Docker-compose使用的三个步骤：

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

安装与卸载

安装方式1：

# 安装
apt install python-pip
pip install docker-compose
PS：centos使用命令yum -y install python-pip安装pip

# 查看安装的版本
docker-compose --version

# Docker-compose卸载

pip uninstall docker-compose

安装方式2：

curl -L https://github.com/docker/compose/releases/download/1.24.1/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose

# 设置文件可执行权限
chmod +x /usr/local/bin/docker-compose

# 查看版本信息
docker-compose -version

#卸载docker-compose
rm -f /usr/local/bin/docker-compose

Docker-compose常用命令

1. Docker-compose命令格式

   docker-compose [-f <arg>...] [options] [COMMAND] [ARGS...]
   
   命令选项如下：
   -f --file FILE指定Compose模板文件，默认为docker-compose.yml
   -p --project-name NAME 指定项目名称，默认使用当前所在目录为项目名
   --verbose  输出更多调试信息
   -v，-version 打印版本并退出
   --log-level LEVEL 定义日志等级(DEBUG, INFO, WARNING, ERROR, CRITICAL)
   

2. 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文件中定义的容器
   

3. docker-compose ps

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

4. docker-compose stop

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

5. docker-compose -h

   docker-compose -h
   查看帮助
   

6. docker-compose down

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

7. docker-compose logs

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

8. 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来重新构建服务
   

9. docker-compose pull

   docker-compose pull [options] [SERVICE...]
   拉取服务依赖的镜像。
   
   选项包括：
   –ignore-pull-failures，忽略拉取镜像过程中的错误
   –parallel，多个镜像同时拉取
   –quiet，拉取镜像过程中不打印进度信息
   docker-compose pull
   拉取服务依赖的镜像
   

10. docker-compose restart

    docker-compose restart [options] [SERVICE...]
    重启项目中的服务。
    
    选项包括：
    -t, –timeout TIMEOUT，指定重启前停止容器的超时（默认为10秒）
    docker-compose restart
    重启项目中的服务
    

11. docker-compose rm

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

12. docker-compose start

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

13. docker-compose run

    docker-compose run [options] [-v VOLUME...] [-p PORT...] [-e KEY=VAL...] SERVICE [COMMAND] [ARGS...]
    在指定服务上执行一个命令。
    docker-compose run ubuntu ping www.baidu.com
    在指定容器上执行一个ping命令。
    

14. docker-compose scale

    docker-compose scale web=3 db=2
    设置指定服务运行的容器个数。通过service=num的参数来设置数量
    

15. docker-compose pause

    docker-compose pause [SERVICE...]
    暂停一个服务容器
    

16. docker-compose kill

    docker-compose kill [options] [SERVICE...]
    通过发送SIGKILL信号来强制停止服务容器。
    支持通过-s参数来指定发送的信号，例如通过如下指令发送SIGINT信号：
    docker-compose kill -s SIGINT
    

17. docker-compose config

    docker-compose config [options]
    验证并查看compose文件配置。
    选项包括：
    –resolve-image-digests 将镜像标签标记为摘要
    -q, –quiet 只验证配置，不输出。 当配置正确时，不输出任何内容，当文件配置错误，输出错误信息
    –services 打印服务名，一行一个
    –volumes 打印数据卷名，一行一个
    

18. docker-compose create

    docker-compose create [options] [SERVICE...]
    为服务创建容器。
    
    选项包括：
    –force-recreate：重新创建容器，即使配置和镜像没有改变，不兼容–no-recreate参数
    –no-recreate：如果容器已经存在，不需要重新创建，不兼容–force-recreate参数
    –no-build：不创建镜像，即使缺失
    –build：创建容器前　　，生成镜像
    

19. docker-compose exec

    docker-compose exec [options] SERVICE COMMAND [ARGS...]
    
    选项包括：
    -d 分离模式，后台运行命令。
    –privileged 获取特权。
    –user USER 指定运行的用户。
    -T 禁用分配TTY，默认docker-compose exec分配TTY。
    –index=index，当一个服务拥有多个容器时，可通过该参数登陆到该服务下的任何服务，例如：docker-compose exec –index=1 web /bin/bash ，web服务中包含多个容器
    

20. docker-compose port

    docker-compose port [options] SERVICE PRIVATE_PORT
    显示某个容器端口所映射的公共端口。
    
    选项包括：
    –protocol=proto，指定端口协议，TCP（默认值）或者UDP
    –index=index，如果同意服务存在多个容器，指定命令对象容器的序号（默认为1）
    

21. docker-compose push

    docker-compose push [options] [SERVICE...]
    推送服务依的镜像。
    
    选项包括：
    –ignore-push-failures 忽略推送镜像过程中的错误
    

22. docker-compose stop

    docker-compose stop [options] [SERVICE...]
    停止运行的容器
    

23. docker-compose uppause

    docker-compose unpause [SERVICE...]
    恢复处于暂停状态中的服务。
    

Docker-compose模板文件

Docker-compose模板文件简介 　　Compose允许用户通过一个docker-compose.yml模板文件（YAML 格式）来定义一组相关联的应用容器为一个项目（project）。        Compose模板文件是一个定义服务、网络和卷的YAML文件。Compose模板文件默认路径是当前目录下的docker-compose.yml，可以使用.yml或.yaml作为文件扩展名。 Docker Compose的模板文件主要分为4个区域，如下：

1. version 版本信息
2. services 服务，在它下面可以定义应用需要的一些服务，每个服务都有自己的名字、使用的镜像、挂载的数据卷、所属的网络、依赖哪些其他服务等等。
3. volumes 数据卷，在它下面可以定义的数据卷（名字等等），然后挂载到不同的服务下去使用。
4. networks 应用的网络，在它下面可以定义应用的名字、使用的网络类型等等。

       最关键的是services和networks两个部分。

编写模板文件

官网地址：docs.docker.com/compose/com…

# docker-compose版本 version: '1' version: '2' version: '3'
version: '2'
# 服务
services:
  redis:
    image: nuiiqk/redis
    restart: always
    # 暴露端口信息  - "宿主机端口:容器暴露端口"
    ports:
      - "6379:6379"
    container_name: "redis"
    networks:
      - dev
  mysql:
    image: nuiiqk/mysql
    restart: always
    # 环境变量配置，可以用数组或字典两种方式
    environment:
      MYSQL_ROOT_PASSWORD: "root"
    ports:
      - "3306:3306"
    container_name: "mysql"
    networks:
      - dev
  nginx:
    # 指定服务所使用的镜像
    image: nuiiqk/nginx
    # 配置重启，docker每次启动时会启动该服务
    restart: always
    ports:
      - "80:80"
    # 容器别名
    container_name: "nginx"
    networks:
      - dev
    # 卷挂载路径，定义宿主机的目录/文件和容器的目录/文件的映射  宿主机路径:容器路径
    volumes:
      # - "/home/nginx/conf/nginx.conf:/etc/nginx/nginx.conf"
      - "/home/nginx/html:/usr/share/nginx/html"
      - "/home/nginx/logs:/var/log/nginx"
# 网络类型
networks:
  dev:
    driver: bridge
  pro:
    driver: bridge

       Compose目前有三个版本分别为Version 1，Version 2，Version 3，Compose区分Version 1和Version 2（Compose 1.6.0+，Docker Engine 1.10.0+）。Version 2支持更多的指令。Version 1将来会被弃用。

启动服务

# 进到docker-compose.yml目录
cd /home/docker/

# up 命令行
docker-compose up

# 如果后台启动则使用如下命令  -d 后台启动
docker-compose up -d

# 若要停止
docker-compose stop

       看到这三个服务代表已经成功了

服务访问

       通过浏览器访问一下nginx服务

http://ip地址