chluehr/playwright Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Playwright视觉回归测试Docker镜像（含S3支持）

镜像概述

本Docker镜像集成Playwright测试框架，专为视觉回归测试设计，支持与Amazon S3集成，可便捷存储和管理测试基准图像及结果，简化跨环境的UI视觉一致性验证流程。

核心功能与特性

• 完整Playwright环境：内置Playwright及主流浏览器（Chromium、Firefox、WebKit），无需本地配置
• 视觉回归测试支持：提供UI截图对比能力，自动检测视觉差异
• S3集成：支持从S3下载基准图像、上传测试结果及差异截图
• 跨平台兼容：可在任意支持Docker的环境中运行，确保测试环境一致性
• 轻量级设计：优化镜像体积，减少资源占用

使用场景

• 前端UI组件视觉一致性验证
• 跨浏览器/设备的视觉兼容性测试
• CI/CD流程中的自动化视觉回归检查
• 团队协作中共享测试基准与结果
• 需要长期存储视觉测试资产的场景

使用方法

基本运行命令

bash
docker run -e AWS_ACCESS_KEY_ID=your_aws_access_key \
  -e AWS_SECRET_ACCESS_KEY=your_aws_secret_key \
  -e S3_BUCKET=your-s3-bucket \
  -v $(pwd)/tests:/app/tests \
  your-image-name \
  npx playwright test

环境变量配置

目录挂载

• 将本地测试文件目录挂载至容器内/app/tests，确保测试脚本可被执行
• 如需本地缓存测试结果，可额外挂载/app/results目录

Docker Compose示例

yaml
version: '3'
services:
  playwright-visual-test:
    image: your-image-name
    environment:
      - AWS_ACCESS_KEY_ID=your_aws_access_key
      - AWS_SECRET_ACCESS_KEY=your_aws_secret_key
      - S3_BUCKET=your-s3-bucket
      - S3_REGION=us-west-2
    volumes:
      - ./tests:/app/tests
      - ./local-results:/app/results
    command: npx playwright test --reporter=html

注意事项

• 确保S3存储桶已配置正确的访问权限，允许读写操作
• 首次运行时会自动上传初始基准图像至S3，后续测试将以此为对比基准
• 如需自定义测试配置，可在挂载的测试目录中添加playwright.config.js文件