Files
kenaito-lab/demo/python310-flask/README.md
T

92 lines
3.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# python310-flask 示例
演示如何用 `runtime-python310` 镜像构建并运行一个 Python 3.10 + Flask Web 应用:
| 阶段 | 镜像 | 说明 |
| --- |-----------------------------------------------------------------|-------------------------------------------------|
| 编译 + 运行 | `registry.cn-shanghai.aliyuncs.com/odboy/kenaito:runtime-python310` | 含 Python 3.10.0 与 pip 镜像源(见 `image/runtime-python310`) |
与 dotnet 示例不同,Python 是解释型语言,不需要单独的编译镜像:`pip install` 与直接运行都在同一个镜像内完成。
### 示例内容
```
demo/
├── app.py # Flask 应用:GET / 运行时信息,GET /health,GET /api/hello/<name>,GET /page 页面
├── templates/
│ └── index.html # /page 使用的 Jinja2 模板
├── requirements.txt # 依赖清单(Flask 3.0.3)
├── Dockerfile # 单阶段构建:runtime-python310
├── build.sh # 构建镜像(PUSH=1 时同时推送)
├── docker-compose.yml # 部署编排(端口 8083,固定 IP 172.30.0.20)
├── startup.sh # docker-compose up -d
└── shutdown.sh # docker-compose down
```
### 构建与部署
```shell
sh build.sh # docker build -t registry.cn-shanghai.aliyuncs.com/odboy/kenaito:demo-python310-flask .
PUSH=1 sh build.sh # 构建并推送
sh startup.sh # docker-compose -f docker-compose.yml -p python310-flask-demo up -d
```
访问:
```shell
curl http://127.0.0.1:8083/ # {"message":"python310-flask is running","python":"3.10.0",...}
curl http://127.0.0.1:8083/health # ok
curl http://127.0.0.1:8083/api/hello/demo # {"message":"Hello, demo!",...}
```
浏览器打开 http://127.0.0.1:8083/page 可看到渲染后的运行信息页面。
### 关键点
**依赖层缓存**:先只 `COPY requirements.txt` 执行 `pip install`,再 `COPY` 源码。只改 `app.py` 时不会重装依赖,重复构建更快。
基础镜像已预置 `~/.pip/pip.conf` 指向阿里云源,`pip install` 无需额外换源。
**监听地址**:容器内监听 `8083`(`APP_PORT`),避开 dotnet6/8/9 示例占用的 8080/8081/8082;宿主机映射与容器端口一致。
**时区**:代码内统一按 UTC+8 输出时间,即使容器 `TZ` 未生效也不会差 8 小时;compose 中用 `TZ` 再显式声明一次。
**日志**:`PYTHONUNBUFFERED=1` 关闭 stdout 缓冲,`docker logs` 能实时看到请求日志;Flask 日志本身输出到 stderr。
**入口**:`ENTRYPOINT ["python", "app.py"]`,exec 形式保证 `docker stop` 的 SIGTERM 能传到进程。
**健康检查**:运行镜像自带 `net-tools`,直接用 `netstat` 探测端口,不需要额外安装 curl。
### 运维命令
```shell
docker logs -f python310-flask-demo # 应用日志(stdout/stderr)
docker exec python310-flask-demo python -V # 确认 Python 版本
docker exec python310-flask-demo pip list # 确认依赖版本
```
### 调试时直接在运行镜像里运行
需要临时改代码看效果时,可以只挂载源码进运行镜像(不需要构建镜像):
```shell
docker run --rm -it -p 8083:8083 \
-v "$PWD":/home/admin -w /home/admin \
registry.cn-shanghai.aliyuncs.com/odboy/kenaito:runtime-python310 \
sh -c 'pip install -r requirements.txt && python app.py'
```
### 生产运行
示例用 `app.run()` 的内置服务器,便于直接 `python app.py` 演示。生产环境建议换成 WSGI 服务器,
例如在 `requirements.txt` 增加 `gunicorn==21.2.0`,入口改为:
```dockerfile
ENTRYPOINT ["gunicorn", "-w", "4", "-b", "0.0.0.0:8083", "app:app"]
```
### 停止
```shell
sh shutdown.sh
```