docs: 添加v2.2.0快速部署指南和部署就绪报告
This commit is contained in:
Jowe
117
DEPLOY_READY_v2.2.txt
Normal file
117
DEPLOY_READY_v2.2.txt
Normal file
@@ -0,0 +1,117 @@
|
||||
================================================================================
|
||||
ZJPB v2.2.0 生产环境部署包 - 准备完成
|
||||
================================================================================
|
||||
|
||||
版本信息
|
||||
--------
|
||||
版本号: v2.2.0
|
||||
发布日期: 2025-12-30
|
||||
补丁大小: 56KB
|
||||
预计部署时间: 10分钟
|
||||
|
||||
核心功能
|
||||
--------
|
||||
✅ 博查Web Search API集成
|
||||
✅ 智能新闻更新机制（每日首次访问触发）
|
||||
✅ 每个网站获取3条一周内新闻
|
||||
✅ 新闻来源展示（名称+图标）
|
||||
✅ 自动去重防止重复
|
||||
✅ News表扩展（source_name, source_icon）
|
||||
✅ 界面优化（新闻左侧，推荐右侧）
|
||||
|
||||
需要上传到服务器的文件（仅2个）
|
||||
--------------------------------
|
||||
📦 v2.2.0.patch (56KB)
|
||||
📦 git_patch_deploy_v2.2.sh (2.6KB)
|
||||
|
||||
上传路径
|
||||
--------
|
||||
/opt/1panel/apps/zjpb/
|
||||
|
||||
部署文档（本地参考）
|
||||
--------------------
|
||||
📄 DEPLOY_v2.2_QUICK.md - 快速部署指南（推荐先看这个）
|
||||
📄 DEPLOY_v2.2.0.md - 完整部署文档
|
||||
📄 DEPLOY_v2.2_CHECKLIST.md - 部署检查清单
|
||||
|
||||
快速部署命令（3步）
|
||||
--------------------
|
||||
|
||||
第1步：上传文件
|
||||
使用1Panel文件管理器或SCP命令上传以下文件到服务器：
|
||||
v2.2.0.patch
|
||||
git_patch_deploy_v2.2.sh
|
||||
|
||||
第2步：执行部署
|
||||
SSH登录服务器或使用1Panel终端：
|
||||
cd /opt/1panel/apps/zjpb
|
||||
chmod +x git_patch_deploy_v2.2.sh
|
||||
./git_patch_deploy_v2.2.sh
|
||||
|
||||
第3步：配置API Key
|
||||
编辑.env文件：
|
||||
nano /opt/1panel/apps/zjpb/.env
|
||||
|
||||
添加以下配置：
|
||||
BOCHA_API_KEY=sk-76d0236a50d445ae92e75b634ed5313c
|
||||
BOCHA_BASE_URL=https://api.bocha.cn
|
||||
|
||||
重启应用：
|
||||
./manage.sh restart
|
||||
|
||||
部署验证
|
||||
--------
|
||||
✓ 访问任意网站详情页，检查"相关新闻"模块
|
||||
✓ 登录后台 /admin/newsadmin/ 查看新闻管理
|
||||
✓ 运行测试脚本：python test_news_feature.py
|
||||
|
||||
Git提交历史（v2.2.0）
|
||||
----------------------
|
||||
2e9f634 docs: 添加v2.2.0部署文档和脚本
|
||||
495248b feat: v2.2.0 智能新闻更新和布局优化
|
||||
d7d21e1 release: v2.2.0 - 博查新闻搜索功能
|
||||
|
||||
技术支持
|
||||
--------
|
||||
如遇问题，请查看：
|
||||
1. 应用日志: ./manage.sh logs
|
||||
2. 完整文档: DEPLOY_v2.2.0.md
|
||||
3. 测试脚本: python test_news_feature.py
|
||||
|
||||
回滚方案
|
||||
--------
|
||||
如需回滚到v2.1.0：
|
||||
cd /opt/1panel/apps/zjpb
|
||||
./manage.sh stop
|
||||
git reset --hard HEAD~3
|
||||
./manage.sh start
|
||||
|
||||
重要提示
|
||||
--------
|
||||
⚠️ 部署前请先备份生产数据库
|
||||
⚠️ 确认服务器可以访问 api.bocha.cn
|
||||
⚠️ 确认BOCHA_API_KEY已配置且有余额
|
||||
|
||||
成本估算
|
||||
--------
|
||||
假设每天100个网站被访问：
|
||||
- 每天成本约 1元
|
||||
- 每月成本约 30元
|
||||
|
||||
================================================================================
|
||||
✅ 所有部署文件已准备就绪，可以开始部署！
|
||||
================================================================================
|
||||
|
||||
下一步操作：
|
||||
1. 使用1Panel文件管理器或SCP上传2个文件到服务器
|
||||
2. SSH登录服务器执行部署脚本
|
||||
3. 配置.env中的BOCHA_API_KEY
|
||||
4. 重启应用并验证功能
|
||||
|
||||
部署支持文档位置：
|
||||
D:\315mac\Code\zjpb\DEPLOY_v2.2_QUICK.md
|
||||
D:\315mac\Code\zjpb\DEPLOY_v2.2.0.md
|
||||
D:\315mac\Code\zjpb\DEPLOY_v2.2_CHECKLIST.md
|
||||
|
||||
祝部署顺利！
|
||||
================================================================================
|
||||
201
DEPLOY_v2.2_QUICK.md
Normal file
201
DEPLOY_v2.2_QUICK.md
Normal file
@@ -0,0 +1,201 @@
|
||||
# ZJPB v2.2.0 部署操作指南
|
||||
|
||||
## 版本信息
|
||||
- **版本**: v2.2.0
|
||||
- **发布日期**: 2025-12-30
|
||||
- **补丁大小**: 56KB
|
||||
- **部署时间**: 约10分钟
|
||||
|
||||
---
|
||||
|
||||
## 核心功能
|
||||
|
||||
### 博查新闻搜索集成
|
||||
✅ 自动获取网站相关新闻（博查Web Search API）
|
||||
✅ 智能更新：每日首次访问触发更新
|
||||
✅ 每个网站获取3条一周内新闻
|
||||
✅ 新闻来源展示（名称+图标）
|
||||
✅ 自动去重防止重复
|
||||
|
||||
### 数据库扩展
|
||||
✅ News表新增 `source_name` 字段
|
||||
✅ News表新增 `source_icon` 字段
|
||||
|
||||
### 界面优化
|
||||
✅ 新闻模块在左侧主栏
|
||||
✅ 相似推荐在右侧边栏
|
||||
|
||||
---
|
||||
|
||||
## 快速部署（3步）
|
||||
|
||||
### 第1步：上传文件到服务器
|
||||
上传以下2个文件到 `/opt/1panel/apps/zjpb/`：
|
||||
```
|
||||
v2.2.0.patch
|
||||
git_patch_deploy_v2.2.sh
|
||||
```
|
||||
|
||||
### 第2步：执行部署脚本
|
||||
```bash
|
||||
cd /opt/1panel/apps/zjpb
|
||||
chmod +x git_patch_deploy_v2.2.sh
|
||||
./git_patch_deploy_v2.2.sh
|
||||
```
|
||||
|
||||
### 第3步：配置API Key
|
||||
编辑 `.env` 文件，添加：
|
||||
```bash
|
||||
BOCHA_API_KEY=sk-76d0236a50d445ae92e75b634ed5313c
|
||||
BOCHA_BASE_URL=https://api.bocha.cn
|
||||
```
|
||||
|
||||
然后重启：
|
||||
```bash
|
||||
./manage.sh restart
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 验证部署
|
||||
|
||||
### ✓ 前台测试
|
||||
1. 访问任意网站详情页
|
||||
2. 检查"相关新闻"模块是否显示
|
||||
3. 新闻应该显示来源网站名称和图标
|
||||
4. 点击新闻标题可跳转到原文
|
||||
|
||||
### ✓ 后台测试
|
||||
1. 登录 `/admin/login`
|
||||
2. 进入"新闻管理" `/admin/newsadmin/`
|
||||
3. 查看新闻列表是否正常显示
|
||||
|
||||
### ✓ 功能测试
|
||||
```bash
|
||||
cd /opt/1panel/apps/zjpb
|
||||
source venv/bin/activate
|
||||
python test_news_feature.py
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 关键文件
|
||||
|
||||
### 本地准备好的文件
|
||||
```
|
||||
D:\315mac\Code\zjpb\
|
||||
├── v2.2.0.patch (56KB) 补丁文件
|
||||
├── git_patch_deploy_v2.2.sh 部署脚本
|
||||
├── DEPLOY_v2.2.0.md 完整部署文档
|
||||
├── DEPLOY_v2.2_CHECKLIST.md 检查清单
|
||||
├── migrate_news_fields.py 数据库迁移脚本
|
||||
├── test_news_feature.py 测试脚本
|
||||
└── fetch_news_cron.py 定期任务脚本
|
||||
```
|
||||
|
||||
### 服务器需要的文件（只需2个）
|
||||
```
|
||||
v2.2.0.patch
|
||||
git_patch_deploy_v2.2.sh
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Git提交历史
|
||||
|
||||
v2.2.0包含以下3个提交：
|
||||
```
|
||||
2e9f634 docs: 添加v2.2.0部署文档和脚本
|
||||
495248b feat: v2.2.0 智能新闻更新和布局优化
|
||||
d7d21e1 release: v2.2.0 - 博查新闻搜索功能
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 部署脚本自动完成的操作
|
||||
|
||||
```
|
||||
1. 停止应用
|
||||
2. 检查Git状态
|
||||
3. 备份未提交的修改
|
||||
4. 应用v2.2.0补丁
|
||||
- utils/news_searcher.py (新增)
|
||||
- app.py (更新)
|
||||
- models.py (更新)
|
||||
- config.py (更新)
|
||||
- templates/detail_new.html (更新)
|
||||
- migrate_news_fields.py (新增)
|
||||
- test_news_feature.py (新增)
|
||||
- fetch_news_cron.py (新增)
|
||||
- NEWS_FEATURE_v2.2.md (新增)
|
||||
5. 提交到Git
|
||||
6. 激活虚拟环境
|
||||
7. 安装依赖
|
||||
8. 运行数据库迁移
|
||||
9. 重启应用
|
||||
10. 检查状态
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 回滚方案（如需要）
|
||||
|
||||
```bash
|
||||
cd /opt/1panel/apps/zjpb
|
||||
./manage.sh stop
|
||||
git reset --hard HEAD~3 # 回滚到v2.1.0
|
||||
./manage.sh start
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 常见问题
|
||||
|
||||
### Q1: 新闻不显示？
|
||||
**A**: 检查 `.env` 中 `BOCHA_API_KEY` 是否配置正确
|
||||
|
||||
### Q2: 补丁应用失败？
|
||||
**A**: 备份本地修改后重试
|
||||
```bash
|
||||
git stash
|
||||
git apply v2.2.0.patch
|
||||
```
|
||||
|
||||
### Q3: 数据库迁移失败？
|
||||
**A**: 手动运行迁移脚本
|
||||
```bash
|
||||
python migrate_news_fields.py
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 成本估算
|
||||
|
||||
假设每天100个网站被访问：
|
||||
- 每次API调用约 0.01元
|
||||
- 每天成本约 1元
|
||||
- 每月成本约 30元
|
||||
|
||||
---
|
||||
|
||||
## 下一步
|
||||
|
||||
部署完成后：
|
||||
1. 访问网站测试功能
|
||||
2. 查看应用日志确认无错误
|
||||
3. 监控API调用情况
|
||||
4. 根据需要调整新闻获取数量和时间范围
|
||||
|
||||
---
|
||||
|
||||
## 技术支持文档
|
||||
|
||||
- **完整文档**: `DEPLOY_v2.2.0.md`
|
||||
- **检查清单**: `DEPLOY_v2.2_CHECKLIST.md`
|
||||
- **功能文档**: `NEWS_FEATURE_v2.2.md`
|
||||
|
||||
---
|
||||
|
||||
**创建时间**: 2025-12-30 22:32
|
||||
**准备就绪**: ✅
|
||||
**可以开始部署**: ✅
|
||||
Reference in New Issue
Block a user