本文基于docker-compose进行python项目的docker实践。
一、实践环境&版本:
1. Docker: 18.03.0-ce
2. Docker Compose: 1.20.1
3. Python Image: 3.7.0b4
二、应具备知识:
1. Python基础
2. Docker基础
3. Docker Compose知识
4. SHELL脚本基础
三、目录结构
image.png目录结构截图
/app # python应用目录
api.py # API入口脚本
/docker # docker运行目录
docker-compose.yml # docker compose脚本
requirements.txt # python组件清单
run.sh # 容器启动执行脚本
四、API入口文件样例:
1. api.py
from flask import Flask, request
# 创建一个服务,赋值给APP
app = Flask(__name__)
# 指定接口访问的路径,支持什么请求方式get,post
@app.route('/HelloWorld', methods=['post', 'get'])
# 请求后直接拼接入参方式
def get_ss():
# 使用request.args.get方式获取拼接的入参数据
name = request.args.get('name')
# 输出结果
return 'Hello World! ' + name
app.run(host='0.0.0.0', port=8880, debug=True)
# 这个host:windows就一个网卡,可以不写,而liux有多个网卡,写成'0.0.0.0'可以接受任意网卡信息
五、Docker相关文件说明
1. docker-compose.yml
version: "3" # docker-compose版本
services:
docker-python-demo: # docker-compose编排名称,一般同微服务名称,注意不要与其他服务重名
image: "python:3.7.0b4" # docker镜像名及版本
hostname: docker-python-demo # docker容器主机名
container_name: docker-python-demo # docker容器名
volumes: # 挂载目录
- ../app:/app # 项目相关
- ../docker:/docker # docker相关
ports: # 端口映射
- "8880:8880"
environment: # 配置环境变量
- TZ=Asia/Shanghai # 设置时区
command: bash /docker/run.sh # 设置启动命令
network_mode: bridge # 网络模式:host、bridge、none等,我们使用bridge
restart: unless-stopped # 自动启动:unless-stopped、always等,unless-stopped为非正常停止则自动启动
# external_links: # 外链其他服务,此处名称为docker-compose编排名
# - mongodb
2. requirements.txt
一行一个
flask
requests
3. run.sh
#!/bin/bash
# 使用阿里云源安装必须组件
pip install -i -r /docker/requirements.txt
# 运行API入口脚本
python /app/api.py
六、开始运行
在docker目录执行命名,如需后台运行,加参数 -d
docker-compose up
运行日志结果:
Creating docker-python-demo ... done
Attaching to docker-python-demo
docker-python-demo | Looking in indexes:
docker-python-demo | Collecting flask (from -r /docker/requirements.txt (line 1))
docker-python-demo | Downloading (91kB)
docker-python-demo | Collecting requests (from -r /docker/requirements.txt (line 2))
docker-python-demo | Downloading (88kB)
docker-python-demo | Collecting Werkzeug>=0.14 (from flask->-r /docker/requirements.txt (line 1))
docker-python-demo | Downloading (322kB)
docker-python-demo | Collecting click>=5.1 (from flask->-r /docker/requirements.txt (line 1))
docker-python-demo | Downloading (71kB)
docker-python-demo | Collecting itsdangerous>=0.24 (from flask->-r /docker/requirements.txt (line 1))
docker-python-demo | Downloading (46kB)
docker-python-demo | Collecting Jinja2>=2.10 (from flask->-r /docker/requirements.txt (line 1))
docker-python-demo | Downloading (126kB)
docker-python-demo | Collecting idna<2.7,>=2.5 (from requests->-r /docker/requirements.txt (line 2))
docker-python-demo | Downloading (56kB)
docker-python-demo | Collecting chardet<3.1.0,>=3.0.2 (from requests->-r /docker/requirements.txt (line 2))
docker-python-demo | Downloading (133kB)
docker-python-demo | Collecting urllib3<1.23,>=1.21.1 (from requests->-r /docker/requirements.txt (line 2))
docker-python-demo | Downloading (132kB)
docker-python-demo | Collecting certifi>=2017.4.17 (from requests->-r /docker/requirements.txt (line 2))
docker-python-demo | Downloading (150kB)
docker-python-demo | Collecting MarkupSafe>=0.23 (from Jinja2>=2.10->flask->-r /docker/requirements.txt (line 1))
docker-python-demo | Downloading
docker-python-demo | Building wheels for collected packages: itsdangerous, MarkupSafe
docker-python-demo | Running setup.py bdist_wheel for itsdangerous: started
docker-python-demo | Running setup.py bdist_wheel for itsdangerous: finished with status 'done'
docker-python-demo | Stored in directory: /root/.cache/pip/wheels/53/d7/48/a1f187b9001bf967a6e4eaf925b96b1a928b9136f0df691c6d
docker-python-demo | Running setup.py bdist_wheel for MarkupSafe: started
docker-python-demo | Running setup.py bdist_wheel for MarkupSafe: finished with status 'done'
docker-python-demo | Stored in directory: /root/.cache/pip/wheels/e8/91/a5/449fc7a22f10717491d290617cd827aaacb3b72555e7c394f8
docker-python-demo | Successfully built itsdangerous MarkupSafe
docker-python-demo | Installing collected packages: Werkzeug, click, itsdangerous, MarkupSafe, Jinja2, flask, idna, chardet, urllib3, certifi, requests
docker-python-demo | Successfully installed Jinja2-2.10 MarkupSafe-1.0 Werkzeug-0.14.1 certifi-2018.4.16 chardet-3.0.4 click-6.7 flask-1.0.2 idna-2.6 itsdangerous-0.24 requests-2.18.4 urllib3-1.22
docker-python-demo | * Serving Flask app "api" (lazy loading)
docker-python-demo | * Environment: production
docker-python-demo | WARNING: Do not use the development server in a production environment.
docker-python-demo | Use a production WSGI server instead.
docker-python-demo | * Debug mode: on
docker-python-demo | * Running on http://0.0.0.0:8880/ (Press CTRL+C to quit)
docker-python-demo | * Restarting with stat
docker-python-demo | * Debugger is active!
docker-python-demo | * Debugger PIN: 211-677-763
七、结果验证
在浏览器中访问:
返回结果:
Hello World! 2018
大功告成!!!