最近学习《第一本docker书》, 学习完 Docker Compose 这一章节之后打算自己使用它来构建一个使用 php 和 python 做的简易web app, 遂作此记录。本篇学习笔记只是为了学习docker-compose的用法, 并不具体介绍flask和php的语法。
一、Docker Compose
使用 Docker Compose 可以用一个YAML文件定义一组要启动的容器, 以及容器运行时的属性, Docker Compose称这些容器为 “服务”。
二、实现过程
新建文件夹flask-php 作为项目根目录, cd 到flask-php文件夹, 新建文件夹product, 进入product 并创建一个名为api.py的文件,其功能是提供给我们必要的数据:
from flask import Flask
from flask_restful import Resource, Api
app = Flask(__name__)
api = Api(app)
class Product(Resource):
def get(self):
return {
'products': ['Apple', 'Candy', 'Pineapple']
}
api.add_resource(Product, '/')
if __name__ == '__main__':
app.run(host='0.0.0.0', port=80, debug=True)
新建requirements.txt文件, 用于在构建镜像时安装必要的python依赖包
Flask==0.12
flask-restful==0.3.5
新建Dockerfile文件, 帮助我们之后进行镜像的构建
FROM python:3.5
COPY . /usr/src/app
WORKDIR /usr/src/app
RUN pip install -r requirements.txt
CMD ["python", "api.py"]
cd到项目的根目录, 新建一个名为web的文件夹,进入web文件夹并新建index.php文件
Docker Compose Test
Welcome Here
products;
foreach ($products as $product) {
echo "- $product
";
}
?>
接着,我们需要为我们的web app构建镜像, 我们可以配置Compose来构建镜像并创建需要的服务。 在compose中, 我们定义一组要启动的服务(以dockers容器的形式表现),我们还定义了我们希望这些服务要启动的运行时属性, 这些属性和 docker run 命令需要的参数类似,将所有与服务有关的属性定义在一个 YAML 文件中。 回到项目根目录,新建一个docker-compose.yml文件,内容如下:
version: '3'
services:
product:
build: ./product
volumes:
- ./product:/usr/src/app
ports:
- 5001:80
web:
image: php:apache
volumes:
- ./web:/var/www/html
ports:
- 5000:80
depends_on:
- product
第一行的version: '3'
并不是指定你安装的Docker Compose的版本, 实际上他和 Docker Compose的版本并无直接关系, 它指明的是你的compose file是使用版本3的格式来进行编写的。
第二行开始就是我们docker-compose文件的主要内容, 它启动了两个服务: product和web。
对于product服务,我们先使用bulid构建一个镜像, 服务除了可以基于指定的镜像,还可以基于一份 Dockerfile,它可以指定 Dockerfile 所在文件夹的路径, 在本例中为docker-compose.yml所在目录下的product文件夹。之后,我们使用volumes 挂载一个目录, 最后,我们使用ports进行端口映射, 本例是将容器的80端口映射到宿主机的5001端口之上。
对于web服务, 它与product服务类似, 不同之处在于它直接使用了image指定了要使用的镜像, 注意最后的depends_on,一般项目容器启动的顺序是有要求的,如果直接从上到下启动容器,必然会因为容器依赖问题而启动失败,所以在yml文件中我们通过depend_on标签来先启动product服务, 解决容器的依赖。
以上步骤完成后, 整个项目的结构应该是:
E:.
│ docker-compose.yml
│
├─product
│ api.py
│ Dockerfile
│ requirements.txt
│
└─web
index.php
三、运行Compose
回到项目根目录, 通过docker-compose up
命令来执行这些服务。
在浏览器中输入 localhost:5000 来访问我们的web app, 显示如下:
同样,我们也可以通过localhost:5001 来访问我们的api:
四、总结
使用compose能够非常简单的构建一个需要Doker容器的应用程序, 本例子只展示了Compose最表层的能力,Compose的官网上有很多例子,比如使用Rails、Django、WordPress来展现更高级的概念。