selenium/standalone-docker

带动态功能的Selenium Grid Standalone

此镜像提供Selenium Grid Standalone，可动态创建Docker浏览器子容器，使您能够远程运行WebDriver测试。

动态网格

Grid 4具备按需启动Docker容器的能力，这意味着它会为每个新的会话请求在后台启动一个Docker容器，测试在其中执行，测试完成后容器会被销毁。

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

更多详情请参见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。
# 使用127.0.0.1是因为当挂载/var/run/docker.sock时，容器内部使用socat
# 如果未挂载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"

# 如果在单独的VM上运行节点，请取消以下部分的注释
# 用适当的值填写占位符
#[server]
#host = <node-machine的IP>
#port = <node-machine的端口>

如何运行此镜像

1. 启动Standalone Dynamic容器

bash
docker run --rm --name selenium-docker -p 4444:4444 \
    -v ${PWD}/config.toml:/opt/bin/config.toml \
    -v ${PWD}/assets:/opt/selenium/assets \
    -v /var/run/docker.sock:/var/run/docker.sock \
    selenium/standalone-docker:latest

Windows PowerShell

bash
docker run --rm --name selenium-docker -p 4444:4444 `
    -v ${PWD}/config.toml:/opt/bin/config.toml `
    -v ${PWD}/assets:/opt/selenium/assets `
    -v /var/run/docker.sock:/var/run/docker.sock `
    selenium/standalone-docker:latest

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-<Major>.<Minor>.<Patch>-<YYYYMMDD>

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

    Selenium Server 4.9.0
    发布日期 20230426


e126989f151e        selenium/standalone-docker   4
e126989f151e        selenium/standalone-docker   4.9
e126989f151e        selenium/standalone-docker   4.9.0
e126989f151e        selenium/standalone-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%89%BE%E5%88%B0%E9%80%82%E5%90%88%E6%82%A8%E4%BD%BF%E7%94%A8%E5%9C%BA%E6%99%AF%E7%9A%84%E6%AD%A3%E7%A1%AE%E9%85%8D%E7%BD%AE%E6%96%B9%E6%B3%95%E3%80%82

许可证

该项目由志愿者贡献者实现，他们投入了数千小时的时间，并根据https://raw.githubusercontent.com/SeleniumHQ/selenium/trunk/LICENSE%E8%AE%B8%E5%8F%AF%E5%8D%8F%E8%AE%AE%E5%BC%80%E6%BA%90%E6%BA%90%E4%BB%A3%E7%A0%81%E3%80%82