Selenium Grid 4.48.0 Edge 152 镜像发布全解:tag_and_push_browser_images.sh 标签体系与版本矩阵实战

原创2026-10-03 21:08:491,713 阅读
文章标签:测试后端容器编排

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 在构建期完成的四件事:

  1. 安装 Edge:默认 EDGE_VERSION="microsoft-edge-stable",从 packages.microsoft.com 的 apt 源安装;当需要锁定历史版本(如本次的 152)时,Microsoft 会清理旧版本仓库,因此脚本会从 per-version 归档站下载对应 .deb 并通过 --allow-downgrades 降级安装(Dockerfile 第 16~34 行)。
  2. 安装 EdgeDriver:EDGE_DRIVER_VERSION 为空时,先按 microsoft-edge --version 提取主版本号,向 msedgedriver.microsoft.com 请求 LATEST_RELEASE_<major>_LINUX 指针;若该指针已被清理,则回退使用浏览器精确版本,再回退到 per-version 归档站下载(Dockerfile 第 51~68 行),最终符号链接到 /usr/bin/msedgedriver。
  3. 启动包装器:wrap_edge_binary 脚本(NodeEdge/wrap_edge_binary)把真实 Edge 二进制改名并生成包装脚本,注入 umask 002、--lang 到 LANGUAGE 环境变量的转换、以及 SE_BROWSER_ARGS_* 系列环境变量的聚合,最终以 --no-sandbox 启动浏览器——容器内以 root 运行浏览器所必需的参数。
  4. 写入浏览器信息:构建期把 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 版本做回归测试时快速锁定正确的镜像标签。

登录后查看全文
docker-selenium