Selenium Grid Docker 镜像标签生成与发布实战:从 Chrome 102 打标日志读懂 tag 命名规则

原创2026-10-08 17:48:551,751 阅读
文章标签:测试后端容器编排

Selenium Grid Docker 镜像标签生成与发布实战:从 Chrome 102 打标日志读懂 tag 命名规则

本篇技术指南以 docker-selenium 仓库中 CHANGELOG/archived/4.34.0/chrome_102.md 这份真实执行日志为骨架,逐行拆解 tag_and_push_browser_images.sh 如何为 Chrome 102 生成并发布一整套镜像标签,并结合 NodeChrome/ 目录下的浏览器与驱动安装脚本解释其底层原理。读完本文,你将掌握 Selenium Docker 镜像 tag 的完整命名体系(完整版本、短版本、构建日期、Grid 版本四要素如何组合)、打标脚本的参数约定与执行链路,以及如何在自己的测试中精准拉取并消费这些标签。

这份 changelog 记录了什么

CHANGELOG/archived/4.34.0/chrome_102.md 本身是一段简洁的终端输出日志,它是发布流水线为"Chrome 102 + Selenium Grid 4.34.0"这一镜像组合执行打标与推送时留下的真实记录:

./tag_and_push_browser_images.sh 4.34.0 20250727 selenium false chrome true
Tagging images for browser chrome, version 4.34.0, build date 20250727, namespace selenium
Selenium Grid version -> 4.34.0-20250727
Chrome version -> 102.0.5005.115
Short Chrome version -> 102.0
ChromeDriver version -> 102.0.5005.61
Short ChromeDriver version -> 102.0
Tagged selenium/node-chrome:102.0.5005.115-chromedriver-102.0.5005.61-grid-4.34.0-20250727
Tagged selenium/standalone-chrome:102.0.5005.115-chromedriver-102.0.5005.61-grid-4.34.0-20250727
Tagged selenium/node-chrome:102.0.5005.115-chromedriver-102.0.5005.61-20250727
Tagged selenium/standalone-chrome:102.0.5005.115-chromedriver-102.0.5005.61-20250727
Tagged selenium/node-chrome:102.0.5005.115-20250727
Tagged selenium/standalone-chrome:102.0.5005.115-20250727
Tagged selenium/node-chrome:102.0-chromedriver-102.0-grid-4.34.0-20250727
Tagged selenium/standalone-chrome:102.0-chromedriver-102.0-grid-4.34.0-20250727
Tagged selenium/node-chrome:102.0-chromedriver-102.0-20250727
Tagged selenium/standalone-chrome:102.0-chromedriver-102.0-20250727
Tagged selenium/node-chrome:102.0-20250727
Tagged selenium/standalone-chrome:102.0-20250727

这段日志看似只是"打了一串标签",实则完整承载了本仓库浏览器镜像发布的核心信息:Selenium Grid 版本与构建日期(4.34.0-20250727)、浏览器版本(102.0.5005.115)、ChromeDriver 版本(102.0.5005.61),以及两者各自的短版本号(102.0)。这些版本信息不是手动填写的,而是脚本在运行时从已构建的镜像里实时探测出来的,这正是下文要展开的源码细节。

命令解读:tag_and_push_browser_images.sh 的参数体系

日志第一行是本次发布动作的完整命令,对应仓库根目录下的 tag_and_push_browser_images.sh。该脚本通过 7 个位置参数控制整个打标流程(见脚本 L1-L9):

参数位 示例值 含义
$1 VERSION 4.34.0 Selenium Grid 版本号
$2 BUILD_DATE 20250727 镜像构建日期(YYYYMMDD)
$3 NAMESPACE selenium 镜像命名空间(即 Docker Hub 组织名)
$4 PUSH_IMAGE false 是否执行 docker push,true 则打标后推送
$5 BROWSER chrome 目标浏览器,可选 chrome、chromium、edge、firefox、chrome-for-testing
$6 RELEASE_OLD_VERSION (未传,默认 false) 是否为旧版本补发"无日期"的短标签
$7 PLATFORM (未传,默认 linux/amd64) 探测版本时使用的容器平台

脚本内部用 TAG_VERSION=${VERSION}-${BUILD_DATE} 拼接出 Grid 版本标识,即日志中的 4.34.0-20250727(L15)。false 的第四个参数说明这是一次"只打标、不推送"的本地操作——retag() 函数中只有 PUSH_IMAGE=true 才会追加执行 docker push(L48-L50),这意味着 changelog 记录的是发布流水线中"先打标验证、后统一推送"的一个环节。

