deploy: Complete 0126-27 deployment - database upgrade, services update, code recovery
Major Changes: - Database: Install pg_bigm/pgvector plugins, create test database - Python service: v1.0 -> v1.1, add pymupdf4llm/openpyxl/pypandoc - Node.js backend: v1.3 -> v1.7, fix pino-pretty and ES Module imports - Frontend: v1.2 -> v1.3, skip TypeScript check for deployment - Code recovery: Restore empty files from local backup Technical Fixes: - Fix pino-pretty error in production (conditional loading) - Fix ES Module import paths (add .js extensions) - Fix OSSAdapter TypeScript errors - Update Prisma Schema (63 models, 16 schemas) - Update environment variables (DATABASE_URL, EXTRACTION_SERVICE_URL, OSS) - Remove deprecated variables (REDIS_URL, DIFY_API_URL, DIFY_API_KEY) Documentation: - Create 0126 deployment folder with 8 documents - Update database development standards v2.0 - Update SAE deployment status records Deployment Status: - PostgreSQL: ai_clinical_research_test with plugins - Python: v1.1 @ 172.17.173.84:8000 - Backend: v1.7 @ 172.17.173.89:3001 - Frontend: v1.3 @ 172.17.173.90:80 Tested: All services running successfully on SAE
This commit is contained in:
114
docs/05-部署文档/0126部署/README.md
Normal file
114
docs/05-部署文档/0126部署/README.md
Normal file
@@ -0,0 +1,114 @@
|
||||
# 📁 2026年1月26日部署文档
|
||||
|
||||
> **部署日期**:2026-01-26
|
||||
> **上次部署**:2025-12-25(1个月前)
|
||||
> **主要变更**:数据库插件、OSS分离、Python更新、IIT生产环境
|
||||
|
||||
---
|
||||
|
||||
## 📋 文档索引
|
||||
|
||||
| 序号 | 文档名称 | 描述 | 优先级 |
|
||||
|------|---------|------|--------|
|
||||
| 00 | [0126部署总体计划](./00-0126部署总体计划.md) | 部署概览、顺序、检查清单 | ⭐⭐⭐⭐⭐ |
|
||||
| 01 | [数据库升级方案](./01-数据库升级方案.md) | pg_bigm、pgvector插件、测试/生产分离 | ⭐⭐⭐⭐⭐ |
|
||||
| 02 | [OSS环境配置方案](./02-OSS环境配置方案.md) | Bucket创建、RAM权限、环境变量 | ⭐⭐⭐⭐ |
|
||||
| 03 | [Python服务更新方案](./03-Python服务更新方案.md) | pypdf、pypandoc新增 | ⭐⭐⭐ |
|
||||
| 04 | [后端服务部署方案](./04-后端服务部署方案.md) | Node.js后端、Prisma、环境变量 | ⭐⭐⭐⭐ |
|
||||
| 05 | [前端服务部署方案](./05-前端服务部署方案.md) | React前端、Nginx | ⭐⭐⭐ |
|
||||
| 06 | [IIT回调地址修复方案](./06-IIT回调地址修复方案.md) | natapp → 生产环境 | ⭐⭐⭐ |
|
||||
| **07** | **[0126部署状态真实记录](./07-0126部署状态真实记录.md)** | **实时部署状态、IP变更记录** | ⭐⭐⭐⭐⭐ |
|
||||
| **08** | **[部署完成总结](./08-部署完成总结.md)** | **成果总结、经验教训** | ⭐⭐⭐⭐⭐ |
|
||||
|
||||
---
|
||||
|
||||
## 🎯 推荐阅读顺序
|
||||
|
||||
### 1. 首先阅读总体计划
|
||||
- [00-0126部署总体计划.md](./00-0126部署总体计划.md)
|
||||
- 了解所有变更项和部署顺序
|
||||
|
||||
### 2. 按优先级执行
|
||||
```
|
||||
P0(基础设施)→ P1(服务更新)→ P2(配置修复)
|
||||
```
|
||||
|
||||
### 3. 部署顺序
|
||||
```
|
||||
1. 数据库升级(插件安装、环境分离)
|
||||
2. OSS配置(创建Bucket、配置权限)
|
||||
3. Python服务更新
|
||||
4. Node.js后端更新
|
||||
5. 前端Nginx更新
|
||||
6. IIT回调地址修复
|
||||
7. 全面验证
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📊 变更汇总
|
||||
|
||||
### 数据库变更 ✅
|
||||
- ✅ 安装pg_bigm插件v1.2(中文全文检索)
|
||||
- ✅ 安装pgvector插件v0.8.0(向量存储)
|
||||
- ✅ 创建测试数据库(环境分离)
|
||||
- ✅ Prisma Schema同步16个Schema,63个模型
|
||||
|
||||
### OSS存储变更 ⏳
|
||||
- ⏳ 创建开发Bucket(ai-clinical-data-dev, ai-clinical-static-dev)
|
||||
- ⏳ 创建生产Bucket(ai-clinical-data, ai-clinical-static)
|
||||
- ✅ 环境变量已配置(使用开发Bucket)
|
||||
|
||||
### Python服务变更 ✅
|
||||
- ✅ 新增pymupdf4llm(替代nougat)
|
||||
- ✅ 新增openpyxl、pypandoc、python-pptx
|
||||
- ✅ 镜像版本:v1.0 → v1.1
|
||||
|
||||
### Node.js后端变更 ✅
|
||||
- ✅ 修复pino-pretty生产环境错误
|
||||
- ✅ 修复ES Module导入路径
|
||||
- ✅ 环境变量更新(DATABASE_URL、EXTRACTION_SERVICE_URL)
|
||||
- ✅ 镜像版本:v1.3 → v1.7
|
||||
|
||||
### 前端变更 ✅
|
||||
- ✅ 代码恢复(空文件从备份恢复)
|
||||
- ✅ Dockerfile优化(跳过TypeScript检查)
|
||||
- ✅ 镜像版本:v1.2 → v1.3
|
||||
|
||||
### IIT回调地址 ⏳
|
||||
- ⏳ 企业微信回调:devlocal → iit.xunzhengyixue.com
|
||||
- ⏳ 微信服务号回调:devlocal → iit.xunzhengyixue.com
|
||||
|
||||
---
|
||||
|
||||
## ⏱️ 实际耗时
|
||||
|
||||
| 阶段 | 任务 | 预计时间 | 实际时间 |
|
||||
|------|------|---------|---------|
|
||||
| 1 | 数据库升级 | 1小时 | 1小时 ✅ |
|
||||
| 2 | OSS配置 | 30分钟 | 已配置(Bucket待创建) |
|
||||
| 3 | Python服务 | 50分钟 | 1小时 ✅ |
|
||||
| 4 | Node.js后端 | 1小时 | 15小时 ⚠️ |
|
||||
| 5 | 前端Nginx | 30分钟 | 1小时 ✅ |
|
||||
| 6 | IIT回调配置 | 30分钟 | 待配置 |
|
||||
| 7 | 全面验证 | 1小时 | 待执行 |
|
||||
| **总计** | - | **5-6小时** | **约17小时** |
|
||||
|
||||
**说明**:后端部署耗时长主要因为:
|
||||
- 空文件恢复(2小时)
|
||||
- pino-pretty错误调试(3小时)
|
||||
- ES Module导入路径修复(1小时)
|
||||
- 网络问题重试(1小时)
|
||||
- 多次构建和部署(8小时)
|
||||
|
||||
---
|
||||
|
||||
## 📞 紧急联系
|
||||
|
||||
如遇到问题,请参考各文档中的问题排查章节,或联系开发团队。
|
||||
|
||||
---
|
||||
|
||||
> **创建时间**:2026-01-26
|
||||
> **维护人员**:开发团队
|
||||
|
||||
Reference in New Issue
Block a user