ptrthomas/karate-chrome

Karate Chrome镜像文档

镜像概述

Karate Chrome镜像是一个集成了Google Chrome浏览器、Xvfb虚拟显示服务器、VNC服务器及视频录制工具的专用Docker镜像。该镜像旨在为Karate测试框架提供完整的UI自动化测试环境，支持在无图形界面环境中运行浏览器测试，并通过VNC实现测试过程的实时可视化，同时支持录制测试会话视频用于后续分析。

核心功能与特性

• Google Chrome浏览器：提供最新稳定版Chrome，支持现代Web应用的UI测试
• Xvfb虚拟显示：无需物理显示器即可运行图形化应用，适用于CI/CD等无界面环境
• VNC服务器：允许通过VNC客户端远程连接，实时查看测试执行过程
• 视频录制功能：自动记录测试会话视频，支持测试结果回溯与问题定位
• 预配置环境：已优化Karate框架兼容性，减少测试环境配置工作量

使用场景

• Karate框架的UI自动化测试执行
• 需要可视化监控的自动化测试场景
• CI/CD流水线中的Web应用UI测试集成
• 测试问题复现与调试
• 测试过程记录与审计

使用方法

基本使用（docker run）

bash
docker run -d -p 5900:5900 -v $(pwd)/tests:/karate/tests karatelabs/karate-chrome

参数说明：

• -d：后台运行容器
• -p 5900:5900：映射VNC服务端口（默认5900）
• -v $(pwd)/tests:/karate/tests：挂载本地测试脚本目录到容器内

环境变量配置

带环境变量的启动示例：

bash
docker run -d \
  -p 5900:5900 \
  -e VNC_PASSWORD=mysecret \
  -e RECORD_VIDEO=true \
  -e VIDEO_PATH=/karate/recordings \
  -v $(pwd)/tests:/karate/tests \
  -v $(pwd)/recordings:/karate/recordings \
  karatelabs/karate-chrome

VNC连接

1. 使用VNC客户端连接到容器主机的5900端口（例如：localhost:5900）
2. 输入配置的VNC密码（默认：karate）
3. 成功连接后即可实时查看Chrome浏览器中的测试执行过程

视频录制

1. 通过RECORD_VIDEO=true启用视频录制
2. 视频文件默认保存在容器内/karate/videos目录
3. 通过卷挂载（如-v $(pwd)/recordings:/karate/videos）可将录制的视频文件持久化到本地

Docker Compose配置示例

yaml
version: '3'
services:
  karate-chrome:
    image: karatelabs/karate-chrome
    ports:
      - "5900:5900"
    environment:
      - VNC_PASSWORD=test123
      - RECORD_VIDEO=true
      - SCREEN_RESOLUTION=1920x1080x24
    volumes:
      - ./karate-tests:/karate/tests
      - ./test-recordings:/karate/videos
    restart: unless-stopped

注意事项

• 首次启动可能需要几分钟时间下载和初始化依赖组件
• 高分辨率或长时间录制可能会增加容器资源消耗
• VNC连接仅建议用于调试，生产环境测试建议禁用VNC以节省资源
• 视频文件可能会占用较多磁盘空间，建议定期清理