Karate-Chrome Docker镜像文档

镜像概述

Karate-Chrome是一个集成了Google Chrome浏览器、Xvfb虚拟显示服务、VNC远程控制服务器及视频录制工具的Docker镜像。该镜像专为Karate测试框架设计，提供开箱即用的浏览器自动化测试环境，支持无头模式运行或通过VNC可视化监控测试过程，同时具备测试会话视频录制能力，便于测试结果分析与问题复现。

核心功能与特性

• Google Chrome浏览器：内置最新稳定版Chrome，支持标准Web页面渲染与JavaScript执行，满足现代前端应用测试需求。
• Xvfb虚拟显示：通过虚拟帧缓冲技术，在无物理显示器的环境（如服务器、CI/CD流水线）中运行GUI应用，支持无头测试模式。
• VNC服务器：集成VNC服务，允许通过VNC客户端远程连接容器，实时查看Chrome浏览器界面及测试操作过程，支持调试与可视化验证。
• 视频录制功能：自动捕获并录制浏览器测试会话，生成视频文件（默认MP4格式），便于测试过程回放、问题定位及测试报告补充。

使用场景

• Karate框架UI自动化测试：作为Karate测试的浏览器运行环境，支持karate.webDriver()等API调用，实现端到端Web测试。
• 可视化测试监控：在开发或调试阶段，通过VNC连接实时观察测试执行过程，快速定位UI交互问题。
• 测试过程记录与审计：录制测试视频用于测试结果存档、团队协作分析或向 stakeholders 展示测试过程。
• CI/CD集成：在Jenkins、GitHub Actions等CI/CD平台中部署，提供标准化的浏览器测试环境，确保测试一致性。

使用方法与配置说明

基本启动命令

通过以下命令启动容器，默认暴露VNC端口（5900）以便远程连接：

docker run -d -p 5900:5900 karatelabs/karate-chrome

VNC连接配置

1. 连接方式：使用VNC客户端（如RealVNC、TigerVNC）连接至 localhost:5900（若容器运行在本地）或 <服务器IP>:5900（远程服务器）。
2. 密码设置：通过VNC_PASSWORD环境变量自定义访问密码，默认密码为karate：

   docker run -d -p 5900:5900 -e VNC_PASSWORD=mysecretpass karatelabs/karate-chrome
   

视频录制配置

1. 持久化视频文件：容器内视频默认保存路径为/karate/videos，通过卷挂载将录制文件保存至本地目录：

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

2. 视频参数调整：可通过环境变量修改视频分辨率（默认1280x720x24）或帧率：

   docker run -d -p 5900:5900 -e SCREEN_RESOLUTION=1920x1080x24 karatelabs/karate-chrome
   

与Karate测试框架集成

在Karate测试脚本中，通过配置WebDriver连接容器内的Chrome浏览器。示例karate-config.js配置：

function fn() {
  var config = {
    webDriver: {
      type: 'chrome',
      start: false,
      remoteUrl: 'http://localhost:9515' // 假设ChromeDriver暴露9515端口（需确认容器端口映射）
    }
  };
  return config;
}

注：具体端口映射需根据容器内ChromeDriver配置调整，建议参考***文档确认端口暴露方式。

环境变量参数说明

注意事项

• 容器运行时需确保足够的系统资源（建议至少2GB内存），以支持Chrome浏览器及视频录制功能。
• 生产环境中建议通过--user参数指定非root用户运行容器，增强安全性。
• 视频录制可能占用较多磁盘空间，建议定期清理或配置自动归档策略。