简单使用
在这一页中你会构建一个简单的Python的web应用并基于Docker Compose运行。这个应用使用了Flask框架使一个Redis里的值增长。尽管这里使用的例子是Python实现的，你可能并不使用Python，这里主要是为了演示并不用理解它。
准备
确保你已经安装了Docker Engine和Doker Compose。你不需要安装Python，我们通过Docker的image来提供它。
第一步
- 创建一个工程目录：
$ mkdir composetest
$ cd composetest
- 用你最喜欢的文本编辑器创建一个叫
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)
- 创建另一个
requirements.txt在你的工程目录里，加入下面的内容：
flask
redis
这里定义了这个应用的依赖。
第二步：创建一个Docker image
在这一步里，你将构建一个新的Docker image。这个image包含了这个Python应用需要的所有的依赖，包括Python自己。
- 在你的工程目录里创建一个
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 参考。
- 构建镜像。
$ docker build -t web .
这个命令构建了一个名为web的镜像根据当前目录的内容。这个命令会自动发现Dockerfile，app.py和requirements.txt文件。
第三部：定义服务
使用docker-compose.yml来定义一组服务。
- 创建
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
- 在你的工程目录中启动你的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，根据你的代码构建，然后启动你定义的服务。
- 通过
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.
- 刷新网页。
这个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的基本使用。
