CSE/ServiceComb 版本号规则

最新推荐文章于 2023-04-01 22:13:10 发布

原创最新推荐文章于 2023-04-01 22:13:10 发布 · 1.1k 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#cse #servicecomb

技术剖析专栏收录该内容

82 篇文章

订阅专栏

本文详细介绍了CSEJAVASDK中版本号的定义规则，推荐使用x.y.z或a.b.c.d的形式，其中各部分为不超过两个字节的整数。版本号用于表达接口兼容性，支持多版本并存及自动请求转发，解决灰度版本问题。

CSE JAVA SDK使用service_description.version定义版本号，目前推荐支持如下规则：

x.y.z

或者

a.b.c.d

其中x/y/z/a/b/c/d都是一个int值（short），不能超过2个字节（注意不是4个字节）的数字大小。

关于版本规则的特殊说明

CSE JAVA SDK的版本号必须采用数字，而不能使用字符等特殊字符。因为这个版本号，不是传统意义上的版本管理的概念，用于表达一些版本逻辑，比如主要、次要、补丁等。 CSE的版本号主要用于表达“接口兼容”性概念，版本号变化表示可能存在接口变更。在处理路由规则的时候，会基于契约和版本号进行分组，将兼容的接口分为一组，从而实现多版本并存和自动基于接口兼容性进行请求转发。这个特性是CSE JAVA SDK非常独特的特性，优雅的解决了灰度版本并存的问题，而不需要用户做任何额外的开发。

关于接口兼容性的一些推荐实践参考：https://huaweicse.github.io/cse-java-chassis-doc/question-and-answer/interface-compatibility.html