Docker-compose使用

Docker-compose简介

Compose是一个用于定义和运行多容器Docker应用程序的工具，前身是FIG，非常适合在开发、测试、构建CI工作流等场景。一个使用Docker容器的应用，通常由多个容器组成。使用Docker Compose不再需要使用shell脚本来启动容器。 
Compose 通过一个配置文件来管理多个Docker容器，在配置文件中，所有的容器通过services来定义，然后使用docker-compose脚本来启动，停止和重启应用，和应用中的服务以及所有依赖服务的容器，非常适合组合使用多个容器进行开发的场景。

Compose和Docker兼容性

compose文件格式版本	docker版本
3.4	17.09.0+
3.3	17.06.0+
3.2	17.04.0+
3.1	1.13.1+
3.0	1.13.0+
2.3	17.06.0+
2.2	1.13.0+
2.1	1.12.0+
2.0	1.10.0+
1.0	1.9.1.+

Docker版本变化说明：

Docker从1.13.x版本开始，版本分为企业版EE和社区版CE，版本号也改为按照时间线来发布，比如17.03就是2017年3月。

Docker的linux发行版的软件仓库从以前的https://apt.dockerproject.org和https://yum.dockerproject.org变更为目前的https://download.docker.com, 软件包名字改为docker-ce和docker-ee。

1、安装docker

Docker的社区版（Docker Community Edition）叫做docker-ce。老版本的Docker包叫做docker或者docker-engine，如果安装了老版本的docker得先卸载然后再安装新版本的docker。docker的发展非常迅速，apt源的更新往往比较滞后。所以docker官网推荐的安装方式都是下载docker安装脚本安装，也可通过Shell、pip安装。 
卸载老旧的版本（若未安装过可省略此步）：

$ sudo apt-get remove docker docker-engine docker.io

安装最新的docker：

$ curl -fsSL get.docker.com -o get-docker.sh
$ sudo sh get-docker.sh

shell会提示你输入sudo的密码，然后开始执行最新的docker过程 

或者

$ curl -sSL https://get.docker.com/ | sh 

确认Docker成功最新的docker：

$ sudo docker run hello-world

安装docker-compose

两种最新的docker安装方式

1.从github上下载docker-compose二进制文件安装

• 下载最新版的docker-compose文件 
   $ sudo curl -L "https://github.com/docker/compose/releases/download/1.16.1/docker-compose-`uname -s`-`uname -m`" -o /usr/local/bin/docker-compose                                                           
• 添加可执行权限 
   $ sudo chmod +x /usr/local/bin/docker-compose                                     
• 测试安装结果 
  $ docker-compose --version                                                                                     
docker-compose version 1.16.1, build 1719ceb                                                                   

安装Compose命里补全工具

 curl -L https://raw.githubusercontent.com/docker/compose/$(docker-compose version--short)                         

/contrib/completion/bash/docker-compose  -o /etc/bash_completion.d/docker-compose                                  

2.pip安装

$ sudo pip install docker-compose

---

5.docker-compose文件结构和示例

docker-compose文件结构

docker-compose.yml:

version: "3"
services:

  redis:
    image: redis:alpine
    ports:
      - "6379"
    networks:
      - frontend
    deploy:
      replicas: 2
      update_config:
        parallelism: 2
        delay: 10s
      restart_policy:
        condition: on-failure

  db:
    image: postgres:9.4
    volumes:
      - db-data:/var/lib/postgresql/data
    networks:
      - backend
    deploy:
      placement:
        constraints: [node.role == manager]

  vote:
    image: dockersamples/examplevotingapp_vote:before
    ports:
      - 5000:80
    networks:
      - frontend
    depends_on:
      - redis
    deploy:
      replicas: 2
      update_config:
        parallelism: 2
      restart_policy:
        condition: on-failure

  result:
    image: dockersamples/examplevotingapp_result:before
    ports:
      - 5001:80
    networks:
      - backend
    depends_on:
      - db
    deploy:
      replicas: 1
      update_config:
        parallelism: 2
        delay: 10s
      restart_policy:
        condition: on-failure

  worker:
    image: dockersamples/examplevotingapp_worker
    networks:
      - frontend
      - backend
    deploy:
      mode: replicated
      replicas: 1
      labels: [APP=VOTING]
      restart_policy:
        condition: on-failure
        delay: 10s
        max_attempts: 3
        window: 120s
      placement:
        constraints: [node.role == manager]

  visualizer:
    image: dockersamples/visualizer:stable
    ports:
      - "8080:8080"
    stop_grace_period: 1m30s
    volumes:
      - "/var/run/docker.sock:/var/run/docker.sock"
    deploy:
      placement:
        constraints: [node.role == manager]

