markadams/chromium-xvfb

Chromium in Docker via Xvfb

镜像概述和主要用途

该Docker镜像提供了在Docker容器中以无头模式运行真正的Chromium/Chrome浏览器的解决方案。如果您需要在Docker环境中使用Chrome运行Karma或Python Selenium测试，这是理想的选择。

使用场景和适用范围

适用场景包括：

• 在本地开发或CI构建期间，使用Karma在Docker中运行Javascript测试
• 在CI构建期间，使用Python在Docker中运行Selenium驱动的浏览器自动化测试
• 任何需要在Docker容器内使用真实Chrome浏览器的场景

镜像列表

• https://registry.hub.docker.com/u/markadams/chromium-xvfb/%EF%BC%9A%E5%9F%BA%E7%A1%80Docker%E9%95%9C%E5%83%8F%EF%BC%88%E5%AE%89%E8%A3%85Debian%E3%80%81Chromium%E3%80%81Xvfb%EF%BC%89
• https://registry.hub.docker.com/u/markadams/chromium-xvfb-js/%EF%BC%9A%E4%B8%93%E4%B8%BA%E8%BF%90%E8%A1%8C%E6%97%A0%E5%A4%B4JS%E6%B5%8B%E8%AF%95%E8%AE%BE%E8%AE%A1%EF%BC%88%E5%8C%85%E5%90%ABiojs (node) 和npm），自动执行npm install和npm test
• https://registry.hub.docker.com/u/markadams/chromium-xvfb-py2/%EF%BC%9A%E4%B8%93%E4%B8%BAPython 2环境下的无头Selenium测试设计，自动执行pip install -r requirements.txt
• https://registry.hub.docker.com/u/markadams/chromium-xvfb-py3/%EF%BC%9A%E4%B8%93%E4%B8%BAPython 3环境下的无头Selenium测试设计，自动执行pip3 install -r requirements.txt

核心功能和特性

项目的核心是包装脚本xvfb-chromium，其主要功能包括：

1. 启动X虚拟帧缓冲区（Xvfb），模拟X11显示环境，使浏览器GUI代码能够正常交互
2. 启动Chromium/Google Chrome并传递所有命令行参数至浏览器进程
3. 捕获SIGTERM信号并转发给浏览器及Xvfb进程，确保测试完成后进程正常退出，避免Karma等测试工具无限挂起

目录结构

• /images：包含所有chromium-xvfb-*镜像的源代码
• /samples：包含JS/Karma测试及Python 2、3版本Selenium测试的示例应用

使用方法和示例

运行示例应用

1. 进入/samples目录中的任意项目：

   bash
   cd samples/[项目名称]
   

2. 构建Docker镜像：

   bash
   docker build -t sample .
   

3. 运行容器：

   bash
   docker run sample
   

示例应用将执行测试并输出结果至控制台，同时在容器内test-results/目录生成xunit格式的XML测试报告。