feat: 新增 python310-flask 构建示例(demo/python310-flask)
This commit is contained in:
@@ -0,0 +1,91 @@
|
||||
# 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
|
||||
```
|
||||
Reference in New Issue
Block a user