docker-compose 学习笔记

最近学习《第一本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文件

<html>
 <head>
 <title>Docker Compose Test</title>
 </head>
​
 <body>
 <h1>Welcome Here</h1>
 <ul>
 <?php
     $json = file_get_contents('http://product/');
     $data = json_decode($json);
     $products = $data->products;
     foreach ($products as $product) {
         echo "<li>$product</li>";
     }
 ?>
 </ul>
 </body>
</html>

接着,我们需要为我们的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, 显示如下:

pic1.jpg

同样,我们也可以通过localhost:5001 来访问我们的api:

pic2.jpg

四、总结

使用compose能够非常简单的构建一个需要Doker容器的应用程序, 本例子只展示了Compose最表层的能力,Compose的官网上有很多例子,比如使用RailsDjangoWordPress来展现更高级的概念。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容