Selenium Grid Docker 镜像标签生成与发布实战:从 Chrome 102 打标日志读懂 tag 命名规则
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。
相关仓库资源索引
- tag_and_push_browser_images.sh:标签生成与推送的核心脚本,本文所有命名规则的实现源头
- CHANGELOG/archived/4.34.0/chrome_102.md:本文主体,4.34.0 下 Chrome 102 的真实打标日志
- CHANGELOG/4.48.0/chrome_102.md:同一浏览器版本在新 Grid 版本下的打标日志对照
- CHANGELOG/README.md:Grid × 浏览器版本矩阵与使用注意事项
- NodeChrome/install-chrome.sh:Chrome 指定版本安装实现
- NodeChrome/install-chromedriver.sh:ChromeDriver 版本解析与安装,含 115 分水岭与 legacy 来源说明
- NodeChrome/Dockerfile:node-chrome 镜像的组装入口