要在 Linux 中集成 Allure 和持续集成(CI)系统,您需要遵循以下步骤:
安装 Java 开发工具包(JDK): Allure 需要 Java 运行环境来生成报告。首先,请确保已在您的 Linux 机器上安装了 JDK。可以使用以下命令安装 OpenJDK:
sudo apt-get update
sudo apt-get install openjdk-11-jdk
安装 Allure 命令行工具: 您可以从 Allure 的 GitHub 存储库下载最新版本的 Allure 命令行工具。使用以下命令下载和解压缩 Allure:
wget https://github.com/allure-framework/allure2/releases/download/2.13.8/allure-2.13.8.zip
unzip allure-2.13.8.zip
将解压后的目录添加到 PATH 变量中,以便在任何位置调用 allure 命令。
export PATH=$PATH:/path/to/allure-2.13.8/bin
配置 CI 系统: 根据您使用的 CI 系统(例如 Jenkins、GitLab CI、Travis CI 等),您需要编写相应的配置文件,以便在构建过程中运行测试并生成 Allure 报告。以下是一个 GitLab CI 示例:
stages:
- test
- report
test:
stage: test
script:
- mvn clean test
artifacts:
paths:
- target/allure-results
report:
stage: report
script:
- allure generate --clean target/allure-results -o allure-report
artifacts:
paths:
- allure-report
这个示例中,我们首先运行测试并将 Allure 结果保存为构件。然后,在报告阶段,我们使用 Allure 命令行工具生成报告,并将其也作为构件保存。
将报告嵌入到 CI 系统中:
大多数 CI 系统允许将 HTML 报告嵌入到构建页面中。例如,在 GitLab CI 中,您可以在 .gitlab-ci.yml
文件中添加以下内容:
pages:
stage: deploy
script:
- cp -r allure-report public
artifacts:
paths:
- public
这将把报告复制到名为 public
的目录中,并在构建完成后将其部署到 GitLab Pages。
查看报告:
现在,每次构建完成时,您都可以在 CI 系统的 Web 界面中查看 Allure 报告。如果使用 GitLab CI,您可以通过访问 https://gitlab.com/<username>/<project>/-/jobs/<job_id>/artifacts/browse/public/
查看报告。
通过遵循这些步骤,您可以在 Linux 中集成 Allure 和持续集成系统,以便在每次构建后自动生成和查看测试报告。