返回知识中心
部署

浏览器发布验证:Profile、版本与回滚

通过清晰的验证和回滚流程,让浏览器版本、Profile 包与部署设置保持匹配,并为候选发布保留可复核的基线。

BotBrowser Team

浏览器发布验证:Profile、版本与回滚
文档中心

想直接进入 部署 文档吗?

这篇文章属于知识中心的指南库。若你要步骤化配置、参考说明和持续更新,请直接进入对应 docs 分区。

BotBrowser 可以用匹配的浏览器和 Profile 包重复授权的发布检查,但不能保证应用侧结果、替你选择已接受的基线,也不负责执行分阶段推广或回滚。发布负责人仍需决定哪些客户旅程通过复核。

TL;DR

  • 在候选运行前,让 Profile 包与浏览器主版本匹配。
  • 在同一台机器、Profile、路由和旅程上比较一项变化。
  • 按部署组逐步推广,并保留已接受的组合以便回滚。
  • BotBrowser 可以重复文档中的冒烟测试,但应用结果仍由操作人员负责。

Contents

把浏览器和 Profile 当作一个发布单元

浏览器更新改变的不只是可执行文件。所选 Profile 包、宿主环境、网络路由、持久状态和自动化配置,共同决定应用收到的会话。把这些输入放进同一份发布记录,让每次上线都从已知配置出发,而不是依赖记忆。

每次上线都从一个有名称的浏览器版本和为该 主版本 准备的 Profile 包开始。在这一对组合旁边记录宿主类型、网络路由类别和用户数据策略。这样,当后续变化需要复核时,操作人员有一套已知配置可以重复。

发布验证流程:已接受的组合与候选组合在相同旅程上比较,按部署组逐步推广,旅程发生变化时先恢复已接受的组合

发布记录不是工作完成后补的文书,而是让已接受的浏览器会话可以复现的一小组事实。团队可以用它在替换的机器上启动同一个 Profile,把即将发布的版本与当前版本比较,或把支持案例交给另一位操作人员,而不必依赖记忆。

Profile 和浏览器版本的变化节奏不同。浏览器版本线可以收到维护更新,而 Profile 包仍然对原有 主版本 保持已批准状态。Profile 包也可能在浏览器二进制不变时更新。把其中任何一种情况都当作候选变化。只有重新复核相关客户旅程之后,这一对组合才重新被视为已接受。如何把自动化固定在某个浏览器版本并有计划地更新,可参阅浏览器自动化版本固定与更新。

版本匹配是这份记录的第一条规则。Profile 包是为某一个浏览器 主版本 准备的,Profile 管理文档说明二进制与 Profile 必须来自同一个 主版本线。候选版本跨越 主版本 时,先在第一次运行前选好对应的包,并把结果当作新的发布组合。标签或可见设置不能替代匹配的包和新的验证记录。在验证窗口开始前,阅读候选版本对应的公开 Chrome 发布说明,让复核人员知道会有哪些用户可见变化。Profile 管理指南介绍了 Profile 包的组织方式。

明确已接受的基线及其负责人

把已接受的组合记录为 browser_major、profile_family、host_class、route_id 和 state_policy,每个字段都必须能在发布前复核。

考虑新版本之前,先确定当前正在使用的基线。基线应写明 browserVersion、Profile 家族、宿主环境、网络分配和持久状态策略,还要标明使用它的部署组;同时记录 profileSha256,这样换包时可以区分版本变化和内容变化。

记录不需要描述每一项浏览器偏好,只需要覆盖会实质改变用户会话的输入。运营区域化流程的团队可以记录已批准的路由类别和区域策略。使用移动端 Profile 的团队可以记录设备类别和输入方式。用于文档工作的浏览器可以记录存储策略和预期的文档旅程。

让基线靠近部署。发布说明、变更记录或受控的配置清单都可以承担这个作用。关键是操作人员在尝试升级之前能找到已接受的组合。只存在于旧聊天消息里的基线,在紧急恢复时很难使用。

