初始化

2026-04-02 23:40:04 +08:00
commit 381ea7085d
107 changed files with 11858 additions and 0 deletions
@@ -0,0 +1,55 @@
+# 部署规则
+
+## Docker 部署
+
+- 使用 Docker Compose 编排
+- 外部 PostgreSQL 和 Redis（不在容器内）
+- 日志挂载到宿主机
+- 使用 Nginx 反向代理
+
+**服务列表**：
+- backend: FastAPI 应用
+- celery-worker: Celery 工作进程
+- celery-beat: Celery 定时任务
+- frontend: Vue 静态文件（Nginx）
+- nginx: 反向代理
+
+## 环境变量
+
+**后端必需配置**：
+```bash
+DATABASE_URL          # PostgreSQL 连接
+REDIS_URL            # Redis 连接
+CASDOOR_*            # Casdoor 认证配置
+SECRET_KEY           # 应用密钥
+SSH_TIMEOUT=30       # SSH 超时时间
+```
+
+**前端必需配置**：
+```bash
+VITE_API_BASE_URL    # 后端 API 地址
+VITE_CASDOOR_*       # Casdoor 前端配置
+```
+
+## 监控告警
+
+- 健康检查端点：`GET /health`
+- 性能指标端点：`GET /metrics`
+- 日志级别：生产环境使用 INFO
+- 日志轮转：10MB 每个文件，保留30天
+
+## 部署流程
+
+1. 配置环境变量（`.env` 文件）
+2. 构建镜像：`docker-compose build`
+3. 启动服务：`docker-compose up -d`
+4. 运行数据库迁移：`docker-compose exec backend alembic upgrade head`
+5. 检查服务状态：`docker-compose ps`
+6. 查看日志：`docker-compose logs -f`
+
+## 备份策略
+
+- 数据库每日自动备份
+- 备份保留30天
+- 重要操作前手动备份
+- 定期测试恢复流程