【云原生丨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 "[email protected]

可以看到,它其实是下载了 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。