稳定的名称很有帮助。在验证、预发布、支持和生产记录中,对同一个 Profile 家族使用同一个名称。如果团队有意在不同环境使用不同的包,要在记录里写明这个差异。清晰的名称能避免把某个环境选用的 Profile 误认为另一环境中相似的包。

每一个正在使用的发布组合都应有负责人。负责人不需要操作每个会话,但要知道哪个 Profile 家族、哪个浏览器版本和哪个部署组是一起被接受的。这会让日常维护和事件响应快得多。

负责人还应知道谁可以批准 Profile 变更、浏览器升级和网络策略变更。这些决定往往由不同的人做出。一份简短的负责人记录,可以避免操作人员做了必要的基础设施变更,而另一个团队仍以为浏览器基线没有变化。

在日常维护中复核负责人。当旧的 Profile 包、发布记录和路由分配不再支撑任何活跃流程时,将它们退役。保留少量当前有效的组合,比维护一个没人能验证或恢复的庞大组合档案更容易。

在真实旅程上一次验证一项候选变化

为每条旅程保存启动参数,包括 --bot-profile、--proxy-server 和浏览器主版本,再把候选与已接受组合比较。

为检查分配 journey_id,记录 status=200 等预期结果和 timeout=60s 上限,以便区分浏览器回归与测试工具超时。

先把候选浏览器版本放进受控的部署组。除非变化本身要求新的取值,否则保持 Profile 家族、宿主类型、网络分配和自动化流程不变;把 --bot-profile、--proxy-server 和 --user-data-dir 记录在同一份运行记录中,并为每次旅程设置 timeout=30000。当比较只回答一个问题,也就是候选组合是否仍能支撑预期工作时,它才最有用。

避免把浏览器升级、代理迁移、Profile 替换和新的应用流程放在一起。几项变化可能都合理,但合并后的结果无法说明是哪一项影响了会话。把它们拆成可以逐项复核的步骤。出现意外结果时,可能原因越少,发布流程就越短。

持久状态需要同样的谨慎。回访用户的流程可能确实依赖 cookie、应用存储或已保存的偏好。全新会话的流程则可能每次运行都需要一个新目录。在候选启动前选定状态策略,并对已接受的基线和候选应用同一套策略;例如固定 storageState 和 user-data-dir,再比较相同的 HTTP 200 结果。把全新的候选与长期使用的基线放在一起比较,会把正常的应用状态变成具有误导性的发布差异。缓存的应用代码是这类状态差异的来源之一,Service Worker 更新与客户端一致性介绍了 service worker 更新如何影响客户端。

同样的原则也适用于浏览器模式。如果部署通常使用可见的浏览器窗口,就以这种方式评估候选。如果它运行在受控的无界面环境,就保持相应的宿主和显示配置。无界面与有界面一致性指南更详细地讨论了这种比较。当运行环境始终是有意保持的,发布比较最有说服力。

保存每次运行所用的启动参数。在不同机器上、或使用不同选项的两次运行,不是公平的比较,而且结果出现差异时,缺失的参数很容易被忽略。当候选需要额外选项时,每次只加一个,并在每次改动后检查结果,这样新出现的差异只会指向一个原因。

网络分配常被当作基础设施细节。它仍然会通过区域、语言、访问策略和可用内容改变应用体验。记录与 Profile 包和候选部署组对应的路由类别。固定路由的流程可以是一个已批准的代理分配。区域化部署可以是带名称的路由类别,加上匹配的区域策略。记录应足够具体,能够恢复已接受的路由,但不应包含凭据或访问目标历史。

尽可能把网络变化与浏览器变化分开复核。如果候选在版本和路由同时变更后出现故障,先回到已接受的发布单元。原有旅程恢复后,再引入下一项候选变化。这样既保护基线,也让恢复工作易于理解。

发布验证应聚焦客户或操作人员实际执行的工作。产品首页可以确认浏览器能启动并连上互联网,但很少覆盖对生产流程重要的状态、权限、导航或媒体行为。

