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文件


 
 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, 显示如下:

docker-compose 学习笔记_第1张图片
pic1.jpg

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

docker-compose 学习笔记_第2张图片
pic2.jpg

四、总结

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

你可能感兴趣的:(docker-compose 学习笔记)