值得注意的是脚本还预留了 PROMOTE_TAGS 与 PROMOTE_GHCR_NAMESPACE 两个环境变量(L10-L13),用于"发布时直接复用 CI 测试过的镜像清单而非重新构建"的场景:此时 docker tag 无法跨架构表达,脚本改用 docker buildx imagetools create 在镜像索引(index)层面完成 registry 到 registry 的复制(L36-L43)。从源码结构看,这是为了避免 docker pull 只拉回单架构镜像、导致发布标签变成单架构的问题。

日志逐行拆解:版本探测与标签的产生

实时探测浏览器与驱动版本

日志中间四行(Chrome version、Short Chrome version、ChromeDriver version、Short ChromeDriver version)来自脚本的 chrome 分支(L64-L73)。脚本不依赖任何外部版本清单,而是直接以 TAG_VERSION 标签运行已构建的 node 镜像,读取容器内二进制自报的版本:

  • docker run --platform linux/amd64 --rm selenium/node-chrome:4.34.0-20250727 google-chrome --version | awk '{print $3}':google-chrome --version 的输出形如 Google Chrome 102.0.5005.115,awk '{print $3}' 取出第 3 列得到 102.0.5005.115;
  • 同理,chromedriver --version 输出形如 ChromeDriver 102.0.5005.61 (xxxxx),awk '{print $2}' 得到 102.0.5005.61。

短版本由 short_version() 函数生成(L53-L57):按 . 分割取前两段,把 102.0.5005.115 压缩为 102.0。这种"从容器内探测"的方式保证标签上的版本号与镜像内实际二进制严格一致,避免了版本清单与镜像内容脱节。

十类标签的命名规则

脚本为每个浏览器维护一个标签数组,chrome 分支的定义在 L75-L99。先定义 6 个基础标签(组合了完整/短版本、驱动版本、构建日期、Grid 版本四要素),再在 RELEASE_OLD_VERSION=false(默认)时追加 4 个"无日期、更精简"的标签:

序号 标签(以日志输出为例,省略 selenium/ 前缀) 组成要素 典型用途
1 node-chrome:102.0.5005.115-chromedriver-102.0.5005.61-grid-4.34.0-20250727 完整 Chrome 版本 + 完整驱动版本 + 完整 Grid 版本 精确复现某次发布:浏览器、驱动、Grid 三者全部钉死
2 node-chrome:102.0.5005.115-chromedriver-102.0.5005.61-20250727 完整浏览器版本 + 完整驱动版本 + 构建日期 按构建日追溯某个快照
3 node-chrome:102.0.5005.115-20250727 完整浏览器版本 + 构建日期 按构建日锁定浏览器
4 node-chrome:102.0-chromedriver-102.0-grid-4.34.0-20250727 短浏览器版本 + 短驱动版本 + 完整 Grid 版本 日常测试中最常用的精确组合(短版本更易读)
5 node-chrome:102.0-chromedriver-102.0-20250727 短浏览器版本 + 短驱动版本 + 构建日期 短版本快照
6 node-chrome:102.0-20250727 短浏览器版本 + 构建日期 最短的可追溯标签
7 node-chrome:102.0.5005.115-chromedriver-102.0.5005.61 完整浏览器版本 + 完整驱动版本(无日期) 长期有效的精确组合
8 node-chrome:102.0.5005.115 完整浏览器版本 钉死到具体的 Chrome 补丁版本
9 node-chrome:102.0-chromedriver-102.0 短浏览器版本 + 短驱动版本(无日期) 短版本长期标签
10 node-chrome:102.0 短浏览器版本 锁定 Chrome 大版本

从脚本实现看,第 1-6 类总是生成;第 7-10 类仅在 RELEASE_OLD_VERSION=false 时追加(L88-L99),注释表明追加的动机是"浏览器版本 + 浏览器驱动版本"与"浏览器版本"两类纯版本标签——这些不绑定构建日期的标签更适合长期引用。日志末尾的 12 行 Tagged 输出正是第 1-6 类标签逐一施加到 node-chrome 与 standalone-chrome 两个镜像上的结果(每类标签循环调用 retag node-chrome 与 retag standalone-chrome,见 L101-L104);按脚本逻辑,RELEASE_OLD_VERSION=false 时还会继续追加第 7-10 类的输出,日志展示的是发布过程中记录下来的这一批次。

每个镜像家族的标签行为一致

