Allure Report Generator镜像文档

镜像概述

Allure是一个开源框架，旨在创建团队中每个人都能清晰理解的测试执行报告。本镜像（sorinsugar/allure-report-generator）用于基于测试结果（allure results）生成Allure测试报告，将报告输出到指定目录，方便团队成员查看和分析测试结果。

核心功能与特性

• 报告生成：基于本地测试结果目录（allure-results）生成结构化的Allure测试报告。
• 目录映射：支持将生成的报告输出到本地指定目录，便于后续处理和共享。
• 轻量集成：可快速集成到测试流程中，无需复杂配置即可生成报告。

使用场景

适用于开发、测试团队在测试执行完成后，需要生成直观、详细的测试报告并在团队内共享的场景，帮助团队成员快速了解测试覆盖情况、失败原因等关键信息。

使用方法

生成Allure报告

通过以下命令生成报告，需指定本地测试结果目录和报告输出目录：

1. 将<allure-results-dir>替换为本地存放测试结果（.json/.xml文件）的实际路径；
2. 将<allure-report-dir>替换为本地用于存放生成报告的空目录（需提前创建）。

bash
docker run --rm -v <allure-results-dir>:/results -v <allure-report-dir>:/report sorinsugar/allure-report-generator:latest

执行后，Allure报告将生成在本地<allure-report-dir>目录中。

查看Allure报告

生成报告后，可通过Web服务器（如httpd:alpine）展示报告，步骤如下：

1. 使用以下命令启动HTTP服务器，将报告目录挂载到Web服务器根目录：

bash
docker run --rm -p 8080:80 -v <allure-report-dir>:/usr/local/apache2/htdocs/ httpd:alpine

2. 服务器启动后，通过浏览器访问 [***] 即可查看生成的Allure报告。

说明：--rm 参数表示容器退出后自动删除，避免残留临时容器；-p 8080:80 将容器80端口映射到主机8080端口，可根据需要修改主机端口。