### Jenkins 中 Python 项目的 Allure 测试报告生成教程 #### 配置虚拟环境 为了确保项目依赖项隔离，在 Jenkins 构建过程中可以通过 `venv` 创建独立的 Python 虚拟环境。运行以下命令来创建虚拟环境并激活它： ```bash python3 -m venv /path/to/new/virtual/environment [^1] source /path/to/new/virtual/environment/bin/activate ``` #### 安装必要的依赖包 在构建脚本中，使用 `pip` 命令安装所需的 Python 库以及 Allure 的相关工具。以下是常见的依赖列表及其安装方式： ```bash pip install pytest requests allure-pytest [^3] ``` 其中，`allure-pytest` 是用于集成 Pytest 和 Allure 报告插件的关键组件。 #### 编写测试用例 编写基于 Pytest 的单元测试或功能测试，并利用装饰器标记需要生成 Allure 报告的部分。例如： ```python import pytest import allure @allure.feature('User Login') def test_user_login(): assert True, 'Login successful' @allure.story('Invalid Credentials') def test_invalid_credentials(): with pytest.raises(Exception): raise Exception('Invalid credentials error') ``` #### 执行测试并生成原始数据 通过指定参数调用 Pytest 并生成 Allure 测试结果的原始 XML 数据文件。可以在 Jenkins Pipeline 或 Shell Script 步骤中加入如下命令： ```bash pytest --alluredir=result/tmp tests/ ``` 此命令会将测试执行的结果保存到 `result/tmp` 文件夹中[^2]。 #### 使用 Allure 工具生成 HTML 报告 完成测试后，需进一步处理这些原始数据以生成可读性强的 HTML 格式的测试报告。这一步可通过 Allure CLI 实现： ```bash allure generate result/tmp -o report/allure-report --clean ``` 上述命令中的选项解释如下： - `-o`: 指定输出目录； - `--clean`: 清理目标目录后再生成新报告。 #### 将报告集成至 Jenkins Dashboard 为了让团队成员更方便地访问测试报告，可以配置 Jenkins 插件展示 Allure 结果。具体操作包括但不限于安装 **Allure Plugin** 及设置 Post-build Actions 来自动发布每次构建后的最新版本链接地址。 --- ### 注意事项 如果遇到权限不足或者路径错误等问题，则可能是因为未正确初始化工作区或是缺少某些必备软件所致，请逐一排查直至恢复正常流程为止。