Docker Compose

Docker Compose

参考资料

• Docker Compose的Github地址 https://github.com/docker/compose/

什么是Docker Compose呢？

• Compose是Docker官方开源项目，负责实现对Docker容器集群的快速编排。
• Compose项目源自于Fig项目，与Docker/Swarm配合度很高。
• Compose使用Python编写，只需要调用Docker服务提供的API来对容器进行管理。
• Compose可以使用一条命令启动多个容器，从此不再需要使用Shell脚本来启动Docker容器。
• Compose作为Docker集群管理三剑客之一主要用于编排容器

Docker Compose

Compose将所有容器分为三层：工程（project）、服务（service）、容器（container）

• 工程：Compose运行目录下的所有文件（docker-compose.yml、extends文件或环境变量文件等）组成了一个工程，若无特殊指定工程名称则默认为当前目录名称。
• 服务：一个工程中可以包含多个服务，每个服务中定义了容器运行的镜像、参数、依赖。
• 容器：一个服务中可以包含多个容器实例，Compose并没有解决负载均衡的问题，因此需要借助其他工具实现服务发现及负载均衡。

Docker Compose的使用流程是什么样的呢?

Compose是一个用户定义和运行多容器的Docker应用程序，在Compose中可以使用YAML文件来配置应用服务，然后只需要一个简单的命令，就可以创建并启动配置的所有服务。使用Compose基本分为三步：

1. 使用 Dockerfile 文件定义应用的运行环境，使其可以在任何地方复制。简单来说，就是构建每个容器镜像的Dockfile。
2. 使用 docker-compose.yml 配置文件定义组成应用的各个服务，以便服务可以在隔离的环境中一起运行。简单来说，Compose将从镜像启动容器并配置其服务的YAML文件docker-compose.yml。
3. 使用 docker-compose up命令启动整个应用

Dockerfile文件有什么用呢？

• Dockerfile是由一系列命令和参数构成的脚本，用于基础镜像并最终创建一个新的镜像。
• 使用Dockerfile模板文件，可以让用户很方便的定义一个单独的应用容器。
  工作中，经常需要多个容器相互配合来完成某项任务。例如要实现一个Web项目，除了Web服务容器自身外，还需要后端数据库服务容器、负载均衡容器等。

Docker Compose配置文件是什么呢？

• Compose通过一个配置文件docker-compose.yml来管理多个Docker容器，在配置文件中，所有容器通过services来定义，然后使用docker-compose脚本来启动、停止、重启应用以及应用中的服务和所有依赖服务的容器。
• Compose的工程配置模板文件默认为docker-compose.yml，可通过环境变量COMPOSE_FILE或-f参数自定义配置文件，配置文件定义多个依赖关系的服务以及每个服务运行的容器。
• 配置文件docker-compose.yml中定义的每个服务都必须通过image指令指定镜像或通过build指令（需要Dockerfile）来自动构建。其它大部分指令和docker run命令的选项类似。
• 使用build指令在Dockerfile中设置的选项将会自动被获取，无需再docker-compose.yml配置文件中再次设置。

Docker Compose应该怎么安装呢？

环境说明：目前已Windows10中安装了VirtualBox，并在Windows10中安装了Docker Toolbox。由于Docker Toolbox中自带Docker Machine，可直接通过Docker Machine登录虚拟机。

使用Windows的Docker Toolbox工具Docker Quickstart Terminal开启命令行，输入：

# 获取当前系统安装的docker版本
$ docker -v
Docker version 18.03.0-ce, build 0520e24302

# 在当前系统使用docker-machine查看管理的docker主机（宿主机）
$ docker-machine ls
NAME      ACTIVE   DRIVER       STATE     URL                         SWARM   DOCKER     ERRORS
default   *        virtualbox   Running   tcp://192.168.99.100:2376           v18.09.5

