【云原生丨Docker系列9】Docker Compose使用详解

前言

大家好，今天我们来详细地学习Docker Compose的安装、卸载、容器中执行、使用等方法。

目录

一、介绍

二、安装

二进制安装

PIP安装

三、容器中执行

四、卸载

五、使用

---

一、介绍

Docker Compose 是 Docker 官⽅编排（Orchestration）项⽬之⼀，负责快速的部署分布式应⽤。其代 码⽬前在https://github.com/docker/compose上开源。Compose 定位是 「定义和运⾏多个 Docker 容器的应⽤（Defining and running multi-container Docker applications）」，其前身是开源项⽬ Fig 。

前⾯我们已经学习过使⽤⼀个 Dockerfile 模板⽂件，可以很⽅便的定义⼀个单独的应⽤容器。然⽽， 在⽇常⼯作中，经常会碰到需要多个容器相互配合来完成某项任务的情况。例如要实现⼀个 Web 项⽬，除了 Web 服务容器本身，往往还需要再加上后端的数据库服务容器或者缓存服务容器，甚⾄还包 括负载均衡容器等。Compose 恰好满⾜了这样的需求。它允许⽤户通过⼀个单独的 docker- compose.yml 模板⽂件（YAML 格式）来定义⼀组相关联的应⽤容器为⼀个项⽬（project）。

Compose 中有两个重要的概念：

服务 (service)：⼀个应⽤的容器，实际上可以包括若⼲运⾏相同镜像的容器实例。

项⽬ (project)：由⼀组关联的应⽤容器组成的⼀个完整业务单元，在 docker-compose.yml ⽂件中 定义。

Compose 的默认管理对象是[ 项⽬ ]，通过⼦命令对项⽬中的⼀组容器进⾏便捷地⽣命周期管理。 Compose 项⽬由 Python 编写，实现上调⽤了 Docker 服务提供的 API 来对容器进⾏管理。所以只要所操作的平台⽀持 Docker API，就可以在其上利⽤ Compose 来进⾏编排管理。

二、安装

Compose ⽀持 Linux、macOS、Windows 10 三⼤平台。Compose 可以通过 Python 的包管理⼯ 具 pip 进⾏安装，也可以直接下载编译好的⼆进制⽂件使⽤，甚⾄能够直接在 Docker 容器中运⾏。 前两种⽅式是传统⽅式，适合本地环境下安装使⽤；最后⼀种⽅式则不破坏系统环境，更适合云计算场景。Docker for Mac 、Docker for Windows ⾃带 docker-compose ⼆进制⽂件，安装 Docker 之后 可以直接使⽤。

$ docker-compose --version 
docker-compose version 1.17.1, build 6d101fb

二进制安装

在 Linux 上的也安装⼗分简单，从 官⽅ GitHub Release 处直接下载编译好的⼆进制⽂件即可。例 如，在 Linux 64 位系统上直接下载对应的⼆进制包。

$ sudo curl -L https://github.com/docker/compose/releases/download/1.17.1/docker-compose-` uname -s`-`uname -m` > /usr/local/bin/docker-compose 
$ sudo chmod +x /usr/local/bin/docker-compose

PIP安装

注： x86_64 架构的 Linux 建议按照上边的⽅法下载⼆进制包进⾏安装，如果您计算机的架构是ARM ( 例如，树莓派 ) ，再使⽤ pip 安装。

这种⽅式是将 Compose 当作⼀个 Python 应⽤来从 pip 源中安装。执⾏安装命令：

$ sudo pip install -U docker-compose 
Collecting docker-compose
 Downloading docker-compose-1.17.1.tar.gz (149kB): 149kB downloaded 
... 
Successfully installed docker-compose cached-property requests texttable websocket-client 
docker-py dockerpty six enum34 backports.ssl-match-hostname ipaddress

bash补全命令：

$ curl -L https://raw.githubusercontent.com/docker/compose/1.8.0/contrib/completion/bash/d ocker-compose > /etc/bash_completion.d/docker-compose

三、容器中执行

Compose 既然是⼀个 Python 应⽤，⾃然也可以直接⽤容器来执⾏它。

$ curl -L https://github.com/docker/compose/releases/download/1.8.0/run.sh > /usr/local/bi n/docker-compose 
$ chmod +x /usr/local/bin/docker-compose

实际上，查看下载的 run.sh 脚本内容，如下:

set -e 
VERSION="1.8.0" 
IMAGE="docker/compose:$VERSION" 
# Setup options for connecting to docker hostif [ -z "$DOCKER_HOST" ]; then 
DOCKER_HOST="/var/run/docker.sock"fiif [ -S "$DOCKER_HOST" ]; then 
DOCKER_ADDR="-v $DOCKER_HOST:$DOCKER_HOST -e DOCKER_HOST"else 
DOCKER_ADDR="-e DOCKER_HOST -e DOCKER_TLS_VERIFY -e DOCKER_CERT_PATH"fi 
# Setup volume mounts for compose config and contextif [ "$(pwd)" != '/' ]; then 
VOLUMES="-v $(pwd):$(pwd)"fiif [ -n "$COMPOSE_FILE" ]; then 
compose_dir=$(dirname $COMPOSE_FILE)fi# TODO: also check --file argumentif [ -n "$comp 
ose_dir" ]; then 
VOLUMES="$VOLUMES -v $compose_dir:$compose_dir"fiif [ -n "$HOME" ]; then 
VOLUMES="$VOLUMES -v $HOME:$HOME -v $HOME:/root" # mount $HOME in /root to share docke 
r.configfi 
# Only allocate tty if we detect oneif [ -t 1 ]; then 
DOCKER_RUN_OPTIONS="-t"fiif [ -t 0 ]; then 
DOCKER_RUN_OPTIONS="$DOCKER_RUN_OPTIONS -i"fi 
exec docker run --rm $DOCKER_RUN_OPTIONS $DOCKER_ADDR $COMPOSE_OPTIONS $VOLUMES -w "$(pwd)" 
$IMAGE "$@

可以看到，它其实是下载了 docker/compose 镜像并运⾏。

四、卸载

如果是⼆进制包⽅式安装的，删除⼆进制⽂件即可。

$ sudo rm /usr/local/bin/docker-compose

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

$ sudo pip uninstall docker-compose

五、使用

下⾯我们⽤ Python 来建⽴⼀个能够记录⻚⾯访问次数的 web ⽹站。 新建⽂件夹，在该⽬录中编 写 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) 
if __name__ == "__main__": 
app.run(host="0.0.0.0", debug=True) 

 接着编写 Dockerfile ⽂件，内容为:

FROM python:3.6-alpine 
ADD . /code 
WORKDIR /code 
RUN pip install redis flask 
CMD ["python", "app.py"] 

然后是编写 docker-compose.yml ⽂件，这个是 Compose 使⽤的主模板⽂件。

version: '3' 
services: 
web: 
build: . 
ports: 
- "5000:5000" 
volumes: 
- .:/code 
redis: 
image: "redis:alpine" 

运⾏ compose 项⽬:

$ docker-compose up

此时访问本地 5000 端⼝，每次刷新⻚⾯，计数就会加 1。

---