v0.0.3 published
This commit is contained in:
318
test/v0.0.3/linux/README.md
Normal file
318
test/v0.0.3/linux/README.md
Normal file
@@ -0,0 +1,318 @@
|
||||
# Hexo Container v0.0.3 测试脚本使用说明 (Linux)
|
||||
|
||||
## 路径修正说明
|
||||
|
||||
本次更新修正了 `test/v0.0.3/linux` 目录下所有测试脚本的路径问题，确保脚本能够：
|
||||
|
||||
1. **正确调用对应文件** - 无论从哪个目录执行脚本
|
||||
2. **正确生成文件** - 所有生成的文件都保存在测试目录及其子目录中
|
||||
3. **使用相对路径** - 提高脚本的可移植性
|
||||
|
||||
## 修正的关键问题
|
||||
|
||||
### 1. 脚本工作目录统一
|
||||
- 所有脚本现在都会自动切换到脚本所在目录作为工作目录
|
||||
- 使用 `SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"` 获取脚本目录
|
||||
- 使用 `cd "$SCRIPT_DIR"` 设置工作目录
|
||||
|
||||
### 2. 路径引用修正
|
||||
- **Dockerfile 路径**: `../../../Dockerfile_v0.0.3` (相对于测试脚本目录)
|
||||
- **日志目录**: `$SCRIPT_DIR/logs` (在测试脚本目录下)
|
||||
- **测试数据**: `$SCRIPT_DIR/test_data` (在测试脚本目录下)
|
||||
- **SSH 密钥**: `$SCRIPT_DIR/test_data/ssh_keys/test_key`
|
||||
|
||||
### 3. Docker 卷挂载路径修正
|
||||
- 使用 `$SCRIPT_DIR` 构建绝对路径进行卷挂载
|
||||
- 确保容器能正确访问主机文件
|
||||
|
||||
### 4. 端口配置更新
|
||||
- 默认 HTTP 端口从 8888 更新为 8080
|
||||
- 避免与常见服务的端口冲突
|
||||
|
||||
## 文件结构
|
||||
|
||||
```
|
||||
test/v0.0.3/linux/
|
||||
├── build_test.sh # 构建测试脚本
|
||||
├── run_test.sh # 运行测试脚本
|
||||
├── functional_test.sh # 功能测试脚本
|
||||
├── log_rotation_test.sh # 日志轮转测试脚本 (v0.0.3新功能)
|
||||
├── test_log_size_reset.sh # 🆕 日志大小重置专项测试脚本 (容器重启修复验证)
|
||||
├── cleanup_test.sh # 清理测试脚本
|
||||
├── start.sh # 一键测试套件
|
||||
├── test_paths.sh # 路径验证脚本 (新增)
|
||||
├── README.md # 使用说明文档 (新增)
|
||||
├── logs/ # 测试日志目录 (自动创建)
|
||||
└── test_data/ # 测试数据目录 (自动创建)
|
||||
├── hexo_site/ # 测试站点文件
|
||||
└── ssh_keys/ # SSH 密钥文件
|
||||
```
|
||||
|
||||
## 使用方式
|
||||
|
||||
### 方式1: 从测试目录运行 (推荐)
|
||||
```bash
|
||||
cd "/path/to/dockerfiledir/test/v0.0.3/linux"
|
||||
./start.sh
|
||||
```
|
||||
|
||||
### 方式2: 从任意目录运行
|
||||
```bash
|
||||
/path/to/dockerfiledir/test/v0.0.3/linux/start.sh
|
||||
```
|
||||
|
||||
### 方式3: 单独运行各个测试
|
||||
```bash
|
||||
cd "/path/to/dockerfiledir/test/v0.0.3/linux"
|
||||
./build_test.sh # 构建镜像
|
||||
./run_test.sh # 启动容器
|
||||
./functional_test.sh # 功能测试
|
||||
./log_rotation_test.sh # 日志轮转测试
|
||||
./test_log_size_reset.sh # 🆕 日志大小重置测试 (容器重启修复验证)
|
||||
./cleanup_test.sh # 清理环境
|
||||
```
|
||||
|
||||
## 测试参数
|
||||
|
||||
### start.sh 参数
|
||||
- `--clean-start`: 清理后重新开始测试
|
||||
- `--help`: 显示帮助信息
|
||||
|
||||
### 各脚本参数
|
||||
|
||||
#### build_test.sh
|
||||
```bash
|
||||
./build_test.sh [TAG] [PLATFORM]
|
||||
# TAG: 镜像标签 (默认: hexo-test:v0.0.3)
|
||||
# PLATFORM: 平台架构 (默认: linux/amd64)
|
||||
```
|
||||
|
||||
#### run_test.sh
|
||||
```bash
|
||||
./run_test.sh [TAG] [CONTAINER_NAME] [HTTP_PORT] [SSH_PORT] [PUID] [PGID] [TIMEZONE]
|
||||
# TAG: 镜像标签 (默认: hexo-test:v0.0.3)
|
||||
# CONTAINER_NAME: 容器名称 (默认: hexo-test-v003)
|
||||
# HTTP_PORT: HTTP端口 (默认: 8080)
|
||||
# SSH_PORT: SSH端口 (默认: 2222)
|
||||
# PUID: 用户ID (默认: 1000)
|
||||
# PGID: 组ID (默认: 1000)
|
||||
# TIMEZONE: 时区 (默认: Asia/Shanghai)
|
||||
```
|
||||
|
||||
#### functional_test.sh
|
||||
```bash
|
||||
./functional_test.sh [CONTAINER_NAME] [HTTP_PORT] [SSH_PORT]
|
||||
# CONTAINER_NAME: 容器名称 (默认: hexo-test-v003)
|
||||
# HTTP_PORT: HTTP端口 (默认: 8080)
|
||||
# SSH_PORT: SSH端口 (默认: 2222)
|
||||
```
|
||||
|
||||
#### log_rotation_test.sh
|
||||
```bash
|
||||
./log_rotation_test.sh [CONTAINER_NAME] [HTTP_PORT] [SSH_PORT] [OPTIONS]
|
||||
# CONTAINER_NAME: 容器名称 (默认: hexo-test-v003)
|
||||
# HTTP_PORT: HTTP端口 (默认: 8080)
|
||||
# SSH_PORT: SSH端口 (默认: 2222)
|
||||
# OPTIONS: --fast-test, --quick-gen, --log-threshold-mb N
|
||||
```
|
||||
|
||||
#### test_log_size_reset.sh (🆕 容器重启修复验证)
|
||||
```bash
|
||||
./test_log_size_reset.sh [OPTIONS]
|
||||
# --container-name NAME 容器名称 (默认: hexo-test-v003)
|
||||
# --ssh-port PORT SSH端口 (默认: 2222)
|
||||
# --target-size-kb SIZE 目标日志大小KB (默认: 25)
|
||||
# --verbose 详细输出模式
|
||||
# --help 显示帮助信息
|
||||
```
|
||||
|
||||
此脚本专门验证容器重启时的日志监控修复功能，确保：
|
||||
- 容器重启后不会重复输出旧的Git部署信息
|
||||
- 日志位置跟踪文件正确工作
|
||||
- 部署日志监控在重启后正常恢复
|
||||
|
||||
#### cleanup_test.sh
|
||||
```bash
|
||||
./cleanup_test.sh [CONTAINER_NAME] [IMAGE_TAG] [OPTIONS]
|
||||
# CONTAINER_NAME: 容器名称 (默认: hexo-test-v003)
|
||||
# IMAGE_TAG: 镜像标签 (默认: hexo-test:v0.0.3)
|
||||
# OPTIONS: --remove-image, --remove-test-data, --remove-logs
|
||||
```
|
||||
|
||||
### 使用示例
|
||||
```bash
|
||||
# 完整测试 (清理模式)
|
||||
./start.sh --clean-start
|
||||
|
||||
# 自定义端口运行
|
||||
./run_test.sh "hexo-test:v0.0.3" "my-hexo-test" 9999 3333
|
||||
|
||||
# 🆕 容器重启修复验证测试
|
||||
./test_log_size_reset.sh
|
||||
|
||||
# 详细模式运行重启修复测试
|
||||
./test_log_size_reset.sh --verbose
|
||||
|
||||
# 自定义目标大小测试
|
||||
./test_log_size_reset.sh --target-size-kb 30
|
||||
|
||||
# 日志轮转快速测试
|
||||
./log_rotation_test.sh --fast-test
|
||||
|
||||
# 彻底清理环境
|
||||
./cleanup_test.sh --remove-image --remove-test-data --remove-logs
|
||||
```
|
||||
|
||||
## 验证路径配置
|
||||
|
||||
运行路径验证脚本检查配置：
|
||||
```bash
|
||||
./test_paths.sh
|
||||
```
|
||||
|
||||
此脚本会检查所有关键路径是否正确，并自动创建必需的目录。
|
||||
|
||||
## 系统要求
|
||||
|
||||
### 基本要求
|
||||
- **操作系统**: Linux (Ubuntu 18.04+, Debian 10+, CentOS 7+)
|
||||
- **Docker**: Docker Engine 20.10+
|
||||
- **Shell**: Bash 4.0+
|
||||
- **内存**: 至少 2GB 可用内存
|
||||
- **磁盘**: 至少 5GB 可用磁盘空间
|
||||
|
||||
### 必需的系统工具
|
||||
- `docker` - Docker 容器引擎
|
||||
- `curl` - HTTP 客户端工具
|
||||
- `ssh` - SSH 客户端
|
||||
- `ssh-keygen` - SSH 密钥生成工具
|
||||
- `netstat` - 网络状态查看工具
|
||||
|
||||
### 安装依赖 (Ubuntu/Debian)
|
||||
```bash
|
||||
# 更新包管理器
|
||||
sudo apt-get update
|
||||
|
||||
# 安装 Docker
|
||||
sudo apt-get install docker.io
|
||||
|
||||
# 安装其他工具
|
||||
sudo apt-get install curl openssh-client net-tools
|
||||
|
||||
# 将用户添加到 docker 组
|
||||
sudo usermod -aG docker $USER
|
||||
newgrp docker
|
||||
```
|
||||
|
||||
### 安装依赖 (CentOS/RHEL)
|
||||
```bash
|
||||
# 安装 Docker
|
||||
sudo yum install docker
|
||||
|
||||
# 安装其他工具
|
||||
sudo yum install curl openssh-clients net-tools
|
||||
|
||||
# 启动 Docker 服务
|
||||
sudo systemctl start docker
|
||||
sudo systemctl enable docker
|
||||
|
||||
# 将用户添加到 docker 组
|
||||
sudo usermod -aG docker $USER
|
||||
```
|
||||
|
||||
## 注意事项
|
||||
|
||||
1. **权限要求**: 确保有 Docker 使用权限（用户在 docker 组中）
|
||||
2. **端口冲突**: 确保指定的端口未被占用
|
||||
3. **SSH 密钥**: 测试脚本会自动生成 SSH 密钥对
|
||||
4. **Docker 环境**: 确保 Docker 服务正在运行
|
||||
5. **脚本权限**: 确保所有 .sh 文件有执行权限
|
||||
|
||||
## 故障排除
|
||||
|
||||
### 权限错误
|
||||
```bash
|
||||
# 设置脚本执行权限
|
||||
chmod +x *.sh
|
||||
|
||||
# 检查 Docker 权限
|
||||
docker version
|
||||
```
|
||||
|
||||
### 路径不存在错误
|
||||
```bash
|
||||
# 运行路径验证
|
||||
./test_paths.sh
|
||||
```
|
||||
|
||||
### Docker 连接错误
|
||||
```bash
|
||||
# 检查 Docker 状态
|
||||
sudo systemctl status docker
|
||||
|
||||
# 启动 Docker 服务
|
||||
sudo systemctl start docker
|
||||
```
|
||||
|
||||
### 端口占用错误
|
||||
```bash
|
||||
# 查看端口占用
|
||||
netstat -tlnp | grep :8080
|
||||
netstat -tlnp | grep :2222
|
||||
|
||||
# 杀死占用进程
|
||||
sudo kill -9 <PID>
|
||||
```
|
||||
|
||||
### 日志查看
|
||||
```bash
|
||||
# 查看最新测试日志
|
||||
ls -la logs/ | tail -5
|
||||
|
||||
# 查看特定日志
|
||||
tail -f logs/test_suite_*.log
|
||||
|
||||
# 搜索错误信息
|
||||
grep -i error logs/*.log
|
||||
```
|
||||
|
||||
## 高级用法
|
||||
|
||||
### 自定义配置
|
||||
```bash
|
||||
# 使用自定义镜像标签
|
||||
export HEXO_IMAGE_TAG="my-hexo:custom"
|
||||
./start.sh
|
||||
|
||||
# 使用自定义容器名称
|
||||
export HEXO_CONTAINER_NAME="my-hexo-container"
|
||||
./start.sh
|
||||
```
|
||||
|
||||
### 批量测试
|
||||
```bash
|
||||
# 测试多个端口配置
|
||||
for port in 8080 8081 8082; do
|
||||
./run_test.sh "hexo-test:v0.0.3" "hexo-test-$port" $port $((port+1000))
|
||||
./functional_test.sh "hexo-test-$port" $port $((port+1000))
|
||||
./cleanup_test.sh "hexo-test-$port"
|
||||
done
|
||||
```
|
||||
|
||||
### 调试模式
|
||||
```bash
|
||||
# 启用详细输出
|
||||
set -x
|
||||
./start.sh
|
||||
set +x
|
||||
```
|
||||
|
||||
## 版本历史
|
||||
|
||||
### v0.0.3-linux-update (2025年5月30日)
|
||||
- ✅ 修正了所有测试脚本的路径处理
|
||||
- ✅ 统一了工作目录管理
|
||||
- ✅ 更新了默认端口配置 (8888 → 8080)
|
||||
- ✅ 添加了路径验证工具 `test_paths.sh`
|
||||
- ✅ 改进了错误处理和日志记录
|
||||
- ✅ 增强了脚本的可移植性和稳定性
|
||||
Reference in New Issue
Block a user