docker-compose使用示例

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.4
ADD . /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