从少量有代表性的旅程开始。处理账户事务的服务可以包含登录、回访会话、资料编辑和正常退出。内容类流程可以包含导航、搜索、文档预览和文件下载。面向移动端的流程可以包含可编辑表单、键盘交互和确认页面。移动端 Profile 质量复核列出了适用于最后这种情况的检查项。合适的组合取决于所支撑的工作,而不是一份固定的通用清单。

选择一个很可能暴露有意义差异的旅程。它可以是一个很长的页面、一个依赖已保存状态的表单、一个带区域内容的应用,或一个持续活跃数分钟的任务。这样的旅程能让候选有真实的机会证明,浏览器、Profile 和部署设置仍然协同工作。

让确认保持简单。记录旅程是否到达预期的用户可见状态,浏览器会话是否保持可用,以及结果是否与已接受的基线一致。操作人员不需要保留页面内容或大范围的浏览器日志来做这个决定。简洁的结果更容易复核,也尊重浏览会话的隐私边界。

事先决定怎样算通过。在候选运行之前,写下每条旅程预期的用户可见结果,以及由谁来判断。事后再定,容易把含糊的差异当作可以接受。一条简短的通过标准,例如旅程能够完成、会话保持可用、结果与基线一致,可以让不同操作人员之间、不同版本之间的复核保持一致。当出现标准没有覆盖的差异时,把它当作需要解决的发现,而不是可以忽略的事。

Profile 分配对隔离的浏览器上下文同样重要。在上下文开始正常工作之前,为每个上下文分配其流程所需的 Profile 和网络策略。为另一条客户旅程创建的上下文,不应仅仅因为进程里已有其他会话,就意外继承不同的运行策略。当上下文模型属于部署决策的一部分时,要把它记录下来。

分阶段推广并随时准备回滚

使用 group=1、workers=两个 和 rollback_window=24h 等可见限制,让暂停和回滚决定可以核验。

从一个接近生产环境的小组开始。这个组可以是少量工作站、有限的浏览器工作实例池,或单个区域部署;例如先让 5% 的实例运行 30 分钟,再检查任务完成率、HTTP 200 和回滚路径。用候选组合运行选定的旅程,再把结果与已接受的基线比较。

按部署组推广,而不是一次切换所有会话。分阶段推广让支持和运维团队在客户可见结果发生变化时有一个明确的暂停点,也让已接受的组合在候选仍处于观察期时保持可用。

指定谁可以暂停推广。在分阶段推广期间,支持或运维团队有时会比发布负责人更早看到客户可见的变化。事先约定任一团队都可以暂停下一个组,而恢复推广需要负责人确认已接受的组合仍然可用。被允许的暂停成本很低;如果大家等待许可,而候选继续进入新的组,成本就很高。

观察期应与工作相匹配。短的交互流程可以在一次会话中复核。长时间运行的浏览器任务可能需要保持足够长的活跃时间,以覆盖它的常规周期,正如长时间运行上下文韧性指南所述。目的不是积累大量证据,而是确认候选在推广后仍适合它要承载的流程。

候选被接受后,记录推广日期,并且只在计划的回滚窗口结束后才替换旧基线。长时间运行的浏览器会话可以在已接受的配置下完成当前工作,然后在下一个受控窗口用候选组合重新启动。这样可以避免在同一份支持记录里混入两个发布单元。

已接受的组合保持可用时,回滚会更容易。在候选复核期间,保留上一个浏览器版本、匹配的 Profile 包和部署记录。如果某个重要旅程出现意外变化,先恢复这一对组合,并开启新的浏览器会话。

首次恢复尝试时不要同时做多项修正。恢复旧浏览器的同时替换 Profile 包并更改网络路由,会产生新的、未经复核的组合。先恢复已接受的基线,确认受影响的旅程,并记录结果。之后可以把下一个候选作为单独的变化来复核。

有用的恢复记录会写明部署组、已接受的组合、客户可见的结果和采取的操作,不需要详细的页面轨迹。当发布单元的命名保持一致时,支持、隐私和运维团队可以依据一份简短记录做出清晰的决定。

