selenium/event-bus

Selenium Grid EventBus Docker镜像

镜像概述和主要用途

该镜像提供Selenium Grid EventBus组件，是分布式Selenium Grid架构的关键组成部分，需与Router、Session Queue、Distributor等其他组件协同工作，共同实现远程WebDriver测试的分布式执行能力。

核心功能和特性

Selenium Grid分布式模式

分布式模式专为大型测试网格设计，支持对CPU和RAM资源进行精细化分配，可根据测试需求优化资源配置，提升整体测试效率和稳定性。EventBus作为分布式架构的消息中枢，负责组件间的通信协调。

使用场景和适用范围

适用于需要规模化执行WebDriver测试的场景，尤其适合测试任务量大、需跨多节点分布式运行的团队。通过与其他Selenium Grid组件配合，可构建支持多浏览器、多环境的远程测试基础设施。

使用方法和配置说明

部署示例

EventBus需与分布式网格的其他组件共同部署。以下为完整的docker-compose.yml配置示例，包含运行分布式Grid所需的全部组件：

yml
# 执行命令: `docker-compose -f docker-compose-v3-full-grid.yml up`
# 添加`-d`标志可后台运行
# 停止命令: Ctrl+C后执行`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

  selenium-router:
    image: selenium/router:latest
    container_name: selenium-router
    ports:
      - "4444:4444"  # 测试入口端口
    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:  # Chrome浏览器节点
    image: selenium/node-chrome: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

  edge:  # 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:  # 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

测试接入

部署完成后，将WebDriver测试目标地址指向http://localhost:4444即可接入分布式网格执行测试。

标签选择说明

镜像标签采用以下命名规范：

selenium/event-bus-<Major>.<Minor>.<Patch>-<YYYYMMDD>

版本示例（Selenium Grid Server 4.9.0，20230426发布）：

e126989f151e        selenium/event-bus   4          # 主版本标签
e126989f151e        selenium/event-bus   4.9        # 次版本标签
e126989f151e        selenium/event-bus   4.9.0      # 补丁版本标签
e126989f151e        selenium/event-bus   4.9.0-20230426  # 带发布日期的完整标签

建议使用完整标签（如4.9.0-20230426）固定版本，避免因latest标签自动更新导致环境变化。详细标签规则参见https://github.com/SeleniumHQ/docker-selenium/wiki/Tagging-Convention%E3%80%82

参考文档

• https://github.com/SeleniumHQ/docker-selenium

许可证

项目源代码基于https://raw.githubusercontent.com/SeleniumHQ/selenium/trunk/LICENSE%E5%BC%80%E6%BA%90%EF%BC%8C%E7%94%B1%E7%A4%BE%E5%8C%BA%E5%BF%97%E6%84%BF%E8%80%85%E5%BC%80%E5%8F%91%E7%BB%B4%E6%8A%A4%E3%80%82