知识卡片

普通读书笔记卡 · 5231

版本化API解耦更新节奏

理解等级:中级

能隔离地修改系统的某一部分,是系统可运维的前提。二进制之间、二进制与配置之间保持松耦合。API 变更会迫使调用方重建整个系统,把 API 版本化后,调用方可以继续用自己依赖的版本,再有计划地升级,各部分的更新节奏不必一致。就像不写大杂烩类,也不该发布“util”“misc”式的二进制;数据格式同样要向前和向后兼容。发散:组件职责应能一句话说清。参见[[最小API是深刻理解问题的标志]]。

这张卡片看不懂?

已有反馈 · 0 / 10 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 1 处

    • 第9章 简单化 · 查看原书依据

      通过将API版本化,可以允许开发人员继续使用它们的系统所依赖的版本,以更安全和深思熟虑的方法升级到新的版本。这样不必要求整个系统的每一次功能增加或改进都需要全面的生产更新,整个系统中的更新节奏可以不同。

    参考来源

    - 位置:《SRE:Google运维解密》第9章《简单化》(源文件:`_epub-src/OEBPS/Text/0008_0007.xhtml`) - 结论依据:原文把面向对象的模块化原则延伸到分布式系统,说明松耦合、API 版本化、职责分离与兼容的数据格式如何同时提升灵活性与稳定性。 - 原始内容:通过将API版本化,可以允许开发人员继续使用它们的系统所依赖的版本,以更安全和深思熟虑的方法升级到新的版本。这样不必要求整个系统的每一次功能增加或改进都需要全面的生产更新,整个系统中的更新节奏可以不同。