微服务设计笔记(10)—— 版本管理

服务接口很难不发生改变,那我们该如何应对这种改变呢?下面是一些应对策略:

1 容错性读取

最好的策略就是不对接口进行破坏性修改。但这几乎是不可能的。客户端应该应用 Postel 法则 ( 也叫作鲁棒性原则 ) 灵活地应对服务端接口所发生的变化。鲁棒是 Robust 的音译,也就是健壮和强壮的意思。指的是系统在异常和危险情况下的生存能力。比如说,计算机软件在输入错误 、 磁盘故障 、 网络过载或有意攻击情况下,能否不死机 、 不崩溃,就是该软件的鲁棒性。客户端应该宽进严出,即对自己所发送的内容要严格,但对所接收的内容则要宽容。

假设一个邮件服务:客户端传送客户 ID 给服务端,服务端返回该客户的基本信息,响应报文如下:

<customer>
    <firstname>Sam</firstname>
    <lastname>Newman</lastname>
    <email>sam@magpiebraincom</email>
    <telephoneNumber>555- 1234 -5678</telephoneNumber>
</customer>

后来,服务端觉得这是邮件服务,因此客户的电话号码没有必要发送;而且还想把客户的相关姓名整合在一个新的节点中。重构后的响应报文如下:

<customer>
    <naming>
        <firstname>Sam</firstname>
        <lastname>Newman</lastname>
    </naming>
    <email>sam@magpiebraincom</email>
</customer>

如果客户端采用绑定技术直接绑定字段,就会发生错误,不够健壮。这里,客户端可以采用 Xpath 技术来获取想要的数据,实现是 MartinFowler 所说的容错性读取。

XPath 是 XML 路径语言( XML PathLanguage),它是一种用来确定 XML 文档中某部分位置的语言。


在请求 / 响应的应用场景, 容错性读取原则可以实现服务端改变时,最大限度地减少客户端的修改 。

2 提早发现

服务端更新了服务,客户端应该完整运行一遍之前所写的测试用例,尽早发现问题。

3 版本语义化

版本语义化指的是,客户端能够通过查看服务的版本号,就可以知道是否能够与之进行集成。版本格式为:主版本号.次版本号.修订号,版本号递增规则如下:

  1. 主版本号:修改后的 API,无法向下兼容。
  2. 次版本号:新增了功能,并可向下兼容。
  3. 修订号:修正了问题,并可向下兼容。
    先行版本号及版本编译元数据可以加到“主版本号.次版本号.修订号”的后面,作为延伸。

向下兼容(Downward Compatibility),又称作向后兼容(Backward Compatibility)。一个程序或者类库更新到较新版本之后,用旧的版本程序创建的文档或系统仍能被正常操作或使用,或在旧版本的类库的基础上开发的程序仍能正常编译运行的情况。也就是说,旧的程序仍然可在其上编译与运行。

4 接口并存

服务端对一个原接口进行了脱胎换骨的重新设计之后,但并没有修改原接口,而是实现了新接口,并且让新老接口同时存在。

通过这种方式,就可以我们尽快发布新版本的微服务。因为新老接口同时存在,客户端也有时间迁移过渡到新接口。一旦所有客户端不再使用老接口,就可以移除掉这个接口。

这其实是一种扩展 / 收缩模型,这可以让客户端从旧接口平滑过渡到新接口。首先扩展服务能力,可同时支持对新旧两种接口。等所有客户端都过渡到了新接口之后,再通过收缩服务能力,从 API 中去除旧接口。

对于使用 HTTP 作为交互模型的系统来说,我们可以在请求中添加版本信息,也可以将其添加在 URI 中,比如vl/customer/v2/customer/

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 159,015评论 4 362
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,262评论 1 292
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,727评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,986评论 0 205
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,363评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,610评论 1 219
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,871评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,582评论 0 198
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,297评论 1 242
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,551评论 2 246
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,053评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,385评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,035评论 3 236
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,079评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,841评论 0 195
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,648评论 2 274
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,550评论 2 270

推荐阅读更多精彩内容