jbeardshogun/qa-automation

镜像概述

本Docker镜像基于cimg/node:16.1构建，集成了Google Chrome浏览器、metacity窗口管理器、xvfb虚拟显示服务及相关依赖组件，专为QA自动化场景设计，提供完整的GUI环境支持，可直接用于Web UI自动化测试、浏览器渲染任务等场景。

核心功能与特性

• 基础环境：基于cimg/node:16.1，提供Node.js 16.1运行环境，支持JavaScript自动化脚本执行
• 浏览器支持：预安装Google Chrome稳定版，满足Web页面渲染和交互需求
• 窗口管理：集成metacity窗口管理器，支持GUI窗口操作和管理
• 虚拟显示：包含xvfb虚拟显示服务，无需物理显示器即可运行GUI应用
• 依赖完整：预装Chrome运行依赖（fonts-liberation、libappindicator3-1、xdg-utils等），确保浏览器正常运行

使用场景

• QA自动化测试：支持Selenium、Playwright等工具的Web UI自动化测试
• 浏览器渲染任务：自动化网页截图、PDF生成、页面内容爬取等需要浏览器环境的场景
• 持续集成：可集成到CI/CD流程中，执行自动化测试用例，验证Web应用功能

使用方法与配置说明

基本使用

通过docker run命令启动容器：

bash
docker run -it --rm [镜像名称] bash

启动显示服务与窗口管理器

容器启动后，需先启动xvfb虚拟显示服务和metacity窗口管理器，以支持GUI操作：

bash
# 启动xvfb虚拟显示（分辨率1024x768，色深16位）
xvfb :1 -screen 0 1024x768x16 &

# 启动metacity窗口管理器
metacity &

# 验证Chrome安装（可选）
google-chrome --version

环境变量

• DISPLAY：默认值为:1.0，指定显示服务器地址，需与xvfb启动的显示端口对应

示例：运行Node.js自动化脚本

假设容器内存在Selenium自动化脚本test.js，执行步骤如下：

1. 启动xvfb和窗口管理器：

   bash
   xvfb :1 -screen 0 1024x768x16 &
   metacity &
   

2. 运行自动化脚本：

   bash
   node test.js
   

docker-compose配置示例

yaml
version: '3'
services:
  qa-automation:
    image: [镜像名称]
    environment:
      - DISPLAY=:1.0
    command: >
      bash -c "xvfb :1 -screen 0 1024x768x16 &
               metacity &
               node /path/to/your/test.js"
    volumes:
      - ./test-scripts:/path/to/your  # 挂载本地自动化脚本目录