有些部署可以采用部分回滚。桌面端和移动端 Profile 线可以分别推广,或者一个区域组继续使用已接受的组合,而另一个组继续候选复核。清楚记录这种拆分,包括负责人和下一次复核日期。临时的发布差异一旦没有记录,就很难管理。关于另一类 profile 家族及其一致性问题,可参阅 WebKit 家族 Profile 的跨信号一致性。

审批并长期维护发布组合

审批记录应写明 candidate_version、profile_package、deployment_group 和 rollback_owner,让审核无需打开追踪日志。

审批人应当能在不打开浏览器轨迹的情况下回答几个实际问题。候选由哪个浏览器版本和哪个 Profile 包组成?哪个部署组收到了它?复核了哪些客户旅程?如果需要回滚,哪一对已接受的组合仍然可用?将 sourceCommit、deploymentId、rollbackCommit 和负责人一起保存,才能从发布记录直接恢复这四个答案。

如果这些答案不清楚,候选就还没有准备好大范围推广。先补上缺失的负责人或配置记录。这样的延迟通常比从一次无法确认当前 Profile 包或路由分配的发布中恢复要短。

这些问题也有助于把浏览器发布决策与应用事件区分开。出现用户可见的变化时,先把当前会话与已命名的发布组合比较,再去替换设置。这样的讨论从共同的事实出发,而不是对环境的假设。

在浏览器更新、Profile 包变更、宿主镜像更新、网络策略变更或自动化的重大变更之后,复核发布组合。复核不需要重启整个部署流程。选出最可能受这项变化影响的旅程,把结果与已接受的基线比较。

对可预见的变更使用计划好的维护窗口。固定窗口让团队有时间准备候选、确认负责人,并保持已接受的组合可用。它也为长时间运行的会话提供了一个明确的节点,用经过复核的配置重新启动。

应用的意外变化仍可能发生在计划之外。出现这种情况时,在更改无关设置之前,先把当前的浏览器版本、Profile 家族、宿主类型、路由类别和状态策略与已接受的记录比较。这第一次比较往往无需扩大调查范围,就能发现配置漂移。

发布验证的价值不在于更长的清单,而在于能够说明哪一对浏览器和 Profile 支撑某个部署、这一对如何被复核,以及如何恢复。保持记录简短、候选聚焦,并让回滚路径始终可用。有名称的发布组合是一份运营承诺,在环境变化时仍然有用。

BotBrowser 文档为发布检查提供了什么

BotBrowser 的文档说明了面向发布候选的更新后验证流程:使用与二进制主版本匹配的 Profile 包,只带 --bot-profile 和 --proxy-server 做一次快速冒烟测试,然后在同一台机器、同一个 Profile 和同一个代理上比较前后结果,并保存每次运行的启动参数。这套流程给团队提供了对每个候选组合都可重复的第一轮检查。BotBrowser 不能保证发布之后应用侧的结果,不能替你选择已接受的基线,不负责执行分阶段推广或回滚,也不能替代操作人员自己对旅程的复核。

把文档中的冒烟测试当作第一道关卡,把旅程复核当作决定性的一道。干净的冒烟测试说明候选组合带着自己的 Profile 启动,并且没有出现明显的不一致。它不能说明某个具体应用会接受该会话,所以仍由有代表性的旅程来决定候选是否推广。

结论

把浏览器版本、匹配的 Profile 包、部署上下文和回滚负责人保存在同一份记录中。在代表性旅程上验证单项变化,按部署组推广,并在回滚窗口结束前保留已接受的组合。BotBrowser 让文档化冒烟测试可以重复执行,但应用结果和发布决定仍由你的团队负责。

关于让部署差异可归因的能力面顺序,先读浏览器部署与发布运维地图。

公开来源

#Release Validation#配置文件#部署#Browser Versions

本文属于指南: 浏览器部署与发布:运维决策地图

在 BotBrowser 里跑一遍同样的检查

加载 profile,让刚读到的这些信号在浏览器内部保持一致,并在正式上线前先在自己的机器上确认结果。