85 lines
2.3 KiB
Markdown
85 lines
2.3 KiB
Markdown
# Jenkins + Allure 集成快速参考
|
||
|
||
## 快速开始
|
||
|
||
### 1. 安装Allure插件
|
||
- Jenkins → Manage Jenkins → Manage Plugins
|
||
- 搜索 "Allure Plugin" 并安装
|
||
|
||
### 2. 配置Allure工具
|
||
- Manage Jenkins → Global Tool Configuration
|
||
- Allure Commandline → 添加Allure安装路径
|
||
|
||
### 3. 创建Jenkins任务
|
||
|
||
#### 方式A：使用Jenkinsfile（推荐）
|
||
1. 新建Pipeline任务
|
||
2. Pipeline script from SCM
|
||
3. Script Path: `zhyy/test_case/Jenkinsfile`
|
||
4. 保存并运行
|
||
|
||
#### 方式B：自由风格项目
|
||
1. 新建Freestyle project
|
||
2. 构建步骤：执行 `jenkins_build.sh` 或 `jenkins_build.bat`
|
||
3. Post-build Actions → Allure Report
|
||
4. Results path: `zhyy/test_case/reports/allure-results`
|
||
|
||
## 参数化构建
|
||
|
||
在Jenkins任务中配置以下参数：
|
||
|
||
| 参数名 | 类型 | 说明 | 示例值 |
|
||
|--------|------|------|--------|
|
||
| RUN_TYPE | Choice | 运行方式 | all, feature, story, dir, file, keyword, marker |
|
||
| FEATURE_NAME | String | Feature标签 | 深圳采购工作台采购订单页面 |
|
||
| STORY_NAME | String | Story标签 | 验证采购工作台采购订单页面列表查询 |
|
||
| DIR_PATH | String | 目录路径 | 接口/SZPurchase |
|
||
| FILE_PATH | String | 文件路径 | 接口/SZPurchase/PurchaseOrderManage.py |
|
||
| KEYWORD | String | 关键字 | purchase |
|
||
| MARKER | String | Pytest标记 | smoke |
|
||
|
||
## 常用命令
|
||
|
||
### 本地运行
|
||
```bash
|
||
# 运行所有测试
|
||
python run_tests.py
|
||
|
||
# 按目录运行
|
||
python run_tests.py --dir "接口/SZPurchase"
|
||
|
||
# 按文件运行
|
||
python run_tests.py --file "接口/SZPurchase/PurchaseOrderManage.py"
|
||
|
||
# 生成并打开报告
|
||
python run_tests.py --all --report --open
|
||
```
|
||
|
||
### Jenkins中运行
|
||
```bash
|
||
# 使用构建脚本（自动检测参数）
|
||
bash jenkins_build.sh
|
||
|
||
# 或直接使用run_tests.py
|
||
python run_tests.py --all --no-report
|
||
```
|
||
|
||
## Allure报告路径
|
||
|
||
- **结果目录**: `zhyy/test_case/reports/allure-results`
|
||
- **报告目录**: `zhyy/test_case/reports/allure-report`
|
||
- **Jenkins中查看**: 构建完成后点击左侧 "Allure Report" 链接
|
||
|
||
## 环境变量
|
||
|
||
Jenkins会自动设置以下环境变量：
|
||
- `WORKSPACE`: Jenkins工作空间路径
|
||
- `BUILD_NUMBER`: 构建编号
|
||
- `JENKINS_URL`: Jenkins服务器地址
|
||
|
||
`run_tests.py` 会自动检测Jenkins环境并调整路径。
|
||
|
||
## 详细文档
|
||
|
||
更多配置说明请参考：`JENKINS_SETUP.md`
|