feat: 新增 python310-flask 构建示例(demo/python310-flask)
This commit is contained in:
@@ -0,0 +1,6 @@
|
|||||||
|
__pycache__/
|
||||||
|
*.pyc
|
||||||
|
.venv/
|
||||||
|
venv/
|
||||||
|
.git/
|
||||||
|
.DS_Store
|
||||||
@@ -0,0 +1,4 @@
|
|||||||
|
__pycache__/
|
||||||
|
*.pyc
|
||||||
|
.venv/
|
||||||
|
venv/
|
||||||
@@ -0,0 +1,18 @@
|
|||||||
|
# 单阶段:runtime-python310 已含 Python 3.10.0 + pip 镜像源(见 image/runtime-python310),编译与运行共用
|
||||||
|
FROM registry.cn-shanghai.aliyuncs.com/odboy/kenaito:runtime-python310
|
||||||
|
LABEL MAINTAINER="tianjun@odboy.cn"
|
||||||
|
ENV TimeZone=Asia/Shanghai
|
||||||
|
ENV PYTHONUNBUFFERED=1
|
||||||
|
ENV APP_PORT=8083
|
||||||
|
WORKDIR /home/admin
|
||||||
|
|
||||||
|
# 先只拷贝依赖清单,依赖不变时复用 pip 层缓存
|
||||||
|
COPY requirements.txt ./
|
||||||
|
RUN pip3 install --no-cache-dir -r requirements.txt
|
||||||
|
|
||||||
|
COPY app.py ./
|
||||||
|
COPY templates ./templates
|
||||||
|
|
||||||
|
EXPOSE 8083
|
||||||
|
# exec 形式,保证 docker stop 的 SIGTERM 能传到 python 进程
|
||||||
|
ENTRYPOINT ["python3", "app.py"]
|
||||||
@@ -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
|
||||||
|
```
|
||||||
@@ -0,0 +1,50 @@
|
|||||||
|
import os
|
||||||
|
import platform
|
||||||
|
import socket
|
||||||
|
from datetime import datetime, timedelta, timezone
|
||||||
|
|
||||||
|
import flask
|
||||||
|
|
||||||
|
app = flask.Flask(__name__)
|
||||||
|
# 国内时区 UTC+8,容器内 TZ 即使没生效也能输出正确时间
|
||||||
|
TZ8 = timezone(timedelta(hours=8))
|
||||||
|
START_TIME = datetime.now(TZ8)
|
||||||
|
|
||||||
|
|
||||||
|
def runtime_info():
|
||||||
|
return {
|
||||||
|
"message": "python310-flask is running",
|
||||||
|
"python": platform.python_version(),
|
||||||
|
"flask": flask.__version__,
|
||||||
|
"impl": platform.python_implementation(),
|
||||||
|
"os": platform.platform(),
|
||||||
|
"hostname": socket.gethostname(),
|
||||||
|
"time": datetime.now(TZ8).strftime("%Y-%m-%d %H:%M:%S %z"),
|
||||||
|
"uptime": str(datetime.now(TZ8) - START_TIME).split(".")[0],
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
@app.get("/")
|
||||||
|
def index():
|
||||||
|
return flask.jsonify(runtime_info())
|
||||||
|
|
||||||
|
|
||||||
|
@app.get("/health")
|
||||||
|
def health():
|
||||||
|
return "ok"
|
||||||
|
|
||||||
|
|
||||||
|
@app.get("/api/hello/<name>")
|
||||||
|
def hello(name):
|
||||||
|
return flask.jsonify({"message": f"Hello, {name}!", "time": datetime.now(TZ8).isoformat()})
|
||||||
|
|
||||||
|
|
||||||
|
@app.get("/page")
|
||||||
|
def page():
|
||||||
|
return flask.render_template("index.html", info=runtime_info())
|
||||||
|
|
||||||
|
|
||||||
|
if __name__ == "__main__":
|
||||||
|
# 容器内监听 8083,避免与 dotnet6/8/9 示例的 8080/8081/8082 冲突;可用环境变量 APP_PORT 覆盖
|
||||||
|
port = int(os.environ.get("APP_PORT", "8083"))
|
||||||
|
app.run(host="0.0.0.0", port=port)
|
||||||
Executable
+11
@@ -0,0 +1,11 @@
|
|||||||
|
#!/usr/bin/env bash
|
||||||
|
# 在示例目录下构建示例镜像
|
||||||
|
set -euo pipefail
|
||||||
|
cd "$(dirname "$0")"
|
||||||
|
|
||||||
|
IMAGE=${IMAGE:-registry.cn-shanghai.aliyuncs.com/odboy/kenaito:demo-python310-flask}
|
||||||
|
docker build -t "${IMAGE}" .
|
||||||
|
|
||||||
|
if [ "${PUSH:-0}" = "1" ]; then
|
||||||
|
docker push "${IMAGE}"
|
||||||
|
fi
|
||||||
@@ -0,0 +1,29 @@
|
|||||||
|
version: '3.8'
|
||||||
|
|
||||||
|
networks:
|
||||||
|
python310-flask-demo:
|
||||||
|
ipam:
|
||||||
|
driver: default
|
||||||
|
config:
|
||||||
|
- subnet: "172.30.0.0/24"
|
||||||
|
|
||||||
|
services:
|
||||||
|
demo:
|
||||||
|
image: registry.cn-shanghai.aliyuncs.com/odboy/kenaito:demo-python310-flask # 镜像由 build.sh 构建
|
||||||
|
container_name: python310-flask-demo
|
||||||
|
restart: unless-stopped
|
||||||
|
ports: # 映射端口
|
||||||
|
- "8083:8083"
|
||||||
|
environment: # 设置环境变量,相当于docker run命令中的-e
|
||||||
|
TZ: Asia/Shanghai
|
||||||
|
APP_PORT: "8083"
|
||||||
|
healthcheck:
|
||||||
|
# 运行镜像自带 net-tools,直接用端口探测,不额外安装 curl
|
||||||
|
test: ["CMD-SHELL", "netstat -tln | grep -q ':8083 '"]
|
||||||
|
interval: 30s
|
||||||
|
timeout: 5s
|
||||||
|
retries: 3
|
||||||
|
start_period: 5s
|
||||||
|
networks:
|
||||||
|
python310-flask-demo:
|
||||||
|
ipv4_address: 172.30.0.20
|
||||||
@@ -0,0 +1,2 @@
|
|||||||
|
Flask==3.0.3
|
||||||
|
Werkzeug==3.0.3
|
||||||
Executable
+4
@@ -0,0 +1,4 @@
|
|||||||
|
#!/usr/bin/env bash
|
||||||
|
set -euo pipefail
|
||||||
|
cd "$(dirname "$0")"
|
||||||
|
docker-compose -f docker-compose.yml -p python310-flask-demo down
|
||||||
Executable
+4
@@ -0,0 +1,4 @@
|
|||||||
|
#!/usr/bin/env bash
|
||||||
|
set -euo pipefail
|
||||||
|
cd "$(dirname "$0")"
|
||||||
|
docker-compose -f docker-compose.yml -p python310-flask-demo up -d
|
||||||
@@ -0,0 +1,28 @@
|
|||||||
|
<!DOCTYPE html>
|
||||||
|
<html lang="zh-CN">
|
||||||
|
<head>
|
||||||
|
<meta charset="utf-8">
|
||||||
|
<title>python310-flask</title>
|
||||||
|
<style>
|
||||||
|
body { font-family: -apple-system, "PingFang SC", "Microsoft YaHei", sans-serif; margin: 40px; color: #333; }
|
||||||
|
table { border-collapse: collapse; min-width: 520px; }
|
||||||
|
th, td { border: 1px solid #ddd; padding: 8px 12px; text-align: left; }
|
||||||
|
th { background: #f5f5f5; width: 160px; }
|
||||||
|
a { color: #1677ff; }
|
||||||
|
</style>
|
||||||
|
</head>
|
||||||
|
<body>
|
||||||
|
<h2>python310-flask 运行信息</h2>
|
||||||
|
<table>
|
||||||
|
{% for key, value in info.items() %}
|
||||||
|
<tr>
|
||||||
|
<th>{{ key }}</th>
|
||||||
|
<td>{{ value }}</td>
|
||||||
|
</tr>
|
||||||
|
{% endfor %}
|
||||||
|
</table>
|
||||||
|
<p>
|
||||||
|
其它接口:<a href="/api/hello/demo">/api/hello/<name></a>、<a href="/health">/health</a>
|
||||||
|
</p>
|
||||||
|
</body>
|
||||||
|
</html>
|
||||||
Reference in New Issue
Block a user