node-chrome 镜像文档

镜像概述和主要用途

node-chrome 是一个集成了 Selenium Node、Chrome 浏览器及 Testim Headless 扩展的 Docker 镜像。主要用途是提供标准化的浏览器测试环境，支持连接 Selenium Hub 执行自动化 Web 测试任务，尤其适用于需要 Chrome 浏览器环境及 Testim 扩展支持的无头测试场景。

核心功能和特性

1. Selenium Node 组件

• 内置 Selenium Node 服务，可直接连接 Selenium Hub，作为分布式测试节点接收并执行测试任务。
• 支持配置并发测试实例数、会话数等参数，适配不同测试负载需求。

2. Chrome 浏览器环境

• 预安装 Chrome 浏览器，提供真实浏览器运行环境，支持标准 Web 测试场景。
• 支持自定义 Chrome 启动参数（如无头模式、窗口大小、代理设置等）。

3. Testim Headless 扩展

• 集成 Testim Headless 扩展（以 ZIP 包形式内置），支持无头模式下的特定测试功能（如 DOM 操作增强、测试录制回放等 Testim 生态功能）。

使用场景和适用范围

• 自动化 Web 测试：需在 Chrome 浏览器环境中执行的 Web UI 自动化测试（如 Selenium 脚本）。
• Selenium Grid 分布式测试：作为 Selenium Grid 节点，与 Selenium Hub 配合实现多节点并发测试。
• CI/CD 流水线集成：在无头模式下运行测试，适配 Jenkins、GitLab CI 等 CI/CD 工具，支持自动化测试流程。
• Testim 扩展依赖场景：需使用 Testim Headless 扩展功能的测试任务（如基于 Testim 平台的测试脚本执行）。

详细使用方法和配置说明

前提条件

• 已安装 Docker 环境（Docker Engine 19.03+）。
• 已部署 Selenium Hub（用于接收测试任务，可通过 selenium/hub 镜像启动）。

基本使用流程

1. 启动 Selenium Hub（若未部署）：

   docker run -d -p 4444:4444 --name selenium-hub selenium/hub:latest
   

2. 启动 node-chrome 节点：
   通过 docker run 命令启动节点，连接到 Selenium Hub 并配置测试参数。

配置参数说明

node-chrome 镜像通过环境变量配置核心参数，常用参数如下：

Docker 部署示例

1. 基础 docker run 命令

docker run -d \
  --name node-chrome \
  --link selenium-hub:selenium-hub \  # 连接到本地 Selenium Hub 容器
  -e HUB_HOST=selenium-hub \          # 指定 Hub 主机（与 --link 对应）
  -e HUB_PORT=4444 \                  # Hub 端口
  -e NODE_MAX_INSTANCES=3 \           # 最大并发实例数设为 3
  -e CHROME_OPTS="--headless=new --disable-gpu --window-size=1280,720" \  # 无头模式启动 Chrome
  my-registry/node-chrome:latest      # 替换为实际镜像名称/标签

2. docker-compose 配置示例

创建 docker-compose.yml，定义 Hub 和 Node 节点：

version: '3'
services:
  selenium-hub:
    image: selenium/hub:latest
    ports:
      - "4444:4444"
    restart: always

  node-chrome:
    image: my-registry/node-chrome:latest  # 替换为实际镜像名称/标签
    depends_on:
      - selenium-hub
    environment:
      - HUB_HOST=selenium-hub
      - HUB_PORT=4444
      - NODE_MAX_INSTANCES=5
      - NODE_MAX_SESSION=5
      - CHROME_OPTS="--headless=new --no-sandbox"  # 无头模式+禁用沙箱（适配容器环境）
    restart: always

启动命令：

docker-compose up -d

验证节点状态

节点启动后，可通过 Selenium Hub 控制台（http://<hub-ip>:4444/grid/console）查看节点是否注册成功及状态。

注意事项

• 无头模式配置：生产环境建议通过 CHROME_OPTS 设置 --headless=new 启用无头模式，减少资源占用。
• 资源限制：根据测试并发需求调整 NODE_MAX_INSTANCES，避免容器资源耗尽（可通过 --memory --cpus 限制容器资源）。
• 扩展更新：若需更新 Testim 扩展，需重新构建镜像并替换内置的扩展 ZIP 包。