Docker三剑客之Compose

Docker Compose 是 Docker 官方编排（Orchestration）项目之一，负责快速的部署分布式应用。

Compose 基本介绍

Compose 简介

• Compose代码

Compose 项目是 Docker 官方的开源项目，负责实现对 Docker 容器集群的快速编排。从功能上看，跟 OpenStack 中的 Heat 十分类似。
Compose 定位是 「定义和运行多个 Docker 容器的应用（Defining and running multi-container Docker applications）」，其前身是开源项目 Fig。

为什么使用Compose

在Docker镜像构成和定制介绍中，我们可以使用Dockerfile文件很方便定义一个单独的应用容器。
然而，在日常工作中，经常会碰到需要多个容器相互配合来完成某项任务的情况。例如要实现一个 Web 项目，除了 Web 服务容器本身，往往还需要再加上后端的数据库服务容器，甚至还包括负载均衡容器等。
Compose 恰好满足了这样的需求。它允许用户通过一个单独的 docker-compose.yml 模板文件（YAML 格式）来定义一组相关联的应用容器为一个项目（project）。

docker-compose.yml看起来像这样：
version: '3'
services:
  web:
    build: .
    ports:
    - "5000:5000"
    volumes:
    - .:/code
    - logvolume01:/var/log
    links:
    - redis
  redis:
    image: redis
volumes:
  logvolume01: {}

Compose 中两个重要的概念

• 服务 (service)：一个应用的容器，实际上可以包括若干运行相同镜像的容器实例。
• 项目 (project)：由一组关联的应用容器组成的一个完整业务单元，在 docker-compose.yml 文件中定义。

说明：

• Compose 的默认管理对象是项目，通过子命令对项目中的一组容器进行便捷地生命周期管理。
• Compose 项目由 Python 编写，实现上调用了 Docker 服务提供的 API 来对容器进行管理。因此，只要所操作的平台支持 Docker API，就可以在其上利用 Compose 来进行编排管理。

Compose 安装与卸载

Docker 版本

docker-ce-17.09.0.ce
系统环境是linux7.x

PIP 安装

pip install docker-compose

Compose 版本

docker-compose --version
docker-compose version 1.21.2, build a133471

卸载

如果是通过 pip 安装的，则执行如下命令即可删除。

pip uninstall docker-compose

实战--使用docker-compose部署Edusoho平台

项目目录结构

# pwd
/root/docker-lnmp
# tree -L 3
.
├── docker-compose.yml
├── mysql
│   ├── data
│   └── my.cnf
├── nginx
│   ├── conf.d
│   │   └── default.conf
│   ├── Dockerfile
│   ├── edusoho
│   │   ├── api
│   │   ├── app
│   │   ├── bootstrap
│   │   ├── plugins
│   │   ├── src
│   │   ├── vendor
│   │   ├── vendor_user
│   │   └── web
│   ├── edusoho-8.2.38.tar.gz
│   ├── log
│   │   └── error.log
│   ├── nginx.conf
│   ├── ssl
│   │   ├── nginx.key
│   │   └── nginx.pem
│   └── www
│       ├── db.php
│       ├── index.html
│       ├── index.php
├── php
│   ├── Dockerfile
│   ├── log
│   │   └── php-fpm.log
│   ├── php-fpm.conf
│   ├── php.ini
│   └── www.conf

项目docker-compose.yml文件

version: '3'
# 定义三个服务nginx，php，mysql
services:
  nginx:
    # 依赖php服务，意味着在启动nginx之前先启动php
    depends_on:
      - php
      # nginx镜像的路径
    build: ./nginx
        # 这样使nginx容器把网站文件和目录存放到主机目录中，持久化和方便管理
    volumes:
      - ./nginx/nginx.conf:/etc/nginx/nginx.conf
      - ./nginx/log/error.log:/var/log/nginx/error.log
      - ./nginx/edusoho:/usr/share/nginx/html
        # nginx意外退出时自动重启
    restart: always

        # 映射80端口
    ports:
      - "80:80"
     # - "443:443"
    networks:
      - frontend

        # 容器名称
    container_name: nginx

  php:
    depends_on:
      - mysql
    build: ./php
    ports:
      - "9000"
    networks:
      - frontend
      - backend      
    volumes:
      - ./php/php-fpm.conf:/usr/local/php/etc/php-fpm.conf
      - ./php/www.conf:/usr/local/php/etc/php-fpm.d/www.conf
      - ./php/php.ini:/usr/local/php/etc/php.ini
      - ./php/log/php-fpm.log:/usr/local/php/var/log/php-fpm.log
      - ./nginx/edusoho:/usr/share/nginx/html
    restart: always
    container_name: php

  # MySQL
  mysql:
    image: "dockerhub.datagrand.com/global/mysql:5.6"
    ports:
      - "3306:3306"
    volumes:
      - ./mysql/data:/var/lib/mysql
      - ./mysql/my.cnf:/etc/my.cnf
    environment:
      MYSQL_ROOT_PASSWORD: 123456
      MYSQL_DATABASE: wordpress
      MYSQL_USER: wordpress
      MYSQL_PASSWORD: wordpress
    command: ['mysqld', '--character-set-server=utf8']
    networks:
      - backend
    restart: always
    container_name: mysql
  #Network    
