mirror of
https://github.com/labring/FastGPT.git
synced 2026-02-28 01:02:28 +08:00
148 lines
3.0 KiB
Markdown
148 lines
3.0 KiB
Markdown
# 测试说明
|
||
|
||
## 测试类型
|
||
|
||
### 1. 单元测试 (`test/app.test.ts`)
|
||
|
||
基础的 HTTP 端点测试，无需外部依赖。
|
||
|
||
```bash
|
||
bun run test
|
||
```
|
||
|
||
测试内容：
|
||
- `/health` 健康检查
|
||
- `/openapi` OpenAPI 文档
|
||
- Bearer Token 鉴权
|
||
|
||
### 2. 集成测试 (`test/integration/`)
|
||
|
||
测试与真实 Sealos API 的集成，需要配置环境变量。
|
||
|
||
#### 配置步骤
|
||
|
||
1. 复制环境变量模板：
|
||
```bash
|
||
cp test/.env.test.template test/.env.test.local
|
||
```
|
||
|
||
2. 编辑 `test/.env.test.local`，填写真实配置：
|
||
```env
|
||
# 服务器配置
|
||
PORT=3000
|
||
TOKEN=your-api-token
|
||
|
||
# Sealos 配置（使用测试环境）- 提供 SEALOS_KC 后集成测试自动运行
|
||
SEALOS_BASE_URL=https://your-sealos-api.com
|
||
SEALOS_KC=your-kubeconfig-token
|
||
|
||
# 测试镜像
|
||
TEST_IMAGE=nginx:alpine
|
||
TEST_SANDBOX_IMAGE=ghcr.io/your-org/sandbox-server:latest
|
||
```
|
||
|
||
3. 运行测试（集成测试会自动运行，如果配置了 SEALOS_KC）：
|
||
```bash
|
||
bun run test
|
||
```
|
||
|
||
#### 测试内容
|
||
|
||
**容器生命周期测试** (`test/integration/container.test.ts`)
|
||
- ✅ 创建容器
|
||
- ✅ 获取容器信息
|
||
- ✅ 暂停容器
|
||
- ✅ 启动容器
|
||
- ✅ 删除容器
|
||
- ✅ 幂等性测试（重复创建、删除不存在的容器）
|
||
|
||
**沙盒操作测试** (`test/integration/sandbox.test.ts`)
|
||
- ✅ 健康检查
|
||
- ✅ 执行简单命令
|
||
- ✅ 捕获 stdout/stderr
|
||
- ✅ 工作目录设置
|
||
- ✅ 管道命令
|
||
- ✅ 多行脚本
|
||
- ✅ 错误处理
|
||
|
||
## 运行测试
|
||
|
||
### 仅运行单元测试
|
||
```bash
|
||
bun run test:run
|
||
```
|
||
|
||
### 运行所有测试（包括集成测试）
|
||
```bash
|
||
# 确保已配置 .env.test.local 并提供 SEALOS_KC
|
||
bun run test
|
||
```
|
||
|
||
### 运行特定测试文件
|
||
```bash
|
||
bun run test test/integration/container.test.ts
|
||
```
|
||
|
||
### 查看测试覆盖率
|
||
```bash
|
||
bun run test -- --coverage
|
||
```
|
||
|
||
## 注意事项
|
||
|
||
### 集成测试注意事项
|
||
|
||
1. **使用测试环境**
|
||
- 不要在生产环境运行集成测试
|
||
- 确保有足够的资源配额
|
||
|
||
2. **清理资源**
|
||
- 测试会自动清理创建的容器
|
||
- 如果测试中断，可能需要手动清理
|
||
|
||
3. **网络要求**
|
||
- 需要能访问 Sealos API
|
||
- 需要能拉取测试镜像
|
||
|
||
4. **超时设置**
|
||
- 容器启动可能需要 60-90 秒
|
||
- 某些测试设置了较长的超时时间
|
||
|
||
### 环境变量优先级
|
||
|
||
1. `.env.test.local` - 本地测试配置（不提交到 git）
|
||
2. 默认值 - 使用 mock 数据
|
||
|
||
### 跳过集成测试
|
||
|
||
如果 `SEALOS_KC` 未提供，集成测试会自动跳过。这样可以避免意外运行集成测试。
|
||
|
||
## 故障排查
|
||
|
||
### 测试失败：认证错误
|
||
- 检查 `SEALOS_KC` 是否有效
|
||
- 确认 token 有足够的权限
|
||
|
||
### 测试失败：超时
|
||
- 增加测试超时时间
|
||
- 检查网络连接
|
||
- 确认 Sealos 服务正常
|
||
|
||
### 测试失败：容器创建失败
|
||
- 检查资源配额
|
||
- 确认镜像可访问
|
||
- 查看 Sealos 日志
|
||
|
||
## 示例
|
||
|
||
### 运行完整测试流程
|
||
|
||
```bash
|
||
# 1. 配置环境变量
|
||
cp test/.env.test.template test/.env.test.local
|
||
# 编辑 test/.env.test.local
|
||
|
||
# 2. 运行测试（集成测试会自动运行）
|
||
bun run test
|
||
```
|