adragich/playwright

Playwright Docker镜像文档

镜像概述

本镜像基于官方Playwright Dockerfile构建，集成了yarn包管理器，并以root用户权限运行。已在Gitlab CI环境中通过Playwright v1.1.1测试验证，支持Chromium、Firefox和Webkit浏览器的主流功能测试场景。

核心功能与特性

• 官方兼容性：基于Playwright官方Dockerfile构建，确保与Playwright核心功能的兼容性
• 包管理支持：内置yarn包管理器，便于依赖安装与管理
• 权限灵活性：以root用户运行，支持需要高权限的操作场景
• 多浏览器支持：已验证支持Chromium、Firefox和Webkit浏览器的测试任务
• CI/CD适配：针对Gitlab CI环境优化，可直接集成到自动化测试流程

使用场景

• Gitlab CI/CD流水线中的Web自动化测试任务
• 需要root权限进行依赖安装或系统配置的Playwright测试环境
• 跨浏览器（Chromium/Firefox/Webkit）兼容性测试场景
• 本地开发环境中的Playwright测试环境快速搭建

使用方法

基本使用（Docker Run）

bash
docker run -it --rm \
  -v $(pwd):/workspace \
  -w /workspace \
  [镜像名称] \
  yarn install && npx playwright test

Gitlab CI配置示例

在.gitlab-ci.yml中集成：

yaml
playwright-test:
  image: docker.xuanyuan.run/[镜像名称]
  stage: test
  script:
    - yarn install
    - npx playwright install  # 确保浏览器依赖已安装
    - npx playwright test     # 执行测试
  artifacts:
    paths:
      - playwright-report/    # 保存测试报告
    when: always

环境配置说明

• 工作目录：建议将项目代码挂载到/workspace目录
• 依赖安装：使用yarn install安装项目依赖
• 浏览器安装：首次使用需执行npx playwright install安装浏览器二进制文件
• 测试执行：通过npx playwright test命令运行测试套件

注意事项

• 由于以root用户运行，需注意文件权限管理，避免宿主机文件权限被意外修改
• 建议在生产环境中根据实际需求调整用户权限，遵循最小权限原则
• 确保本地网络环境可访问Playwright浏览器下载源，或提前配置镜像源