Selenium Grid Node Base 镜像文档

1. 镜像概述与主要用途

1.1 概述

Selenium Grid Node Base 镜像（以下简称“基础镜像”）是 Selenium Grid 浏览器节点镜像的共享基础镜像，为所有 Selenium Grid 浏览器相关镜像（如 Chrome 节点、Firefox 节点、Edge 节点等）提供统一的底层环境支持。

1.2 主要用途

该镜像的核心用途是作为构建其他 Selenium Grid 浏览器节点镜像的基础依赖，提供标准化的运行环境和组件框架。本身不提供直接可用的功能，无法独立用于 Selenium Grid 的节点部署或浏览器自动化操作。

2. 核心功能与特性

• 统一基础环境：提供 Selenium Grid 浏览器节点运行所需的底层依赖（如操作系统基础组件、Java 运行时、Selenium 基础库等），确保各浏览器节点镜像的环境一致性。
• 标准化配置框架：内置 Selenium Grid 节点的基础配置模板，简化上层浏览器节点镜像的配置流程，降低开发和维护成本。
• 跨浏览器兼容性支持：作为共享基础，支持 Chrome、Firefox、Edge 等多种浏览器节点镜像的构建，确保不同浏览器节点在 Selenium Grid 中协同工作的兼容性。

3. 使用场景与适用范围

3.1 使用场景

• Selenium Grid 环境构建：作为底层依赖，支持基于此镜像的浏览器节点镜像（如 selenium/node-chrome、selenium/node-firefox 等）部署，间接参与 Selenium Grid 分布式测试环境的搭建。

3.2 适用范围

• 不建议直接使用：该镜像仅作为基础依赖，无独立功能，直接运行不会产生有效服务。
• 目标用户：Selenium Grid 环境的部署者或运维人员，通过使用基于此基础镜像的浏览器节点镜像（如独立浏览器镜像或节点镜像）实现分布式测试。

4. 使用方法与配置说明

4.1 间接使用方式

由于基础镜像无法直接运行，需通过使用基于其构建的 Selenium Grid 浏览器镜像间接使用。推荐的可用镜像包括：

• 独立浏览器镜像（集成节点与浏览器，可直接运行）：
  • Standalone Firefox
  • Standalone Edge
  • Standalone Chrome
• Grid 节点镜像（需配合 Grid Hub 使用）：
  • Node Firefox
  • Node Chrome
  • Node Edge
• Grid Hub 镜像（用于管理节点）：
  • Grid Hub

4.2 部署示例

以下为基于基础镜像的具体浏览器镜像的部署示例（间接使用基础镜像的方式），详细配置请参考 Docker-Selenium 项目文档。

4.2.1 运行独立 Chrome 镜像（基于基础镜像构建）

bash
# 启动独立 Chrome 节点（集成浏览器，可直接用于自动化测试）
docker run -d -p 4444:4444 --shm-size="2g" selenium/standalone-chrome:latest

4.2.2 Docker Compose 部署 Grid 环境（含 Hub 与 Chrome 节点）

yaml
# docker-compose.yml
version: "3"
services:
  hub:
    image: selenium/hub:latest
    ports:
      - "4444:4444"
    environment:
      - SE_OPTS="-debug"
  chrome-node:
    image: selenium/node-chrome:latest  # 基于基础镜像构建
    depends_on:
      - hub
    environment:
      - SE_EVENT_BUS_HOST=hub
      - SE_EVENT_BUS_PUBLISH_PORT=4442
      - SE_EVENT_BUS_SUBSCRIBE_PORT=4443
    shm_size: "2g"

5. 完整文档与参考

详细部署指南、配置参数及最佳实践，请参考 Docker-Selenium 项目 README。

6. 许可证

本项目基于 Apache License 2.0 开源协议，源代码由志愿者贡献并免费提供。