selenium/router

Docker镜像：Selenium Grid Router

1. 镜像概述和主要用途

本镜像提供Selenium Grid Router组件，需与Selenium分布式网格的其他组件配合使用。这些组件共同构成分布式测试架构，支持远程运行WebDriver测试。

2. 核心功能和特性

• 请求路由：作为分布式网格的入口点，接收外部测试请求并路由至合适的节点
• 组件协同：与事件总线（Event Bus）、会话队列（Session Queue）、分发器（Distributor）等组件通信，实现测试任务的分发与管理
• 高可用性：支持分布式架构下的资源动态调度，确保测试请求高效处理
• 标准化接口：对外提供统一的WebDriver协议接口，简化测试脚本配置

3. 使用场景和适用范围

适用于需要大规模并行执行WebDriver测试的场景，包括：

• 企业级自动化测试：支持多浏览器、多版本并行测试
• CI/CD流程集成：在持续集成/持续部署链路中自动化执行测试用例
• 资源精细化管理：尤其适合对CPU、RAM资源有严格分配需求的大型网格环境（如数百个并发测试任务）

4. 使用方法和配置说明

4.1 部署架构

分布式网格至少需6个组件协同工作：Router、Session Queue、Distributor、Event Bus、Session Map、Node（浏览器节点）。推荐通过docker-compose部署完整架构。

4.2 docker-compose配置示例

yaml
# 执行命令：docker-compose -f docker-compose-v3-full-grid.yml up
# 添加`-d`参数可后台运行；停止命令：docker-compose -f docker-compose-v3-full-grid.yml down
version: "3"
services:
  # 事件总线：组件间通信中枢
  selenium-event-bus:
    image: selenium/event-bus:latest
    container_name: selenium-event-bus
    ports:
      - "4442:4442"  # 发布端口
      - "4443:4443"  # 订阅端口
      - "5557:5557"  # 调试端口

  # 会话映射：管理活跃测试会话
  selenium-sessions:
    image: selenium/sessions:latest
    container_name: selenium-sessions
    ports:
      - "5556:5556"  # 会话映射服务端口
    depends_on:
      - selenium-event-bus
    environment:
      - SE_EVENT_BUS_HOST=selenium-event-bus  # 事件总线主机名
      - SE_EVENT_BUS_PUBLISH_PORT=4442       # 事件总线发布端口
      - SE_EVENT_BUS_SUBSCRIBE_PORT=4443     # 事件总线订阅端口

  # 会话队列：管理待处理的测试请求队列
  selenium-session-queue:
    image: selenium/session-queue:latest
    container_name: selenium-session-queue
    ports:
      - "5559:5559"  # 会话队列服务端口

  # 分发器：将请求分配至可用节点
  selenium-distributor:
    image: selenium/distributor:latest
    container_name: selenium-distributor
    ports:
      - "5553:5553"  # 分发器端口
    depends_on:
      - selenium-event-bus
      - selenium-sessions
      - selenium-session-queue
    environment:
      - SE_EVENT_BUS_HOST=selenium-event-bus      # 事件总线主机名
      - SE_EVENT_BUS_PUBLISH_PORT=4442             # 事件总线发布端口
      - SE_EVENT_BUS_SUBSCRIBE_PORT=4443           # 事件总线订阅端口
      - SE_SESSIONS_MAP_HOST=selenium-sessions     # 会话映射服务主机名
      - SE_SESSIONS_MAP_PORT=5556                  # 会话映射服务端口
      - SE_SESSION_QUEUE_HOST=selenium-session-queue  # 会话队列服务主机名
      - SE_SESSION_QUEUE_PORT=5559                 # 会话队列服务端口

  # Router：测试请求入口
  selenium-router:
    image: selenium/router:latest
    container_name: selenium-router
    ports:
      - "4444:4444"  # 对外提供的WebDriver接口端口
    depends_on:
      - selenium-distributor
      - selenium-sessions
      - selenium-session-queue
    environment:
      - SE_DISTRIBUTOR_HOST=selenium-distributor  # 分发器主机名
      - SE_DISTRIBUTOR_PORT=5553                  # 分发器端口
      - SE_SESSIONS_MAP_HOST=selenium-sessions     # 会话映射服务主机名
      - SE_SESSIONS_MAP_PORT=5556                  # 会话映射服务端口
      - SE_SESSION_QUEUE_HOST=selenium-session-queue  # 会话队列服务主机名
      - SE_SESSION_QUEUE_PORT=5559                 # 会话队列服务端口

  # 浏览器节点：实际执行测试的容器（示例包含Chrome、Edge、Firefox）
  chrome:
    image: selenium/node-chrome:latest
    shm_size: 2gb  # 浏览器共享内存大小（推荐至少2GB）
    depends_on:
      - selenium-event-bus
    environment:
      - SE_EVENT_BUS_HOST=selenium-event-bus
      - SE_EVENT_BUS_PUBLISH_PORT=4442
      - SE_EVENT_BUS_SUBSCRIBE_PORT=4443

  edge:
    image: selenium/node-edge:latest
    shm_size: 2gb
    depends_on:
      - selenium-event-bus
    environment:
      - SE_EVENT_BUS_HOST=selenium-event-bus
      - SE_EVENT_BUS_PUBLISH_PORT=4442
      - SE_EVENT_BUS_SUBSCRIBE_PORT=4443

  firefox:
    image: selenium/node-firefox:latest
    shm_size: 2gb
    depends_on:
      - selenium-event-bus
    environment:
      - SE_EVENT_BUS_HOST=selenium-event-bus
      - SE_EVENT_BUS_PUBLISH_PORT=4442
      - SE_EVENT_BUS_SUBSCRIBE_PORT=4443

4.3 关键配置说明

4.3.1 端口映射

4.3.2 环境变量（Router组件）

4.4 测试接入

部署完成后，WebDriver测试脚本需指向Router的接口地址：http://localhost:4444。

5. 镜像标签选择

为确保版本稳定性，推荐使用完整标签固定具体版本。标签结构如下：

selenium/router-<Major>.<Minor>.<Patch>-<YYYYMMDD>

示例（Selenium Grid Server 4.9.0，2023年4月26日发布）

selenium/router:4          # 主版本4（自动更新至最新次版本）
selenium/router:4.9        # 主版本4.9（自动更新至最新补丁版本）
selenium/router:4.9.0      # 完整版本号4.9.0
selenium/router:4.9.0-20230426  # 包含发布日期的精确版本

详细标签规则参见https://github.com/SeleniumHQ/docker-selenium/wiki/Tagging-Convention%E3%80%82

6. 完整文档与许可证

• 完整文档：参见https://github.com/SeleniumHQ/docker-selenium
• 许可证：https://raw.githubusercontent.com/SeleniumHQ/selenium/trunk/LICENSE%EF%BC%88%E5%BC%80%E6%BA%90%E5%85%8D%E8%B4%B9%EF%BC%8C%E5%85%81%E8%AE%B8%E5%95%86%E4%B8%9A%E4%BD%BF%E7%94%A8%EF%BC%89