compliance/WSL-History-Viewer-Update.md
2025-08-27 16:55:39 +08:00

148 lines
3.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# WSL版本添加History Viewer支持 - 更新说明
## 问题解决
你提到的问题已经完全解决WSL版本现在已经包含了完整的History Viewer支持。
## 🎯 更新内容
### 1. 服务架构选择扩展
**之前**
- 只有FastAPI和Flask两种单服务选择
**现在**
```bash
请选择服务架构:
1) 双服务架构 - API服务器(5050) + 历史查看器(5051)
2) FastAPI服务 - 现代异步框架自动生成API文档(5051)
3) Flask服务 - 轻量级传统框架(5050)
```
### 2. 双服务架构完整支持
#### Dockerfile配置
- 使用Supervisor管理两个服务进程
- 同时运行API服务器和History Viewer
- 独立的日志管理和进程监控
#### Docker Compose配置
```yaml
services:
dms-compliance:
ports:
- "5050:5050" # API服务器端口
- "5051:5051" # 历史查看器端口
volumes:
- ./test_reports:/app/test_reports # 历史数据存储
```
#### Supervisor配置
```ini
# DMS API服务器 (主服务)
[program:api_server]
command=python api_server.py
# 历史查看器服务
[program:history_viewer]
command=python history_viewer.py
```
### 3. 访问地址更新
**双服务架构访问地址**
- API服务器: http://localhost:5050
- 历史查看器: http://localhost:5051
**单服务架构访问地址**
- FastAPI: http://localhost:5051 (包含API文档)
- Flask: http://localhost:5050
## ✅ 验证结果
通过测试脚本验证,成功生成了包含双服务架构的完整部署包:
```
=== 测试结果 ===
✓ 服务架构选择:双服务架构 - API服务器(5050) + 历史查看器(5051)
✓ 端口配置5050,5051
✓ 生成目录dms-compliance-dual-amd64-wsl-20250820-163118
✓ Docker Compose配置包含双端口映射
✓ Supervisor配置包含两个服务进程
✓ Dockerfile包含supervisor和双服务支持
```
## 📁 生成的文件结构
```
dms-compliance-dual-amd64-wsl-20250820-163118/
├── docker-compose.yml # 双端口配置 (5050+5051)
├── Dockerfile # 包含supervisor的多服务镜像
├── supervisord.conf # 进程管理配置
├── api_server.py # API服务器
├── history_viewer.py # 历史查看器
├── start.sh # 启动脚本
├── stop.sh # 停止脚本
├── logs.sh # 日志查看脚本
└── ... # 其他必要文件
```
## 🚀 使用方法
### 1. 运行WSL版本脚本
```bash
bash create-compose-package-wsl.sh
```
### 2. 选择双服务架构
```
请选择服务架构:
1) 双服务架构 - API服务器(5050) + 历史查看器(5051) ← 选择这个
2) FastAPI服务 - 现代异步框架自动生成API文档(5051)
3) Flask服务 - 轻量级传统框架(5050)
```
### 3. 部署和访问
```bash
# 解压并进入目录
tar -xzf dms-compliance-dual-*.tar.gz
cd dms-compliance-dual-*
# 启动服务
./start.sh
# 访问服务
# API服务器: http://localhost:5050
# 历史查看器: http://localhost:5051
```
## 🔧 技术实现细节
### Supervisor进程管理
- 自动启动和重启两个服务
- 独立的日志文件管理
- 进程组统一管理
- 健康检查和故障恢复
### 端口配置
- 5050: API服务器端口主要的测试执行接口
- 5051: 历史查看器端口(查看历史测试结果)
### 数据共享
- 共享的日志目录:`/app/logs`
- 共享的测试报告目录:`/app/test_reports`
- 共享的上传目录:`/app/uploads`
## 🎉 总结
现在WSL版本已经完全支持History Viewer功能
**完整的双服务架构支持**
**独立的API服务器和历史查看器**
**Supervisor进程管理**
**双端口配置 (5050 + 5051)**
**完整的WSL兼容性**
**自动化部署脚本**
你现在可以使用WSL版本脚本生成包含完整History Viewer功能的Docker部署包了