From 9c61205d5e25f6d35860b5b4ddbee0294c0e7790 Mon Sep 17 00:00:00 2001 From: Lxy Date: Sun, 17 May 2026 23:19:48 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20=E5=A2=9E=E5=8A=A0docker=E9=83=A8?= =?UTF-8?q?=E7=BD=B2=E5=8F=8A=E7=9B=B8=E5=85=B3=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .dockerignore | 17 ++++ DOCKER_DEPLOY.md | 224 +++++++++++++++++++++++++++++++++++++++++++++ Dockerfile | 28 ++++++ docker-compose.yml | 23 +++++ requirements.txt | 1 + 5 files changed, 293 insertions(+) create mode 100644 .dockerignore create mode 100644 DOCKER_DEPLOY.md create mode 100644 Dockerfile create mode 100644 docker-compose.yml diff --git a/.dockerignore b/.dockerignore new file mode 100644 index 0000000..df5bb9d --- /dev/null +++ b/.dockerignore @@ -0,0 +1,17 @@ +__pycache__/ +*.pyc +*.pyo +*.db +.git/ +.gitignore +*.md +.trae/ +.vscode/ +*.egg-info/ +dist/ +build/ +.eggs/ +*.egg +docker-compose.yml +Dockerfile +.dockerignore diff --git a/DOCKER_DEPLOY.md b/DOCKER_DEPLOY.md new file mode 100644 index 0000000..0e48975 --- /dev/null +++ b/DOCKER_DEPLOY.md @@ -0,0 +1,224 @@ +# 数据缓冲平台 Docker 部署文档 + +## 目录结构 + +``` +buffer_platform/ +├── app/ # 应用代码 +├── config/ # 配置文件 +├── data/ # 本地数据目录 +├── Dockerfile # Docker 镜像构建文件 +├── docker-compose.yml # Docker Compose 配置文件 +├── .dockerignore # Docker 构建忽略文件 +└── requirements.txt # Python 依赖 +``` + +## 环境要求 + +- Docker Desktop for Windows +- Docker Compose v3.8+ +- Windows 10/11 或 Windows Server + +## 快速部署 + +### 1. 构建并启动容器 + +```powershell +cd d:\alpha_workspace\buffer_platform +docker-compose up -d --build +``` + +### 2. 查看容器状态 + +```powershell +docker-compose ps +``` + +### 3. 查看日志 + +```powershell +# 查看实时日志 +docker-compose logs -f + +# 查看最近 100 行日志 +docker-compose logs --tail=100 +``` + +## 访问地址 + +| 服务 | 地址 | +|------|------| +| 前端页面 | http://localhost:9600/ui | +| API 文档 | http://localhost:9600/docs | +| 健康检查 | http://localhost:9600/api/v1/health | + +## 数据持久化 + +### 挂载路径 + +| 宿主机路径 | 容器路径 | 说明 | +|-----------|----------|------| +| `E:\docker_workspace\futures_datas` | `/app/data` | SQLite 数据库及缓存数据 | + +### 数据目录结构 + +容器启动后，`E:\docker_workspace\futures_datas` 目录将包含： + +``` +E:\docker_workspace\futures_datas\ +└── buffer.db # SQLite 数据库文件 +``` + +## 常用操作 + +### 停止服务 + +```powershell +docker-compose stop +``` + +### 启动服务 + +```powershell +docker-compose start +``` + +### 重启服务 + +```powershell +docker-compose restart +``` + +### 停止并删除容器 + +```powershell +docker-compose down +``` + +### 停止并删除容器及数据卷 + +> ⚠️ 警告：此操作将删除所有持久化数据！ + +```powershell +docker-compose down -v +``` + +### 重新构建并启动 + +```powershell +docker-compose up -d --build +``` + +### 更新镜像 + +```powershell +# 拉取最新代码后 +docker-compose down +docker-compose build --no-cache +docker-compose up -d +``` + +## 环境变量配置 + +可在 `docker-compose.yml` 中修改以下环境变量： + +| 变量名 | 默认值 | 说明 | +|--------|--------|------| +| `BUFFER_DB_PATH` | `/app/data/buffer.db` | 数据库文件路径 | +| `BUFFER_HOST` | `0.0.0.0` | 服务监听地址 | +| `BUFFER_PORT` | `8600` | 容器内服务端口 | +| `CACHE_TTL` | `300` | 缓存过期时间（秒） | +| `BUFFER_LOG_LEVEL` | `INFO` | 日志级别 | +| `MAX_WORKERS` | `2` | 并发采集数 | + +## 端口修改 + +如需修改宿主机绑定端口，编辑 `docker-compose.yml`： + +```yaml +ports: + - "9600:8600" # 修改 9600 为其他端口 +``` + +## 数据备份 + +### 备份数据库 + +```powershell +# 停止服务 +docker-compose stop + +# 复制数据文件 +xcopy E:\docker_workspace\futures_datas\buffer.db E:\backup\buffer_$(Get-Date -Format 'yyyyMMdd').db + +# 启动服务 +docker-compose start +``` + +### 恢复数据库 + +```powershell +# 停止服务 +docker-compose stop + +# 复制备份文件到数据目录 +copy E:\backup\buffer_20260517.db E:\docker_workspace\futures_datas\buffer.db + +# 启动服务 +docker-compose start +``` + +## 故障排查 + +### 容器无法启动 + +```powershell +# 查看详细日志 +docker-compose logs + +# 检查容器状态 +docker ps -a +``` + +### 数据库权限问题 + +确保 `E:\docker_workspace\futures_datas` 目录存在且有写入权限： + +```powershell +# 创建数据目录 +mkdir E:\docker_workspace\futures_datas +``` + +### 端口冲突 + +```powershell +# 检查端口占用 +netstat -ano | findstr "9600" +``` + +### 进入容器 + +```powershell +docker exec -it buffer-platform /bin/bash +``` + +## 健康检查 + +服务内置健康检查端点： + +```powershell +# PowerShell +Invoke-WebRequest -Uri http://localhost:9600/api/v1/health + +# 或使用 curl +curl http://localhost:9600/api/v1/health +``` + +正常响应： + +```json +{ + "status": "ok", + "service": "market-data-buffer" +} +``` diff --git a/Dockerfile b/Dockerfile new file mode 100644 index 0000000..b673678 --- /dev/null +++ b/Dockerfile @@ -0,0 +1,28 @@ +FROM python:3.11-slim + +WORKDIR /app + +ENV PYTHONDONTWRITEBYTECODE=1 +ENV PYTHONUNBUFFERED=1 +ENV BUFFER_DB_PATH=/app/data/buffer.db +ENV BUFFER_HOST=0.0.0.0 +ENV BUFFER_PORT=8600 + +RUN rm -f /etc/apt/sources.list.d/debian.sources && \ + echo "deb http://mirrors.aliyun.com/debian trixie main" > /etc/apt/sources.list && \ + echo "deb http://mirrors.aliyun.com/debian trixie-updates main" >> /etc/apt/sources.list && \ + echo "deb http://mirrors.aliyun.com/debian-security trixie-security main" >> /etc/apt/sources.list && \ + apt-get update && \ + apt-get install -y --no-install-recommends gcc && \ + rm -rf /var/lib/apt/lists/* + +COPY requirements.txt . +RUN pip install --no-cache-dir -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/ --trusted-host mirrors.aliyun.com + +COPY . . + +RUN mkdir -p /app/data + +EXPOSE 8600 + +CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8600"] diff --git a/docker-compose.yml b/docker-compose.yml new file mode 100644 index 0000000..e902d22 --- /dev/null +++ b/docker-compose.yml @@ -0,0 +1,23 @@ +version: '3.8' + +services: + buffer-platform: + build: . + container_name: buffer-platform + ports: + - "9600:8600" + volumes: + - E:\docker_workspace\futures_datas:/app/data + environment: + - BUFFER_DB_PATH=/app/data/buffer.db + - BUFFER_HOST=0.0.0.0 + - BUFFER_PORT=8600 + - CACHE_TTL=300 + - BUFFER_LOG_LEVEL=INFO + restart: unless-stopped + healthcheck: + test: ["CMD", "curl", "-f", "http://localhost:8600/api/v1/health"] + interval: 30s + timeout: 10s + retries: 3 + start_period: 40s diff --git a/requirements.txt b/requirements.txt index eb97b1a..9b1527d 100644 --- a/requirements.txt +++ b/requirements.txt @@ -9,3 +9,4 @@ pandas>=2.0.0 tenacity>=8.2.0 requests>=2.31.0 httpx>=0.27.0 +python-multipart>=0.0.9