简单使用

在这一页中你会构建一个简单的Python的web应用并基于Docker Compose运行。这个应用使用了Flask框架使一个Redis里的值增长。尽管这里使用的例子是Python实现的，你可能并不使用Python，这里主要是为了演示并不用理解它。

准备

确保你已经安装了Docker Engine和Doker Compose。你不需要安装Python，我们通过Docker的image来提供它。

第一步

1. 创建一个工程目录：

$ mkdir composetest
$ cd composetest

2. 用你最喜欢的文本编辑器创建一个叫app.py的文件在你的工程目录里。

from flask import Flask
from redis import Redis

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

@app.route('/')
def hello():
    redis.incr('hits')
    return 'Hello World! I have been seen %s times.' % redis.get('hits')

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

3. 创建另一个requirements.txt在你的工程目录里，加入下面的内容：

flask
redis

这里定义了这个应用的依赖。

第二步：创建一个Docker image

在这一步里，你将构建一个新的Docker image。这个image包含了这个Python应用需要的所有的依赖，包括Python自己。

1. 在你的工程目录里创建一个Dockerfile文件，添加如下内容：

FROM python:2.7
ADD . /code
WORKDIR /code
RUN pip install -r requirements.txt
CMD python app.py

这些命令告诉Docker：

• 基于Python2.7镜像构建一个镜像。
• 添加当前目录.到镜像的/code路径
• 设置工作目录为/code
• 安装Python依赖
• 设置python app.py为容器的默认命令。

关于如何写Dockerfile的更多信息，可以看 Docker用户指南和Dockerfile 参考。

1. 构建镜像。

$ docker build -t web .

这个命令构建了一个名为web的镜像根据当前目录的内容。这个命令会自动发现Dockerfile，app.py和requirements.txt文件。

第三部：定义服务

使用docker-compose.yml来定义一组服务。

1. 创建docker-compose.yml文件在你的工程目录中，然后添加下面的内容：

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

这个Compose文件定义了两个服务，web和redis。这个web服务：

• 基于当前目录的Dockerfile构建。
• 将主机的5000端口暴露出来并转发到container的5000端口。
• 挂在主机的工程目录到容器的/code，这样你就可以不用重构镜像就可以修改代码了。
• 链接这个web服务和Redis服务。

这个redis服务使用的image是从Docker Hub上pull下的最新版。

第四部：通过Compose构建并运行你的app

1. 在你的工程目录中启动你的app。

$ docker-compose up
Pulling image redis...
Building web...
Starting composetest_redis_1...
Starting composetest_web_1...
redis_1 | [8] 02 Jan 18:43:35.576 # Server started, Redis version 2.8.3
web_1   |  * Running on http://0.0.0.0:5000/
web_1   |  * Restarting with stat

Compose pull下一个Redis image，根据你的代码构建，然后启动你定义的服务。

2. 通过http://0.0.0.0:5000/在浏览器中可以看到这个运行的app。

如果你使用的是Linux的原生Docker，这个web app现在应该监听了你的Docker daemon主机的5000端口。如果http://0.0.0.0:5000不能够被解析，你也可以试试http://localhost:5000。

如果你使用的是Mac的Docker Machine，使用docker-machine ip MACHINE_VM去获取Docker主机的IP地址。然后在浏览器中打开http://MACHINE_VM_IP:5000。

你应该可以在你的浏览器里看到这样的消息：

Hello World! I have been seen 1 times.

3. 刷新网页。

这个time次数应该会增长。

第五部：尝试下其它的命令

如果你想运行服务在后台，你可以通过docker-compose up的-d标识。然后使用docker-compose ps去查看当前的运行信息：

$ docker-compose up -d
    Starting composetest_redis_1...
    Starting composetest_web_1...
    $ docker-compose ps
    Name                 Command            State       Ports
    -------------------------------------------------------------------
    composetest_redis_1   /usr/local/bin/run         Up
    composetest_web_1     /bin/sh -c python app.py   Up      5000->5000/tcp

命令docker-compose run允许你为你的服务运行一次性的命令。比如，如果想要看看web服务的环境变量：

 $ docker-compose run web env

通过docker-compose --help可以看看其它可用的命令。

如果你使用docker-compose up -d启动的Compose，想要停止服务，你可以一次性停止它们：

    $ docker-compose stop

至此，你已经看到了关于Compose的基本使用。