selenium/node-docker

Selenium Grid 动态能力节点镜像

镜像概述和主要用途

该镜像提供Selenium Grid 节点，可动态创建子Docker浏览器容器，旨在与Selenium Grid 中心节点配合使用，使您能够远程运行WebDriver测试。

核心功能和特性

Dynamic Grid

Grid 4具备按需启动Docker容器的能力，即针对每个新的会话请求在后台启动Docker容器，测试在其中执行，测试完成后容器即被销毁。

此执行模式可用于Standalone（独立）或Node（节点）角色。"动态"执行模式需要指定启动容器时使用的Docker镜像，此外，Grid需要知道Docker守护进程的URI。这些配置可放在本地toml文件中。

更多详情请参见GitHub上的https://github.com/SeleniumHQ/docker-selenium/tree/trunk#dynamic-grid%E3%80%82

配置说明

配置示例

您可将以下内容保存为本地文件，例如命名为config.toml。

toml
[docker]
# 配置包含Docker镜像与需要匹配的能力之间的映射，用于启动指定镜像的容器
configs = [
    "selenium/standalone-firefox:latest", '{"browserName": "firefox"}',
    "selenium/standalone-chrome:latest", '{"browserName": "chrome"}',
    "selenium/standalone-edge:latest", '{"browserName": "MicrosoftEdge"}'
]

# 连接Docker守护进程的URL
# 最简单的方式是保持为http://127.0.0.1:2375，并挂载/var/run/docker.sock
# 当挂载/var/run/docker.sock时，容器内部使用socat，因此使用127.0.0.1
# 若未挂载var/run/docker.sock：
# Windows：确保Docker Desktop通过tcp暴露守护进程，使用http://host.docker.internal:2375
# macOS：安装socat并运行命令socat -4 TCP-LISTEN:2375,fork UNIX-CONNECT:/var/run/docker.sock，然后使用http://host.docker.internal:2375
# Linux：因机器而异，建议挂载/var/run/docker.sock，若无效请创建issue
url = "http://127.0.0.1:2375"
# 用于视频录制的Docker镜像
video-image = "selenium/video:ffmpeg-4.3.1-20230421"

# 若在单独虚拟机上运行节点，请取消以下部分的注释
# 用适当的值替换占位符
#[server]
#host = <节点机器的IP>
#port = <节点机器的端口>

使用方法

如何运行此镜像

1. 在同一网络中启动中心节点（Hub）和节点（Node）Docker容器

这可扩展为完整的Grid部署，所有组件单独部署。总体思路是将Hub部署在一台虚拟机，每个Node部署在单独的、性能更强的虚拟机上。

macOS/Linux

bash
$ docker network create grid
$ docker run -d -p 4442-4444:4442-4444 --net grid --name selenium-hub selenium/hub:latest
$ docker run -d --net grid -e SE_EVENT_BUS_HOST=selenium-hub \
    -e SE_EVENT_BUS_PUBLISH_PORT=4442 \
    -e SE_EVENT_BUS_SUBSCRIBE_PORT=4443 \
    -v ${PWD}/config.toml:/opt/bin/config.toml \
    -v ${PWD}/assets:/opt/selenium/assets \
    -v /var/run/docker.sock:/var/run/docker.sock \
    selenium/node-docker:latest

Windows PowerShell

powershell
$ docker network create grid
$ docker run -d -p 4442-4444:4442-4444 --net grid --name selenium-hub selenium/hub:latest
$ docker run -d --net grid -e SE_EVENT_BUS_HOST=selenium-hub `
    -e SE_EVENT_BUS_PUBLISH_PORT=4442 `
    -e SE_EVENT_BUS_SUBSCRIBE_PORT=4443 `
    -v ${PWD}/config.toml:/opt/bin/config.toml `
    -v ${PWD}/assets:/opt/selenium/assets `
    -v /var/run/docker.sock:/var/run/docker.sock `
    selenium/node-docker:latest

若要在主机上保存资产，请将主机路径挂载到/opt/selenium/assets。

注意：在Linux中挂载卷时，存在一个已知问题，可通过https://github.com/SeleniumHQ/docker-selenium/tree/trunk#mounting-volumes-to-retrieve-downloaded-files%E8%A7%A3%E5%86%B3%E3%80%82

使用Grid完毕且容器已退出后，可通过以下命令删除网络：

bash
# 删除grid网络
$ docker network rm grid

2. 将WebDriver测试指向http://localhost:4444

3. 完成！

4. （可选）要查看容器内部情况，可访问Grid UI：http://localhost:4444/ui。

• 上述示例使用latest作为标签，但建议使用完整标签固定特定浏览器和Grid版本。详情请参见https://github.com/SeleniumHQ/docker-selenium/wiki/Tagging-Convention%E3%80%82

如何选择适合的标签

标签结构如下：

selenium/standalone-docker-<主版本>.<次版本>.<补丁版本>-<YYYYMMDD>

例如，Selenium Grid Server 4.9.0版本，发布日期20230426

    Selenium Server 4.9.0
    发布日期 20230426


e126989f151e        selenium/node-docker   4
e126989f151e        selenium/node-docker   4.9
e126989f151e        selenium/node-docker   4.9.0
e126989f151e        selenium/node-docker   4.9.0-20230426

通过这种方式，您可以使用不同的标签获取最新版本，建议使用完整标签以确保版本稳定。

完整文档

Docker-Selenium项目在GitHub上有详细的https://github.com/SeleniumHQ/docker-selenium%EF%BC%8C%E5%8F%AF%E5%B8%AE%E5%8A%A9%E6%82%A8%E6%A0%B9%E6%8D%AE%E5%85%B7%E4%BD%93%E4%BD%BF%E7%94%A8%E5%9C%BA%E6%99%AF%E6%AD%A3%E7%A1%AE%E9%83%A8%E7%BD%B2%E9%95%9C%E5%83%8F%E3%80%82

许可证

该项目由志愿者贡献者投入数千小时开发，源代码根据https://raw.githubusercontent.com/SeleniumHQ/selenium/trunk/LICENSE%E5%BC%80%E6%BA%90%E3%80%82