知识卡片
重大版本需并行供消费者迁移
破坏兼容的 API 大版本要求消费者主动改造,因此旧版在弃用期仍需运行,与新版并行一段时间。生产者应提供迁移说明并监测旧版调用,按实际消费者迁移情况决定退役时间。次版本或补丁可用渐进流量发布,但必须验证兼容性。
这张卡片看不懂?
这张卡片的反馈已满 10 条,暂时无法继续提交。
已有反馈 · 0 / 10 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 1 处
- · 查看原书依据
Major changes are the most impactful for API consumers. In order to use the new version of software, consumers must actively upgrade their software that interacts with the API. As defined in the lifecycle, this means that we need to simultaneously run a live and deprecated version of the API for a significant amount of time to allow consumers to upgrade and migrate.
参考来源
- 位置:《Mastering API Architecture》第5章《Deploying and Releasing APIs》之《Mapping Release Strategies to Lifecycle》(源文件:_epub-src/OEBPS/ch05.xhtml)
- 结论依据:原文说明大版本需要消费者主动升级、live 与 deprecated 并行;次版本和补丁可在兼容条件下做渐进发布。
- 原始内容:Major changes are the most impactful for API consumers. In order to use the new version of software, consumers must actively upgrade their software that interacts with the API. As defined in the lifecycle, this means that we need to simultaneously run a live and deprecated version of the API for a significant amount of time to allow consumers to upgrade and migrate.