2.3 KiB
2.3 KiB
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（推荐）
- 新建Pipeline任务
- Pipeline script from SCM
- Script Path:
zhyy/test_case/Jenkinsfile - 保存并运行
方式B：自由风格项目
- 新建Freestyle project
- 构建步骤：执行
jenkins_build.sh或jenkins_build.bat - Post-build Actions → Allure Report
- 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 |
常用命令
本地运行
# 运行所有测试
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 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