# 使用SSH登录到default宿主机
$ docker-machine ssh default
   ( '>')   ( '>')
  /) TC (\   Core is distributed with ABSOLUTELY NO WARRANTY.
 (/-_--_-\)           www.tinycorelinux.net

# 获取root用户权限
docker@default:~ su -i
root@default:

进入Docker Compose的Github仓库 https://github.com/docker/compose/releases，根据Docker版本选择对应的发布版本。

我的机器上的Docker的版本是 18.03.0-ce, build 0520e24302，所以选择的Docker Compose的版本是1.24.0。

# 在default宿主机中下载Docker Compose
root@default: curl -L https://github.com/docker/compose/releases/download/1.24.0/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose

docker-compose下载

这Github下载的速度，的确有点儿让人捉急啊！！！

# 开启docker-compose命令可执行权限
root@default: chmod +x /usr/local/bin/docker-compose

# 查看docker-compose的版本
root@default: docker-compose --version
docker-compose version 1.24.0, build 0aa59064

Docker Compose应该怎么用呢？

以swoft为例，使用项目自带的dcoker-compose.yml文件来实现一个用于开发的环境。

1. 从Github中克隆Swoft项目

root@default:~# mkdir -r /var/www && cd /var/www
root@default:/var/www# git clone git clone https://github.com/swoft-cloud/swoft
root@default:/var/www# cd swoft
root@default:/var/www/swoft# ls
README.md          composer.json      resource
app                config             runtime

2. 创建Dockefile文件，定义应用的运行环境。

关于Dockefile文件指令的作用，可查看《Docker Dockerfile》，算了不用参见了，已经被封了。

root@default:/var/www/swoft# vi Dockerfile

FROM php:7.1

MAINTAINER huangzhhui <h@swoft.org>

# Version
ENV PHPREDIS_VERSION 4.0.0
ENV HIREDIS_VERSION 0.13.3
ENV SWOOLE_VERSION 4.0.3

# Timezone
RUN /bin/cp /usr/share/zoneinfo/Asia/Shanghai /etc/localtime \
    && echo 'Asia/Shanghai' > /etc/timezone

# Libs
RUN apt-get update \
    && apt-get install -y \
        curl \
        wget \
        git \
        zip \
        libz-dev \
        libssl-dev \
        libnghttp2-dev \
        libpcre3-dev \
    && apt-get clean \
    && apt-get autoremove

# Composer
RUN curl -sS https://getcomposer.org/installer | php \
    && mv composer.phar /usr/local/bin/composer \
    && composer self-update --clean-backups

# PDO extension
RUN docker-php-ext-install pdo_mysql

# Bcmath extension
RUN docker-php-ext-install bcmath

# Redis extension
RUN wget http://pecl.php.net/get/redis-${PHPREDIS_VERSION}.tgz -O /tmp/redis.tar.tgz \
    && pecl install /tmp/redis.tar.tgz \
    && rm -rf /tmp/redis.tar.tgz \
    && docker-php-ext-enable redis

# Hiredis
RUN wget https://github.com/redis/hiredis/archive/v${HIREDIS_VERSION}.tar.gz -O hiredis.tar.gz \
    && mkdir -p hiredis \
    && tar -xf hiredis.tar.gz -C hiredis --strip-components=1 \
    && rm hiredis.tar.gz \
    && ( \
        cd hiredis \
        && make -j$(nproc) \
        && make install \
        && ldconfig \
    ) \
    && rm -r hiredis

# Swoole extension
RUN wget https://github.com/swoole/swoole-src/archive/v${SWOOLE_VERSION}.tar.gz -O swoole.tar.gz \
    && mkdir -p swoole \
    && tar -xf swoole.tar.gz -C swoole --strip-components=1 \
    && rm swoole.tar.gz \
    && ( \
        cd swoole \
        && phpize \
        && ./configure --enable-async-redis --enable-mysqlnd --enable-openssl --enable-http2 \
        && make -j$(nproc) \
        && make install \
    ) \
    && rm -r swoole \
    && docker-php-ext-enable swoole

ADD . /var/www/swoft

WORKDIR /var/www/swoft

RUN composer install --no-dev \
    && composer dump-autoload -o \
    && composer clearcache

EXPOSE 80

ENTRYPOINT ["php", "/var/www/swoft/bin/swoft", "start"]

3. 创建docker-compose.yml， 配置各个服务。

root@default:/var/www/swoft# vi docker-compose.yml

version: '3'

services:
    swoft:
       image: swoft/swoft:latest
#       build: ./
       ports:
         - "80:80"
       volumes:
         - /share/swoft:/var/www/swoft
       stdin_open: true
       tty: true
       privileged: true
       entrypoint: ["php", "/var/www/swoft/bin/swoft", "start"]

4. 启动应用

root@default:/var/www/swoft# docker-compose up
Recreating swoft_swoft_1 ... done
Attaching to swoft_swoft_1

如果出现ERROR: In file './docker-compose.yml', the service name True must be a quoted string, i.e. 'True'.错误，需要检查下指令中是否出现名称或单双引号匹配的问题。

未完待续...