Docker Compose 初试

Get started with Docker Compose
本例中将通过Compose创建一个简单的基于Flask框架的web应用，该应用会通过redis服务实现点击计数。

应用依赖配置

1. 为项目创建一个目录

mkdir composetest
cd composetest

2. 准备一个简单的flask应用，如下创建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环境依赖文件requirements.txt

flask
redis

创建Dockerfile

Dockerfile 内容如下

FROM python:3.4-alpine
ADD . /code
WORKDIR /code
RUN pip install -r requirements.txt
CMD ["python", "app.py"]

• 基于python:3.4-alpine镜像构建
• copy当前目录到镜像中的/code目录
• 定义/code为工作目录
• 安装python依赖库
• 容器启动时运行 python app.py命令

创建Compose file

创建文件docker-compose.yml

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

上面的文件定义了两个服务: web和redis。
对于web服务：

• 使用当前目录下的Dockerfile构建出来的镜像
• 映射宿主机的5000端口到容器的5000端口
• 挂载当前目录到容器的/code目录，从而实现在不重构镜像的前提下更新代码

对于redis服务，直接从Docker Hub获取镜像启动容器

构建并启动应用

1. 到项目目录中执行docker-compose up命令

shell> docker-compose up -d
Starting composetest_web_1
Starting composetest_redis_1
shell> docker ps 
CONTAINER ID        IMAGE               COMMAND                  CREATED              STATUS              PORTS                    NAMES
3431bb8a69d8        composetest_web     "python app.py"          About a minute ago   Up 4 seconds        0.0.0.0:5000->5000/tcp   composetest_web_1
2a819996dcc3        redis:alpine        "docker-entrypoint.sh"   About a minute ago   Up 4 seconds        6379/tcp                 composetest_redis_1

2. 浏览器打开http://hostname:5000 查看效果
   docker-compose-hitcount.png

3. 刷新几下页面看下效果

   
   docker-compose-2.png

更新应用代码

因为代码工作目录是通过volumn挂载上去的，所以可以直接修改项目目录文件即可，无需重新构建镜像
尝试修改app.py文件，例如：

return 'Hello from Docker! I have been seen {} times.\n'.format(count)

然后刷新下页面看看

docker-compose-3.png

其他compose命令的使用

从上面的例子可以知道docker-compose up用于启动应用，加上-d参数可以使应用运行于后台。

• docker-compose ps 可以查看目前运行中的应用

shell> docker-compose ps
     Name                      Command               State           Ports          
-------------------------------------------------------------------------------------
composetest_redis_1   docker-entrypoint.sh redis ...   Up      6379/tcp               
composetest_web_1     python app.py                    Up      0.0.0.0:5000->5000/tcp 

• docker-compose run <SERVICE> <COMMAND> [ARGS...] 用于在服务中执行一次性命令，注意要在docker-compose.yml文件所在目录下执行

  shell> docker-compose run web env
  

PATH=/usr/local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
HOSTNAME=8a468aa0224f
TERM=xterm
LANG=C.UTF-8
GPG_KEY=97FC712E4C024BBEA48A61ED3A5CA953F73C700D
PYTHON_VERSION=3.4.6
PYTHON_PIP_VERSION=9.0.1
HOME=/root

* `docker-compose --help`，查看其他可用的命令，对于子命令也可以通过`--help`查看帮助
* `docker-compose stop` 可以用于关闭应用容器 
* `docker-compose down` 可以用于卸下容器所有的设备，甚至完全移除容器，如`--volumns` 参数可以卸载容器挂载的卷

> [Compose command-line reference](https://docs.docker.com/compose/reference/)