Docker-Compose

Docker-Compose

我们使用 Docker 的时候，定义 Dockerfile 文件，然后使用 docker build、docker run 等命令操作容器。然而微服务架构的应用系统一般包含若干个微服务，每个微服务一般都会部署多个实例，如果每个微服务都要手动启停，那么效率之低，维护量之大可想而知。那有没有一种方式能让我们的项目快速启动呢？
然而使用 Docker Compose 可以轻松、高效的管理容器，它是一个用于定义和运行多容器 Docker 的应用程序工具。

Docker Compose 的安装

Docker Desktop for Mac/Windows 自带 Docker Compose 二进制文件，安装 Docker 之后可以直接使用。由于笔者的环境是Linux，所以我们只讲述Linux的安装方法。

Docker Compose 在Linux的安装非常简单，我们只需要下载编译好的二进制文件并为脚本添加可执行权限即可：

sudo curl -L https://github.com/docker/compose/releases/download/1.29.1/docker-compose-Linux-x86_64 > /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

安装完成后，我们可以使用docker-compose -v命令来查看Docker Compose是否安装成功。

如何使用docker compose

• Docker Compose 将所管理的容器分为三层，分别是工程（project）、服务（service）、容器（container）
• Docker Compose 运行目录下的所有文件（docker-compose.yml）组成一个工程,一个工程包含多个服务，每个服务中定义了容器运行的镜像、参数、依赖，一个服务可包括多个容器实例。
• 使用Compose 基本上分为三步
  （1）Dockerfile 定义应用的运行环境
  （2）docker-compose.yml 定义组成应用的各服务
  （3）docker-compose up 启动整个应用
• 下面我们运行一个 compose 项目来实时更新网页被访问次数：

1. 创建一个测试目录：

mkdir test
cd test

2. 在测试目录中创建一个名为 app.py 的文件，并复制粘贴以下内容：

import time

import redis
from flask import Flask

app = Flask(__name__)
cache = redis.Redis(host='redis', port=6379)


def get_hit_count():
    retries = 5
    while True:
        try:
            return cache.incr('hits')
        except redis.exceptions.ConnectionError as exc:
            if retries == 0:
                raise exc
            retries -= 1
            time.sleep(0.5)


@app.route('/')
def hello():
    count = get_hit_count()
    return 'Hello World! I have been seen {} times.\n'.format(count)

3. 在test目录中创建另一个名为 requirements.txt 的文件，内容如下：

flask
redis

4. 创建 Dockerfile 文件

FROM python:3.7-alpine
WORKDIR /code
ENV FLASK_APP app.py
ENV FLASK_RUN_HOST 0.0.0.0
RUN apk add --no-cache gcc musl-dev linux-headers
COPY requirements.txt requirements.txt
RUN pip install -r requirements.txt
COPY . .
CMD ["flask", "run"]

5. 创建 docker-compose.yml

# yaml 配置
version: '3'
services:
  web:
    build: .
    ports:
     - "5000:5000"
  redis:
    image: "redis:alpine"

6. 使用 Compose 命令构建和运行您的应用
   在测试目录中，执行以下命令来启动应用程序：

docker-compose up

但是直接通过这种方式的话会直接将启动时的输出打印到终端，所以我们常会加上-d参数采用后台启动方式。

bash docker-compose up -d

docker-compose.yml 属性

• version：指定 docker-compose.yml 文件的写法格式
• services：多个容器集合
• build：配置构建时，Compose 会利用它自动构建镜像，该值可以是一个路径，也可以是一个对象，用于指定 Dockerfile 所在文件夹的路径。
• depends_on：解决容器的依赖、启动先后的问题。
• command：覆盖容器启动后默认执行的命令
• dns：配置 dns 服务器，可以是一个值或列表
• dns_search：配置 DNS 搜索域，可以是一个值或列表
• environment：环境变量配置，可以用数组或字典两种方式，只给定名称的变量会自动获取运行 Compose 主机上对应变量的值，可以用来防止泄露不必要的数据。
• env_file：从文件中获取环境变量，可以指定一个文件路径或路径列表，其优先级低于 environment 指定的环境变量
• expose：暴露端口，只将端口暴露给连接的服务，而不暴露给主机，只被连接的服务访问。仅可以指定内部端口为参数
• ports：对外暴露的端口定义，和 expose 对应
• secrets：存储敏感数据，例如 mysql 服务密码、
• image：指定为镜像名称或镜像 ID。如果镜像在本地不存在，Compose 将会尝试拉取这个镜像
• labels：为容器添加 Docker 元数据（metadata）信息。例如可以为容器添加辅助说明信息
• network_mode：设置网络模式。使用和 docker run 的 --networ 参数一样的值。
• networks：配置容器连接的网络。
• volumes：数据卷所挂载路径设置。可以设置为宿主机路径(HOST:CONTAINER)或者数据卷名称(VOLUME:CONTAINER)，并且可以设置访问模式 （HOST:CONTAINER:ro）。该指令中路径支持相对路径。
• logs：日志输出信息

Compose命令

up

该命令十分强大，它将尝试自动完成包括构建镜像，（重新）创建服务，启动服务，并关联服务相关容器的一系列操作。

链接的服务都将会被自动启动，除非已经处于运行状态。可以说，大部分时候都可以直接通过该命令来启动一个项目。

默认情况，docker-compose up 启动的容器都在前台，控制台将会同时打印所有容器的输出信息，可以很方便进行调试。

当通过 Ctrl-C 停止命令时，所有容器将会停止。

默认情况，如果服务容器已经存在，docker-compose up 将会尝试停止容器，然后重新创建（保持使用 volumes-from 挂载的卷），以保证新启动的服务匹配 docker-compose.yml 文件的最新内容。如果用户不希望容器被停止并重新创建，可以使用 docker-compose up --no-recreate。这样将只会启动处于停止状态的容器，而忽略已经运行的服务。如果用户只想重新部署某个服务，可以使用 docker-compose up --no-deps -d 来重新创建服务并后台停止旧服务，启动新服务，并不会影响到其所依赖的服务。

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文件中定义的容器
• –scale SERVICE=NUM 设置服务运行容器的个数，将覆盖在compose中通过scale指定的参数

其他命令本文不再详写，如需学习请查看：Docker-compose 常用命令

使用Docker-Compose做负载均衡：

1. 因为本机上的5000端口，只能分配给一个service，如果你想同时在本机上调试，可以将上面的ports改为5000，修改后的docker-compose文件如下：

# yaml 配置
version: '3'
services:
  web:
    build: .
    ports:
     - "5000:5000"
  redis:
    image: "redis:alpine"

此时会有3个不同的本机端口绑定到容器的5000端口
2. 使用Haproxy

• 安装haproxy:
  Ubuntu安装只需使用如下命令即可安装Haporxy
  apt-get install haproxy

修改docker-compose.yml文件

# yaml 配置
version: '3'
services:
  web:
    build: .
    ports:
     - "5000:5000"
  redis:
    image: "redis:alpine"
web2:
    build: .
    ports:
     - "5000:5000"
  redis:
    image: "redis:alpine
haproxy:
      image: haproxy:latest
      volumes:
              - ./haproxy/haproxy.cfg:/usr/local/etc/haproxy/haproxy.cfg:ro
      links:
              - web1
              - web2
      ports:
              - "5000:5000"
      expose:
              - 5000

本文只讲述此案例，更多Haproxy用法和配置文件详解请看HAProxy用法详解 全网最详细中文文档