networks:
  frontend:
  backend:

volumes:
  db-data:

docker-compose使用示例

通过docker-compose构建一个在docker中运行的基于python flask框架的web应用。

注意：确保你已经安装了Docker Engine和Docker Compose。 您不需要安装Python或Redis，因为这两个都是由Docker镜像提供的。

Step 1: 定义python应用

• 1 .创建工程目录

$ mkdir compose_test
$ cd compose_test
$ mkdir src      # 源码文件夹
$ mkdir docker  # docker配置文件夹

目录结构如下： 

• 2 .在compose_test/src/目录下创建python flask应用 compose_test/src/app.py文件。

from flask import Flask
from redis import Redis

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

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

if __name__ == "__main__":
    app.run(host="0.0.0.0", debug=True)

• 3 .创建python 需求文件 compose_test/docker/requirements.txt

flask
redis

Step 2: 创建容器的Dockerfile文件

一个容器一个Dockerfile文件 
为了工程目录更加清晰，在compose_test/docker/目录下创建compose_test/docker/web目录

$ cd docker
$ mkdir web

在compose_test/docker/web/目录中创建Dockerfile文件：

FROM python:3.4ADD . /docker      
ADD ../../src /src  # ADD的源路径应该在Dockerfile文件的上下文环境中（即Dockerfile文件所在根目录及其子目录下，如ADD . /src是合法的，而ADD ../../src /src不合法），此处为了清晰的项目结构，只是展示ADD指令，实际中应该用volumes挂载
WORKDIR /src
RUN pip install -r /docker/requirements.txt
CMD ["python", "app.py"]

Dockerfile文件告诉docker了如下信息：

从Python 3.4镜像开始构建一个容器镜像。 

复杂当前 . （即compose_test/docker）目录到容器的/docker目录。

复制../../src目录（即compose_test/src） 到容器中的/src目录（此处../../src是不合法的路径，ADD的源路径必须在Dockerfile文件的上下文环境中，即Dockerfile文件所在根目录或起子目录中，实际应该使用volumes挂载项目源文件）。 

将容器的工作目录设置为/src。 
安装Python依赖关系。
将容器的默认命令设置为python app.py。

Step 3: 定义docker-compose脚本

在compose_test/docker/目录下创建docker-compose.yml文件，并在里面定义服务，内容如下：

version: '3'
services:
  web:
    build: ./web/
    ports:
     - "5000:5000"
  redis:
    image: "redis:3.0.7"

这个compose文件定义了两个服务，即定义了web和redis两个容器。 
web容器： 
* 使用当前的web目录（compose_test/docker/web/）中的Dockerfile构建映像。 
* 将容器上的暴露端口5000映射到主机上的端口5000。 我们使用Flask Web服务器的默认端口5000。 
redis容器： 
* redis服务使用从Docker Hub提取的官方redis镜像3.0.7版本。

Step 4: 使用Compose构建并运行您的应用程序

在compose_test/docker/目录下执行docker-compose.yml文件：

$ docker-compose up
# 若是要后台运行： $ docker-compose up -d
# 若不使用默认的docker-compose.yml 文件名：
$ docker-compose -f server.yml up -d 

然后在浏览器中输入http://0.0.0.0:5000/查看运行的应用程序。

Step 5: 编辑compose文件以添加文件绑定挂载

上面的代码是在构建时静态复制到容器中的，即通过Dockerfile文件中的ADD ./src /src命令实现物理主机中的源码复制到容器中，这样在后续物理主机src目录中代码的更改不会反应到容器中。 
可以通过volumes 关键字实现物理主机目录挂载到容器中的功能（同时删除Dockerfile中的ADD指令，不需要创建镜像时将代码打包进镜像，而是通过volums动态挂载，容器和物理host共享数据卷）：

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

通过volumes（卷）将主机上的项目目录（compose_test/src）挂载到容器中的/src目录下，允许您即时修改代码，而无需重新构建映像。

Step 6: 重新构建和运行应用程序

使用更新的compose文件构建应用程序，然后运行它。

$ docker-compose up -d