7.3 KiB
7.3 KiB
Hexo Container v0.0.3 测试脚本使用说明 (含日志轮转功能)
本指南详细说明了如何使用针对 Hexo Container v0.0.3 (已验证稳定版) 的 PowerShell 测试脚本套件。
v0.0.3 版本核心特性与测试说明
🚀 日志轮转功能 (Log Rotation)
v0.0.3 版本新增了自动日志轮转功能，包括：
- 智能大小检测 - 当
deployment.log文件达到 1MB 时自动轮转 - 自动备份 - 保留最近 5 个轮转文件 (例如
deployment.log.1.gz,deployment.log.2.gz等) - 压缩存储 - 自动压缩旧日志文件 (如
.gz格式) 节省空间 - 权限管理 - 确保 hexo 用户可正常写入日志及轮转操作
- 测试优化 - 相关测试脚本经过优化，可快速验证此功能
📊 测试脚本优化成果 (针对 v0.0.3 测试流程)
- 成功率提升 - 测试脚本的整体执行成功率得到提升
- 测试速度 - 日志轮转等测试的验证速度加快
- 阈值优化 - 日志轮转阈值在测试中调整为 1MB，以加速验证过程
- 快速验证 -
log_rotation_test.ps1脚本提供快速测试模式，生成少量日志即可验证核心轮转机制
路径修正说明
本次更新修正了 test/v0.0.3/windows 目录下所有测试脚本的路径问题，确保脚本能够：
- 正确调用对应文件 - 无论从哪个目录执行脚本
- 正确生成文件 - 所有生成的文件都保存在测试目录及其子目录中
- 使用相对路径 - 提高脚本的可移植性
修正的关键问题
1. 脚本工作目录统一
- 所有脚本现在都会自动切换到脚本所在目录作为工作目录
- 使用
$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path获取脚本目录 - 使用
Set-Location $ScriptDir设置工作目录
2. PowerShell param 块位置修正
- 将
param()块移动到脚本最开始 - 确保脚本可以正确接收参数
3. 路径引用修正
- Dockerfile 路径:
../../../Dockerfile_v0.0.3(相对于测试脚本目录) - 日志目录:
./logs(在测试脚本目录下) - 测试数据:
./test_data(在测试脚本目录下) - SSH 密钥:
./test_data/ssh_keys/test_key
4. Docker 卷挂载路径修正
- 使用
$ScriptDir构建绝对路径进行卷挂载 - 确保容器能正确访问主机文件
文件结构
test/v0.0.3/windows/
├── build_test.ps1 # 构建测试脚本
├── run_test.ps1 # 运行测试脚本
├── functional_test.ps1 # 功能测试脚本
├── log_rotation_test.ps1 # 🆕 日志轮转测试脚本 (v0.0.3核心新功能)
├── test_log_size_reset.ps1 # 🆕 日志大小重置专项测试脚本 (容器重启修复验证)
├── cleanup_test.ps1 # 清理测试脚本
├── start.ps1 # 一键测试套件
├── test_paths.ps1 # 路径验证脚本
├── logs/ # 测试日志目录 (自动创建)
└── test_data/ # 测试数据目录 (自动创建)
├── hexo_site/ # 测试站点文件
└── ssh_keys/ # SSH 密钥文件
🆕 日志轮转测试详解
log_rotation_test.ps1 参数
-FastRotationTest: 快速轮转测试 (3批次×50条日志，约3KB)-QuickLogGen: 快速日志生成 (5批次×100条日志，约100KB)-LogSizeThresholdMB: 日志大小阈值(MB) (默认: 1)-ContainerName: 容器名称 (默认: hexo-test-v003)
test_log_size_reset.ps1 参数 (🆕 容器重启修复验证)
-ContainerName: 容器名称 (默认: hexo-test-v003)-SshPort: SSH端口 (默认: 2222)-TargetSizeKB: 目标日志大小(KB) (默认: 25KB，超过20KB阈值)-Verbose: 详细输出模式
此脚本专门验证容器重启时的日志监控修复功能，确保：
- 容器重启后不会重复输出旧的Git部署信息
- 日志位置跟踪文件正确工作
- 部署日志监控在重启后正常恢复
测试模式说明
- FastRotationTest - 验证轮转机制，生成少量日志快速验证
- QuickLogGen - 测试日志写入和权限，生成中等量日志
- 默认模式 - 完整测试，生成足够日志触发实际轮转
使用示例
# 快速验证日志轮转机制 (推荐，仅需2分钟)
.\log_rotation_test.ps1 -FastRotationTest
# 测试日志写入功能
.\log_rotation_test.ps1 -QuickLogGen
# 完整日志轮转测试
.\log_rotation_test.ps1
# 自定义日志大小阈值
.\log_rotation_test.ps1 -LogSizeThresholdMB 2
# 🆕 容器重启修复验证测试
.\test_log_size_reset.ps1
# 详细模式运行重启修复测试
.\test_log_size_reset.ps1 -Verbose
# 自定义目标大小测试
.\test_log_size_reset.ps1 -TargetSizeKB 30
测试报告
每次测试都会生成详细报告：
- 执行日志:
./logs/log_rotation_test_YYYYMMDD_HHMMSS.log - 测试报告:
./logs/log_rotation_test_report_YYYYMMDD_HHMMSS.txt
使用方式
方式1: 从测试目录运行 (推荐)
cd "c:\Users\Unbal\Desktop\dockerfiledir\test\v0.0.3\windows"
.\start.ps1
方式2: 从任意目录运行
& "c:\Users\Unbal\Desktop\dockerfiledir\test\v0.0.3\windows\start.ps1"
方式3: 单独运行各个测试
cd "c:\Users\Unbal\Desktop\dockerfiledir\test\v0.0.3\windows"
.\build_test.ps1 # 构建镜像
.\run_test.ps1 # 启动容器
.\functional_test.ps1 # 功能测试
.\log_rotation_test.ps1 # 日志轮转测试
.\cleanup_test.ps1 # 清理环境
测试参数
start.ps1 参数
-SkipBuild: 跳过构建阶段-SkipFunctional: 跳过功能测试-SkipLogRotation: 跳过日志轮转测试-CleanupAfter: 测试后自动清理-Tag: 镜像标签 (默认: hexo-test:v0.0.3)-ContainerName: 容器名称 (默认: hexo-test-v003)-HttpPort: HTTP端口 (默认: 8080)-SshPort: SSH端口 (默认: 2222)
使用示例
# 完整测试 (包含构建和清理)
.\start.ps1 -CleanupAfter
# 跳过构建，只测试功能
.\start.ps1 -SkipBuild
# 自定义端口
.\start.ps1 -HttpPort 9999 -SshPort 3333
验证路径配置
运行路径验证脚本检查配置：
.\test_paths.ps1
此脚本会检查所有关键路径是否正确，并自动创建必需的目录。
注意事项
- 权限要求: 需要管理员权限运行 Docker 命令
- 端口冲突: 确保指定的端口 (如 8080, 2222) 未被占用
- SSH 密钥: 测试脚本 (
run_test.ps1) 会优先尝试从用户~/.ssh/目录或测试子目录test_data/ssh_keys/中使用现有的test_key(或id_rsa)。如果找不到这些密钥，脚本会自动生成新的密钥对用于测试，并存放于test_data/ssh_keys/。 - Docker 环境: 确保 Docker Desktop 正在运行
- 日志清理:
cleanup_test.ps1或start.ps1 -CleanupAfter会清理测试容器和镜像。测试脚本自身产生的日志默认保留在logs目录下。
故障排除
权限错误
# 以管理员身份运行 PowerShell
Start-Process powershell -Verb RunAs
路径不存在错误
# 运行路径验证
.\test_paths.ps1
Docker 连接错误
# 检查 Docker 状态
docker version
端口占用错误
# 查看端口占用
netstat -ano | findstr :8080