Get started with Docker Compose
本例中将通过Compose创建一个简单的基于Flask框架的web应用，该应用会通过redis服务实现点击计数。
应用依赖配置
- 为项目创建一个目录
mkdir composetest
cd composetest
- 准备一个简单的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)
- 创建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获取镜像启动容器
构建并启动应用
- 到项目目录中执行
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
- 浏览器打开
http://hostname:5000查看效果
docker-compose-hitcount.png -
刷新几下页面看下效果
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/)