Selenium Grid 4.48.0 Edge 152 镜像发布全解:tag_and_push_browser_images.sh 标签体系与版本矩阵实战
Selenium Grid 4.48.0 Edge 152 镜像发布全解:tag_and_push_browser_images.sh 标签体系与版本矩阵实战
本文以 docker-selenium 仓库发布的 Edge 152 版本发布日志 为线索,深入拆解 Selenium Grid 4.48.0 与 Microsoft Edge 152 组合镜像的生成流程:从一条 tag_and_push_browser_images.sh 命令如何自动探测浏览器与驱动版本、批量生成并推送 10 个语义化标签,到这些标签在 selenium/node-edge 与 selenium/standalone-edge 两类镜像上的实际含义。读完本文,你将掌握 docker-selenium 浏览器镜像的完整标签命名规则、发布脚本的核心实现,以及如何在跨浏览器测试中精准选择适合自己场景的镜像标签。
一、这份发布日志在说什么
CHANGELOG/4.48.0/edge_152.md 记录了 docker-selenium 仓库针对 Selenium Grid 4.48.0 + Microsoft Edge 152.0.4191.62 + EdgeDriver 152.0.4191.62 这一组合的镜像打标签与推送过程。它同时是 CHANGELOG/README.md 中"Edge 版本矩阵"的细节来源——矩阵表中的每个 ✓ 链接都指向这样一份对应浏览器版本的详细日志。
从日志可以读出本次发布的三组关键版本信息:
| 组件 | 版本 | 说明 |
|---|---|---|
| Selenium Grid | 4.48.0-20260909 | 由 VERSION-BUILD_DATE 拼接而成 |
| Microsoft Edge | 152.0.4191.62 | 从镜像内执行 microsoft-edge --version 探测得到 |
| EdgeDriver | 152.0.4191.62 | 从镜像内执行 msedgedriver --version 探测得到 |
其中短版本(Short version)只取前两段:
- Edge 短版本:
152.0 - EdgeDriver 短版本:
152.0
版本矩阵页面的设计动机(见 CHANGELOG/README.md)是:在持续跟进最新 Selenium Grid 核心功能的同时,允许用户按浏览器版本精确锁定镜像,用于跨浏览器测试或在特定浏览器版本存在兼容性问题时回退。用户只需要根据矩阵找到合适的镜像标签,pull 下来即可开始测试。
二、发布命令与其七个参数
日志第一行给出了触发本次发布的完整命令:
./tag_and_push_browser_images.sh 4.48.0 20260909 selenium false edge true
对照 tag_and_push_browser_images.sh 脚本头部的参数解析(第 1~9 行),这七个位置参数的含义是:
| 参数 | 本次值 | 作用 |
|---|---|---|
VERSION |
4.48.0 |
Selenium Grid 版本号 |
BUILD_DATE |
20260909 |
构建日期,与 VERSION 拼成基础镜像标签 4.48.0-20260909 |
NAMESPACE |
selenium |
镜像仓库命名空间(Docker Hub 上的组织名) |
PUSH_IMAGE |
false |
是否在打标签后立即 docker push,本次为 false(仅打标签) |
BROWSER |
edge |
目标浏览器,脚本通过 case 分派到对应分支 |
RELEASE_OLD_VERSION |
true |
是否为旧版本补发标签,为 true 时跳过不带构建日期的精简标签 |
脚本还支持两个环境变量以适配 CI 场景:PROMOTE_TAGS(true 时表示镜像已在远端仓库,改用 docker buildx imagetools create 在 registry 之间直接打多架构标签,而不是本地 docker tag)和 PROMOTE_GHCR_NAMESPACE(在同一调用中同时镜像到 GHCR 命名空间,见脚本第 12~13 行注释)。
在仓库的 Makefile 中,这条命令被封装为 tag_and_push_edge_images target,VERSION、BUILD_DATE、NAMESPACE、PUSH_IMAGE、RELEASE_OLD_VERSION 均由 Makefile 变量注入:
tag_and_push_edge_images:
./tag_and_push_browser_images.sh $(VERSION) $(BUILD_DATE) $(NAMESPACE) $(PUSH_IMAGE) edge $(RELEASE_OLD_VERSION)
而 Makefile 中的 tag_and_push_browser_images 又聚合了 chrome、chrome-for-testing、chromium、edge、firefox 五个浏览器的对应 target,实现一次命令发布所有浏览器镜像。
三、脚本内部:Edge 分支的执行链路
1. 版本探测
脚本 edge 分支(tag_and_push_browser_images.sh)并不硬编码版本号,而是直接运行刚构建好的基础镜像并解析输出:
EDGE_VERSION=$(docker run --rm ${NAMESPACE}/node-edge:${TAG_VERSION} microsoft-edge --version | awk '{print $3}')
EDGE_SHORT_VERSION="$(short_version ${EDGE_VERSION})"
EDGEDRIVER_VERSION=$(docker run --rm ${NAMESPACE}/node-edge:${TAG_VERSION} msedgedriver --version | awk '{print $4}')
EDGEDRIVER_SHORT_VERSION="$(short_version ${EDGEDRIVER_VERSION})"
其中 short_version 函数(脚本第 53~57 行)按点号拆分版本字符串并只取前两段:
function short_version() {
local __long_version=$1
local __version_split=(${__long_version//./ })
echo "${__version_split[0]}.${__version_split[1]}"
}
这正是日志中 Edge version -> 152.0.4191.62、Short Edge version -> 152.0 两行的来源。注意探测所用基础镜像标签是 TAG_VERSION(即 4.48.0-20260909),说明该流程要求 node-edge:4.48.0-20260909 已在本机构建完成——在 Makefile 中它由 edge_upgrade_version target 通过 docker buildx build 产出(Makefile),构建完成后同样会运行 microsoft-edge --version 与 msedgedriver --version 做冒烟验证。
2. 标签列表的构造
探测出长、短两套版本号后,脚本构造出 10 个标签(脚本第 163~187 行),并循环对 node-edge 与 standalone-edge 两个镜像分别执行打标签与推送:
for edge_tag in "${EDGE_TAGS[@]}"; do
retag node-edge "${edge_tag}"
retag standalone-edge "${edge_tag}"
done
3. retag 函数:打标签还是跨 registry 复制
retag 函数(脚本第 31~51 行)根据 PROMOTE_TAGS 分流:
- 常规路径:执行
docker tag "${NAMESPACE}/${image}:${TAG_VERSION}" "${NAMESPACE}/${image}:${__tag}",若PUSH_IMAGE=true再追加docker push; PROMOTE_TAGS=true路径:说明镜像从未在本地构建(release 直接复用已测试镜像),此时docker tag无法表达多架构,改用docker buildx imagetools create在 index 层面、registry 到 registry 复制并同时打上目标标签;若设置了PROMOTE_GHCR_NAMESPACE,则在同一调用中追加 GHCR 命名空间的标签。
这也解释了为什么日志中 PUSH_IMAGE=false 时每条输出仍然是 Tagged ... 而不是 Pushed ...——脚本统一用 echo "Tagged ..." 报告结果。
四、10 个标签逐条解读
以下完整继承日志第 9~20 行的输出,并逐条说明语义。所有标签同时打在 selenium/node-edge 与 selenium/standalone-edge 两个镜像上,其中 standalone-edge 由 Standalone/Dockerfile 以 BASE=node-edge 为基础构建,内置了 Selenium Grid 服务端(由 Standalone/start-selenium-standalone.sh 启动),可独立运行;node-edge 则是需要配合 Hub/Grid 组件的 Node 角色。
全版本号标签(长标签)
Tagged selenium/node-edge:152.0.4191.62-edgedriver-152.0.4191.62-grid-4.48.0-20260909
Tagged selenium/standalone-edge:152.0.4191.62-edgedriver-152.0.4191.62-grid-4.48.0-20260909
Tagged selenium/node-edge:152.0.4191.62-edgedriver-152.0.4191.62-20260909
Tagged selenium/standalone-edge:152.0.4191.62-edgedriver-152.0.4191.62-20260909
Tagged selenium/node-edge:152.0.4191.62-20260909
Tagged selenium/standalone-edge:152.0.4191.62-20260909
152.0.4191.62-edgedriver-152.0.4191.62-grid-4.48.0-20260909:信息最完整的标签,精确锁定 Edge 版本、EdgeDriver 版本、Grid 版本与构建日期,适合对可复现性要求极高的 CI 流水线;152.0.4191.62-edgedriver-152.0.4191.62-20260909:去掉 grid 前缀,保留浏览器、驱动与构建日期;152.0.4191.62-20260909:仅浏览器版本加构建日期,此时 EdgeDriver 默认跟随浏览器主版本。
短版本标签
Tagged selenium/node-edge:152.0-edgedriver-152.0-grid-4.48.0-20260909
Tagged selenium/standalone-edge:152.0-edgedriver-152.0-grid-4.48.0-20260909
Tagged selenium/node-edge:152.0-edgedriver-152.0-20260909
Tagged selenium/standalone-edge:152.0-edgedriver-152.0-20260909
Tagged selenium/node-edge:152.0-20260909
Tagged selenium/standalone-edge:152.0-20260909
短版本标签把浏览器与驱动收敛到 152.0 主版本语义,同一大版本内的后续补丁发布不会改变这些标签的指向,适合"跟随 Edge 152 系列最新补丁"的团队。
为什么没有 152.0.4191.62-edgedriver-152.0.4191.62 这类标签?
日志中 10 个标签全部带有 -20260909 构建日期后缀,这是因为本次调用 RELEASE_OLD_VERSION=true。脚本第 176~187 行的逻辑决定了:当 RELEASE_OLD_VERSION=false(即正常发布新版本)时,会追加 4 个不带构建日期的精简标签(浏览器+驱动、纯浏览器、短版本+驱动、短版本),例如 152.0.4191.62-edgedriver-152.0.4191.62、152.0 等;而 true 表示这是对旧版本镜像的补发操作,为避免与后续构建的同名标签产生歧义,跳过这批精简标签。
五、标签规范与选型建议
docs/docker-hub/node-edge.md 对 node-edge 的标签结构做了完整说明,与脚本输出一一对应:
selenium/node-edge-<Major>.<Minor>.<Patch>-<YYYYMMDD>
selenium/node-edge-<browserVersion>-<browserDriver>-<browserDriverVersion>-<Major>.<Minor>.<Patch>-<YYYYMMDD>
以及由上述两种形式组合出的全部排列变体(<BrowserMajor>.<BrowserMinor>、-edgedriver-<DriverMajor>.<DriverMinor>、-grid-<Major>.<Minor>.<Patch>-<YYYYMMDD> 等)。选择建议:
- 追求完全可复现:使用
152.0.4191.62-edgedriver-152.0.4191.62-grid-4.48.0-20260909这类全信息标签; - 跟随某一大版本的最新补丁:使用
152.0或152.0-20260909; - 日常测试:可用
latest,但官方文档明确建议使用完整标签来锁定浏览器与 Grid 版本(见 docs/docker-hub/node-edge.md)。
需要强调 CHANGELOG/README.md 的免责声明:项目并未对每一种 Grid × 浏览器组合做完整回归测试,用户需根据自身测试需求评估选择,这正是版本矩阵与逐版本日志存在的意义——让组合选择透明化、可追溯。
六、NodeEdge 镜像内部如何承载 Edge 152
发布日志中的版本探测之所以能工作,依赖 NodeEdge/Dockerfile 在构建期完成的四件事:
- 安装 Edge:默认
EDGE_VERSION="microsoft-edge-stable",从 packages.microsoft.com 的 apt 源安装;当需要锁定历史版本(如本次的 152)时,Microsoft 会清理旧版本仓库,因此脚本会从 per-version 归档站下载对应.deb并通过--allow-downgrades降级安装(Dockerfile 第 16~34 行)。 - 安装 EdgeDriver:
EDGE_DRIVER_VERSION为空时,先按microsoft-edge --version提取主版本号,向msedgedriver.microsoft.com请求LATEST_RELEASE_<major>_LINUX指针;若该指针已被清理,则回退使用浏览器精确版本,再回退到 per-version 归档站下载(Dockerfile 第 51~68 行),最终符号链接到/usr/bin/msedgedriver。 - 启动包装器:
wrap_edge_binary脚本(NodeEdge/wrap_edge_binary)把真实 Edge 二进制改名并生成包装脚本,注入umask 002、--lang到LANGUAGE环境变量的转换、以及SE_BROWSER_ARGS_*系列环境变量的聚合,最终以--no-sandbox启动浏览器——容器内以 root 运行浏览器所必需的参数。 - 写入浏览器信息:构建期把
MicrosoftEdge、版本号以及{"ms:edgeOptions": {"binary": "${SE_BROWSER_BINARY_LOCATION:-/usr/bin/microsoft-edge}"}}写入/opt/selenium/browsers/edge/,供 Node 的配置生成机制(NodeBase 下的 generate_config)自动生成 Selenium Grid 节点配置,并默认启用SE_NODE_ENABLE_MANAGED_DOWNLOADS=true(Dockerfile 第 82~88 行)。
镜像内还带有一个常驻清理守护进程:supervisord 配置 NodeEdge/edge-cleanup.conf 在 SE_ENABLE_BROWSER_LEFTOVERS_CLEANUP=true 时拉起 NodeEdge/edge-cleanup.sh,按 SE_BROWSER_LEFTOVERS_PROCESSES_SECS(运行超过该秒数的 msedge 进程被 kill -9)、SE_BROWSER_LEFTOVERS_TEMPFILES_DAYS(清理 /tmp 下过期的 .com.microsoft.Edge.* 目录)、SE_BROWSER_LEFTOVERS_INTERVAL_SECS(主循环休眠间隔)三个参数循环清理,防止长期运行测试集群时遗留进程与临时文件耗尽资源。
七、验证发布结果
发布完成后,可以按日志中的探测方式自行验证所拉取镜像的版本一致性:
docker run --rm selenium/node-edge:152.0-20260909 microsoft-edge --version
docker run --rm selenium/node-edge:152.0-20260909 msedgedriver --version
docker run --rm selenium/standalone-edge:152.0-20260909 /opt/selenium/selenium-server.jar info --version
对照日志中的 Edge version -> 152.0.4191.62 与 EdgeDriver version -> 152.0.4191.62,即可确认标签指向的实际内容与矩阵记录一致。如需在网格中运行,可参考 docs/docker-hub/node-edge.md 的启动流程:先 docker network create grid 创建网络,再启动 Hub(docker run -d -p 4442-4444:4442-4444 --net grid --name selenium-hub selenium/hub:latest),随后用 --shm-size="2g" 启动 selenium/node-edge 节点并设置 SE_EVENT_BUS_HOST=selenium-hub,最后把 WebDriver 测试指向 http://localhost:4444。需要查看容器内浏览器运行情况时,可访问 http://localhost:7900/?autoconnect=1&resize=scale&password=secret 的 VNC/noVNC 界面。
八、小结
CHANGELOG/4.48.0/edge_152.md 虽然只是一份打标签命令的输出记录,但它完整呈现了 docker-selenium 浏览器镜像发布管线的核心设计:版本不硬编码、由镜像自证(在容器内探测浏览器与驱动版本),标签多粒度共存(长/短、带日期/不带日期、grid 前缀/无前缀),同一套标签双镜像复用(node 与 standalone)。理解了这份日志背后的 tag_and_push_browser_images.sh 实现与 NodeEdge/Dockerfile 镜像装配逻辑,你就能在跨浏览器测试中精准解读任意一个 selenium/node-edge:<tag> 或 selenium/standalone-edge:<tag> 的确切内容,也能在需要固定 Edge 版本做回归测试时快速锁定正确的镜像标签。