chrome 分支的处理模式同样适用于 chromium(L107-L149)、edge(L151-L193)、firefox(L195-L236)与 chrome-for-testing(L238-L280),差异仅在于探测版本时调用的二进制与解析字段(如 Edge 用 microsoft-edge --version 取第 3 列、msedgedriver --version 取第 4 列,Firefox 用 firefox --version 与 geckodriver --version)。因此本文对 Chrome 102 的拆解,可以直接平移理解仓库中全部浏览器镜像的标签体系。

源码视角:Chrome 102 与 legacy ChromeDriver 来源

Chrome 102 在本仓库的镜像构建中有一个特殊身份:它早于 Chrome 115 这条分水岭。在 NodeChrome/install-chromedriver.sh 的头部注释(L11-L18)与实现(L44-L47)中明确指出:115 之前的 Chrome 版本早于 Chrome for Testing(CfT)项目,ChromeDriver 只能由已冻结的 chromedriver.storage.googleapis.com API 提供(且该 API 只有 linux64 架构产物)。因此当探测到 Chrome 主版本号小于 115 时,安装脚本会直接走 legacy 来源路径,读取 LATEST_RELEASE_102 获取与 Chrome 102 匹配的驱动版本,这正是日志中 ChromeDriver 版本 102.0.5005.61 的来源(L62-L66)。

与之呼应,NodeChrome/install-chrome.sh 支持两种安装方式:从 apt 仓库安装 google-chrome-stable(稳定/测试/开发通道),或按 google-chrome-stable=<完整版本号> 的格式安装指定版本(L27-L40)。版本特定的安装方式让构建流水线能够把镜像内的 Chrome 精确钉在 102.0.5005.115,从而保证 tag_and_push_browser_images.sh 探测到的版本号与标签严格对应。从源码结构可以推断:像 Chrome 102 这类不再随大流升级的旧版本镜像之所以能持续发布,正是依赖"安装脚本支持指定版本 + 打标脚本从容器内实测版本"这一整套可追溯机制。

如何在自己的测试中消费这些标签

通过版本矩阵定位可用镜像

仓库根目录的 CHANGELOG/README.md 维护了一张"Grid 版本 × 浏览器版本"矩阵:每一行是一个 Grid 版本,每一列是一个浏览器大版本,打勾项即表示该组合的镜像已发布,并链接到对应的详细 changelog(即本文这类日志文档)。矩阵中 Chrome 102 列从 4.28.1 一直覆盖到当前最新 Grid 版本,例如 CHANGELOG/4.48.0/chrome_102.md 记录了 Chrome 102 在 Grid 4.48.0 下的打标日志。README 同时给出了一条重要提醒:并非每个 Grid 与浏览器版本的组合都经过完整功能测试,使用者需要根据自己的测试要求自行评估组合的可用性(见 CHANGELOG/README.md 第 9 行)。

拉取镜像与编写测试

定位到合适的标签后,直接按标签拉取即可,例如:

# 锁定 Chrome 大版本(Node 模式,接入 Selenium Grid)
docker pull selenium/node-chrome:102.0

# 锁定完整浏览器与驱动版本,最精确
docker pull selenium/node-chrome:102.0.5005.115-chromedriver-102.0.5005.61

# Standalone 模式:单容器内同时跑 Grid 与浏览器
docker pull selenium/standalone-chrome:102.0.5005.115

在测试代码中,可以用 Selenium 客户端的 browserVersion 能力与标签对齐,例如请求 102.0 或 102.0.5005.115 的 Chrome 会话;当多个 Chrome 版本并存于同一个 Grid 时,版本号成为 Distributor 调度会话的关键匹配依据。Node 镜像适合在完整 Selenium Grid(Hub/Router + Distributor + Node)架构中承担会话执行角色,Standalone 镜像则适合单机快速验证——两种镜像的标签始终成对发布,这在日志中清晰可见。

归档与当前版本

4.34.0 属于已归档的历史 Grid 版本,其 changelog 存放于 CHANGELOG/archived/ 目录;仍在维护的版本则位于 CHANGELOG/ 根下。若你的测试需要长期锁定 Chrome 102 这样的旧浏览器(例如复现仅在特定版本出现的问题),建议优先选择仍在矩阵最新行中提供 Chrome 102 列的 Grid 版本,以便在获得新 Grid 功能的同时钉住浏览器版本;若需深入了解镜像内 Chrome 的安装细节,可继续阅读 NodeChrome/Dockerfile 与 NodeChrome/install-chrome.sh。

相关仓库资源索引

登录后查看全文
docker-selenium