目录 (7)
【博客介绍】零停机部署中的数据库、后端、前端和应用程序兼容性
在上一篇文章中,我通过交替运行blue和green容器消除了后端部署期间的 502 错误。
然而,随着我后续添加和修改功能,一旦不同版本短暂共存,这个问题就出现了。本博客的数据库、后端(GCP 蓝绿部署)、Web 前端和移动应用是分阶段部署的。
如何防止仍在运行的
blue在green更改数据库模式时发生故障?前端和后端部署时间并不完全一致。当较旧的前端遇到新的后端(或反之亦然)时会发生什么情况?
如果一个使用旧版应用程序但尚未更新 App Store 的用户进入新发布的网页版界面会发生什么情况?
在这篇文章中,我计划总结一下通过代码保证了多少兼容性,以及各个部分是如何按照部署顺序发布的。
1. 共享数据库 ↔ 蓝绿后端:扩展与收缩
Flyway 与后端连接以实现模式版本控制,因此当新容器( green )启动时,迁移会自动运行。问题在于,即使只有一个数据库,它也会在green甚至还没接收到流量之前就切换数据库。
sequenceDiagram
autonumber
participant User as "Visitor"
participant Caddy as "Caddy"
participant Blue as "Blue (Old)"
participant Green as "Green (New)"
participant DB as "Cloud SQL (Shared)"
1. 部署前的正常周期
User->>Caddy: 实时请求
Caddy->>Blue: 请求转发
Blue->>DB: 按照现有方式阅读/写
DB-->>Blue: 返回结果
Blue-->>Caddy: 返回响应
Caddy-->>User: 响应完成
%% 2. 启动绿色并更改数据库架构
Green->>DB: 在启动时运行迁移 (DB 改变)
3. 过渡周期(蓝色手柄直至完成)
关于 Blue 数据库的说明:当 Green 等待健康检查(约 25 秒,如果失败则永久失效)时,Blue 必须继续在已更改的数据库上运行。
User->>Caddy: 实时请求 (转换前)
Caddy->>Blue: 请求转发
Blue->>DB: 执行现有查询 (向后兼容性至关重要!)
DB-->>Blue: 返回正常结果
Blue-->>Caddy: 返回响应
Caddy-->>User: 响应完成 (Blue处理到最后)
4. 健康检查通行证和交通转换
Green-->>Caddy: Healthcheck 200
注意:Caddy,Green 的路由目标切换(蓝 ➔ 绿)
%% 5. 过渡后的新请求周期(由 Green 处理)
User->>Caddy: 新的实时请求 (转换后)
Caddy->>Green: 请求转发
Green->>DB: 执行新查询
DB-->>Green: 返回结果
Green-->>Caddy: 返回响应
Caddy-->>User: 响应完成
6. 旧版本的终止
Caddy--xBlue: 结尾在蓝绿部署过程中,共享数据库首次发生变化的部分。
在green通过健康检查之前(如果green启动失败且部署被取消,则继续执行), blue必须使用现有方法读取和堆叠已更改数据库上的数据。
因此,在更改数据库结构时,我们不会一次性进行全面改造,而是将部署分成扩展和收缩两个阶段。我们的原则是,在现有服务器完全关闭之前,不会删除或重命名旧的数据库模式。
flowchart LR
S1["1. 扩展(添加新架构)"] --> S2["2. 双写和回填"]
S2 --> S3["3. 切换(彻底终止旧版本)"]
S3 --> S4["4. 合约(在下次部署中清理旧模式)"]扩展与收缩零停机时间方案转换
示例:将帖子表格转换为多语言表格(展开 + 双语写入)
最初,文章标题、正文和摘要都位于article_mst中,但为了支持四种语言,我们不得不将它们移至article_translation表中。如果我们直接删除现有列并移动数据, blue查询会在部署后立即失效,并且无法回滚。
为了保证兼容性,我执行了两项处理。
扩展 + 回填 (
V2) :article_mst的现有列保持不变,仅创建了article_translation,并将现有的韩文文本幂等回填到ON CONFLICT DO NOTHING中。双写(
ArticleService) :新服务器(green)在编写、编辑或发布帖子时同时写入article_mst和article_translation(ko)。
// 当新服务器(绿色)启动时,它会在旧表和新表中同时记录数据。Article saved = articleRepository.save(article); // 现有文章_mstarticleTranslationRepository.save(buildKoTranslation(saved, published)); // 新文章翻译因此,在过渡期间, blue可以继续以现有方式运行,而无需了解新表的任何信息。即使green中出现错误并回滚到blue ,期间写入的帖子仍保留在article_mst中,从而允许您在不丢失数据的情况下回滚。您只需在前端过渡完全完成后,在下次部署时清理(收缩)旧列即可。
2. 后端 ↔ Web 前端:向后兼容性 + 部署顺序 + 关键回退机制
由于后端和前端部署在不同的代码仓库和流水线中,它们并非同时部署。因此,存在两个潜在问题。
旧版前端 -> 新版后端参考
新前端 -> 旧后端参考
因此,我们制定了一项策略来防止每个问题的发生。
始终确保后端向后兼容旧版前端。
所有多语言
?lang=参数都变为required = false(如果未发送,则响应仍为ko)。保留响应 DTO 的现有字段,仅添加新字段
推送通知、类别名称更改和翻译管理都已分离到一个新的端点中。
由于为所有新 API 实现双向回退成本很高,因此基本原则是先进行后端部署 → 后进行前端部署。
我认为以上两种策略最不容易使代码复杂化。当然,由于这是一个几乎没有用户的博客服务,所以安排一个短暂的维护期来处理实际上是最简洁的方法!我甚至不指望这些方法能始终保持 100% 不间断运行。但是,我决定尝试一下,因为作为个人博客,我可以安心地进行维护。
3. 代码分发与功能开放性的分离:默认关闭此功能标志
对于需要外部 API 密钥或新基础设施的功能,我们将代码部署时间和功能启用时间完全分开。
如果开关设置为默认值false ,则可以先安全地部署架构和代码。然后,在前端和后端都安全部署后,再启用该功能。
4. Web前端↔移动应用:处理最长间隔
我了解到,后端和前端网页的部署时间差异最多只有几分钟,但移动应用由于应用商店审核和用户更新延迟,新旧版本可能会共存数周。(我也经历过应用长时间未更新的情况……)
我设想的这个问题是这样的:当附加推送通知时,WebView 应用需要一个桥接器来从原生源接收 FCM 令牌并将其传递给 Web,但未更新的旧版本应用缺少该桥接器。
WebView 在页面加载前会插入window.__carrotAppPush = {version: 1, platform}对象。Web 检测到此对象后,会向应用推送桥请求令牌。
window.ReactNativeWebView存在,但window.__carrotAppPush不存在。Web 检测到此状态后,会安全地跳转到“需要应用更新”通知页面,而不是显示错误信息。
因此,我没有使用应用程序,而是通过在网页窗口中注册的变量来解决这个问题。我通过一个方法触发更新,该方法让网页检查它是否已通过应用程序的 WebView 加载。
摘要:四级兼容性标准
边界 | 共存时间 | 解决方案 |
|---|---|---|
数据库↔蓝绿后端 | 约25秒(失败后永久失效) | 扩展和收缩、双写、 |
后端↔Web前端 | 几分钟 | 后端向后兼容性(保留可选参数和现有字段)+后端预分发 |
代码分发 ↔ 功能开放 | 直到设置完成 | 使用默认功能标志 |
Web前端↔移动应用 | 几天到几周或更长时间 | 基于 |
如果说上一篇文章介绍了 Caddy 蓝绿架构如何通过流量切换实现零停机部署,那么这次我将解释如何实现零停机部署,以确保数据库、后端、前端和应用程序即使部署在不同的服务中也不会中断。零停机部署的目标是确保现有服务无缝运行,但实际上,如果版本之间缺乏一致性,中断在所难免,对吧?
这次,我第一次采用分层的方式进行代码划分,以确保即使版本更新也能保持兼容性。这让我对编写代码时如何考虑兼容性有了更深刻的理解。