networks:
  frontend:
  backend:

后台启动并运行所有容器

docker-compose up -d

-d 在后台运行服务容器

docker-compose.yml 文件内容说明

默认的模板文件名称为 docker-compose.yml，格式为 YAML 格式。

version

Compose文件版本，详见Compose file versions and upgrading | Docker Documentation

depends_on

使用depends_on选项控制服务启动的顺序。详见Control startup order in Compose

services:
  nginx:
    # 依赖php服务，意味着在启动nginx之前先启动php
    depends_on:
      - php
说明：
nginx服务不会等待php完全启动之后才启动！

build

指定 Dockerfile 所在文件夹的路径（可以是绝对路径，或者相对 docker-compose.yml 文件的路径）。 Compose 将会利用它自动构建这个镜像，然后使用这个镜像。
详见build

# nginx镜像的路径
    build: ./nginx

你也可以使用 context 指令指定 Dockerfile 所在文件夹的路径。
使用 dockerfile 指令指定 Dockerfile 文件名。
使用 arg 指令指定构建镜像时的变量。

version: '3'
services:

  webapp:
    build:
      context: ./dir
      dockerfile: Dockerfile-alternate
      args:
        buildno: 1

volumes

数据卷所挂载路径设置。可以设置宿主机路径 (HOST:CONTAINER) 或加上访问模式 (HOST:CONTAINER:ro）。
该指令中路径支持相对路径。详见volumes

volumes:
      - ./nginx/nginx.conf:/etc/nginx/nginx.conf
      - ./nginx/log/error.log:/var/log/nginx/error.log
      - ./nginx/edusoho:/usr/share/nginx/html

restart

no是默认的重新启动策略，它不会在任何情况下重新启动容器。当always指定时，容器总是重新启动。
该命令对保持服务始终运行十分有效，在生产环境中推荐配置为 always 或者 unless-stopped。
详见restart

restart: "no"
restart: always
restart: on-failure
restart: unless-stopped

注意：使用（版本3）Compose文件在群集模式下部署堆栈时，将忽略此选项 。请改用restart_policy。

ports

暴露端口信息。
使用宿主端口：容器端口 (HOST:CONTAINER) 格式，或者仅仅指定容器的端口（宿主将会随机选择端口）。
详见ports

ports:
 - "3000"
 - "3000-3005"
 - "8000:8000"
 - "9090-9091:8080-8081"
 - "49100:22"
 - "127.0.0.1:8001:8001"
 - "127.0.0.1:5000-5010:5000-5010"
 - "6060:6060/udp"

注意：以HOST:CONTAINER格式映射端口时，使用低于60的容器端口时可能会遇到错误的结果，因为YAML会将格式xx:yy中的数字解析为base-60值。因此，我们建议始终将端口映射明确指定为字符串。

networks

配置容器连接的网络。详见网络配置

创建frontend网络
docker network create frontend
查看网络
docker network ls
删除网络
docker network rm frontend

container_name

指定容器名称。默认将会使用 项目名称_服务名称_序号 这样的格式。
注意： 使用（版本3）Compose文件在群集模式下部署堆栈时，将忽略此选项。
详见container_name

# 容器名称
    container_name: nginx

environment

详见environment

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

environment:
      MYSQL_ROOT_PASSWORD: 123456
      MYSQL_DATABASE: wordpress
      MYSQL_USER: wordpress
      MYSQL_PASSWORD: wordpress
或
environment:
      - MYSQL_ROOT_PASSWORD=123456
      - MYSQL_DATABASE=wordpress
      - MYSQL_USER=wordpress
      - MYSQL_PASSWORD=wordpress

• 如果变量名称或者值中用到 true|false，yes|no 等表达 布尔 含义的词汇，最好放到引号里，避免 YAML 自动解析某些内容为对应的布尔语义。
  这些特定词汇，包括:

y|Y|yes|Yes|YES|n|N|no|No|NO|true|True|TRUE|false|False|FALSE|on|On|ON|off|Off|OFF

environment:
  RACK_ENV: development
  SHOW: 'true'
或
environment:
  - RACK_ENV=development
  - SHOW=true

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

environment:
  RACK_ENV: development
  SESSION_SECRET:

environment:
  - RACK_ENV=development
  - SESSION_SECRET

command

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

command: bundle exec thin -p 3000
该命令也可以是一个列表，方式类似于 dockerfile：
command: ["bundle", "exec", "thin", "-p", "3000"]