andrcuns/allure-report-publisher

Allure报告云存储上传Docker镜像

镜像概述

该Docker镜像旨在提供一种便捷方式，将生成的Allure测试报告自动上传至云存储服务。Allure报告是一种详细的测试结果展示工具，通过本镜像可将其无缝集成到CI/CD流程中，实现报告的自动存储、备份与团队共享，无需手动操作，提升测试流程的自动化水平。

核心功能与特性

• 多云存储支持：兼容主流云存储服务，包括Amazon S3、Google Cloud Storage、Azure Blob Storage等
• 自动化上传：可与CI/CD工具（如Jenkins、GitHub Actions、GitLab CI）集成，测试完成后自动触发上传流程
• 配置灵活：通过环境变量轻松配置云存储访问凭证、存储路径、报告来源等参数
• 轻量级设计：基于精简基础镜像构建，资源占用低，运行高效，适合各类部署环境

使用场景与适用范围

• CI/CD流程集成：在自动化测试阶段生成Allure报告后，自动上传至云存储，确保测试结果可持久化存储
• 测试团队协作：将测试报告集中存储于云存储，方便团队成员通过共享链接随时访问查看
• 报告备份与归档：定期将历史测试报告上传至云存储，满足审计或回溯需求
• 跨环境共享：不同环境（开发、测试、生产）的测试报告统一存储，便于对比分析测试结果变化

使用方法与配置说明

前提条件

• 已生成Allure测试报告（通常位于本地目录，如./allure-report）
• 拥有目标云存储服务的访问权限（如访问密钥、存储桶权限等）

环境变量配置

Docker Run命令示例

上传至Amazon S3

bash
docker run -it --rm \
  -v $(pwd)/allure-report:/app/allure-report \  # 挂载本地Allure报告目录到容器内
  -e STORAGE_PROVIDER=s3 \
  -e BUCKET_NAME=my-test-reports-bucket \
  -e REPORT_PATH=/app/allure-report \
  -e AWS_ACCESS_KEY_ID=AKIAEXAMPLEKEY \
  -e AWS_SECRET_ACCESS_KEY=secret123 \
  -e AWS_REGION=us-east-1 \
  -e REMOTE_PATH=reports/20240520 \
  allure-report-uploader:latest

上传至Google Cloud Storage

bash
docker run -it --rm \
  -v $(pwd)/allure-report:/app/allure-report \
  -e STORAGE_PROVIDER=gcs \
  -e BUCKET_NAME=my-test-reports-bucket \
  -e REPORT_PATH=/app/allure-report \
  -e GCS_SERVICE_ACCOUNT_KEY='{"type":"service_account","project_id":"my-project",...}' \
  -e REMOTE_PATH=reports/20240520 \
  docker.xuanyuan.run/allure-report-uploader:latest

Docker Compose配置示例

yaml
version: '3'
services:
  report-uploader:
    image: docker.xuanyuan.run/allure-report-uploader:latest
    volumes:
      - ./allure-report:/app/allure-report  # 本地报告目录映射
    environment:
      - STORAGE_PROVIDER=s3
      - BUCKET_NAME=my-test-reports-bucket
      - REPORT_PATH=/app/allure-report
      - AWS_ACCESS_KEY_ID=AKIAEXAMPLEKEY
      - AWS_SECRET_ACCESS_KEY=secret123
      - AWS_REGION=us-east-1
      - REMOTE_PATH=reports/latest  # 云存储中的目标路径

注意事项

• 确保本地Allure报告目录已正确生成且可被容器访问（通过卷挂载）
• 云存储访问凭证需具备足够权限（如S3需s3:PutObject权限，GCS需storage.objects.create权限）
• 不同云存储提供商的环境变量配置不同，需根据实际使用的提供商填写对应参数
• 可通过容器日志查看上传进度与结果，若上传失败可检查网络连接、凭证有效性或存储桶权限