当前位置：首页 > 科技 > 软件

微服务的版本号要怎么设计？你知道吗？

来源：责编：时间：2024-07-09 07:01:21 687观看

导读今天我们来聊一下微服务项目中的版本号要怎么设计。小伙伴们平时看到的项目版本号，基本上都是分为了三部分 X.Y.Z，版本升级的时候版本号都会变，那么版本号怎么变，这可不是拍脑门决定的，今天我们就一起来探讨一下这个话题。

今天我们来聊一下微服务项目中的版本号要怎么设计。

小伙伴们平时看到的项目版本号，基本上都是分为了三部分 X.Y.Z，版本升级的时候版本号都会变，那么版本号怎么变，这可不是拍脑门决定的，今天我们就一起来探讨一下这个话题。

一、语义化版本控制规范

版本号该如何控制？其实是有一个标准规范的，规范地址：

https://semver.org/lang/zh-CN/

这个规范非常友好的提供了中文版的内容。

语义化的版本控制规范要求版本号由三部分构成：

MAJOR（X）：这个是主版本号，一般是涉及到不兼容的 API 更改时，这个会变化。
MINOR（Y）：这个是次版本号，当我们对 API 进行向后兼容的增强时，这个版本号会变化，换句话说，也就是有新增的功能时，这里会变化。
PATCH（Z）：这个是修订号，当我们进行一些 BUG 的修复，然后要发版的时候，这里会发生变化。

语义化的版本控制规范主要做了如下一些要求：

使用语义化版本控制的软件必须（MUST）定义公共 API。该 API 可以在代码中被定义或出现于严谨的文档内。无论何种形式都应该力求精确且完整。
标准的版本号必须（MUST）采用 X.Y.Z 的格式，其中 X、Y 和 Z 为非负的整数，且禁止（MUST NOT）在数字前方补零。X 是主版本号、Y 是次版本号、而 Z 为修订号。每个元素必须（MUST）以数值来递增。例如：1.9.1 -> 1.10.0 -> 1.11.0。
标记版本号的软件发行后，禁止（MUST NOT）改变该版本软件的内容。任何修改都必须（MUST）以新版本发行。有的小伙伴可能会说我们的项目处于快速开发阶段，API 不稳定，天天变，要是按照这个要求来得发多少个版本才够用呀！其实，一般 API 快速变化主要有两种情况，一种是项目刚立项的时候，此时主版本号为 0，那么这个时候的 API 就不能算是稳定的 API；另外一种情况则是下个主版本处于快速开发中，但是这种情况一般会有一个新的分支用来管理下个版本的代码，所以和这里的要求实际上并不冲突（具体参见第 4、5 条）。
主版本号为零（0.y.z）的软件处于开发初始阶段，一切都可能随时被改变。这样的公共 API 不应该被视为稳定版。
1.0.0 的版本号用于界定公共 API 的形成。这一版本之后所有的版本号更新都基于公共 API 及其修改内容。那么有的小伙伴可能会纠结什么时候版本号从 0.Y.Z 变为 1.Y.Z 呢？一般来说，当你的项目已经上了生产环境或者说有稳定的 API 提供给别人使用的时候，基本上就可以算是 1.Y.Z 了。
修订号 Z（x.y.Z | x > 0）必须（MUST）在只做了向下兼容的修正时才递增。这里的修正指的是针对不正确结果而进行的内部修改。
次版本号 Y（x.Y.z | x > 0）必须（MUST）在有向下兼容的新功能出现时递增。在任何公共 API 的功能被标记为弃用时也必须（MUST）递增。也可以（MAY）在内部程序有大量新功能或改进被加入时递增，其中可以（MAY）包括修订级别的改变。每当次版本号递增时，修订号必须（MUST）归零。
主版本号 X（X.y.z | X > 0）必须（MUST）在有任何不兼容的修改被加入公共 API 时递增。其中可以（MAY）包括次版本号及修订级别的改变。每当主版本号递增时，次版本号和修订号必须（MUST）归零。
先行版本号可以（MAY）被标注在修订版之后，先加上一个连接号再加上一连串以句点分隔的标识符来修饰。标识符必须（MUST）由 ASCII 字母数字和连接号 [0-9A-Za-z-] 组成，且禁止（MUST NOT）留白。数字型的标识符禁止（MUST NOT）在前方补零。先行版的优先级低于相关联的标准版本。被标上先行版本号则表示这个版本并非稳定而且可能无法满足预期的兼容性需求。范例：1.0.0-alpha、1.0.0-alpha.1、1.0.0-0.3.7、1.0.0-x.7.z.92。
版本编译信息可以（MAY）被标注在修订版或先行版本号之后，先加上一个加号再加上一连串以句点分隔的标识符来修饰。标识符必须（MUST）由 ASCII 字母数字和连接号 [0-9A-Za-z-] 组成，且禁止（MUST NOT）留白。当判断版本的优先层级时，版本编译信息可（SHOULD）被忽略。因此当两个版本只有在版本编译信息有差别时，属于相同的优先层级。范例：1.0.0-alpha+001、1.0.0+20130313144700、1.0.0-beta+exp.sha.5114f85。
版本的优先层级指的是不同版本在排序时如何比较。

只有数字的标识符以数值高低比较。
有字母或连接号时则逐字以 ASCII 的排序来比较。
数字的标识符比非数字的标识符优先层级低。
若开头的标识符都相同时，栏位比较多的先行版本号优先层级比较高。例如：1.0.0-alpha < 1.0.0-alpha.1 < 1.0.0-alpha.beta < 1.0.0-beta < 1.0.0-beta.2 < 1.0.0-beta.11 < 1.0.0-rc.1 < 1.0.0。
判断优先层级时，必须（MUST）把版本依序拆分为主版本号、次版本号、修订号及先行版本号后进行比较（版本编译信息不在这份比较的列表中）。
由左到右依序比较每个标识符，第一个差异值用来决定优先层级：主版本号、次版本号及修订号以数值比较。例如：1.0.0 < 2.0.0 < 2.1.0 < 2.1.1。
当主版本号、次版本号及修订号都相同时，改以优先层级比较低的先行版本号决定。例如：1.0.0-alpha < 1.0.0。
有相同主版本号、次版本号及修订号的两个先行版本号，其优先层级必须（MUST）透过由左到右的每个被句点分隔的标识符来比较，直到找到一个差异值后决定：

二、微服务中的版本号

那么在微服务中，我们的版本号该怎么设计呢？

首先，整体上的思路，就是按照上文所说的语义化版本控制规范来。

其次，上面虽然给出了很多条条框框，然而我们实际开发中，一般只需要从以下几个方面简单考虑即可，每次发版的时候都去翻这个规范显然也不现实：

理想情况下，我们应该只进行向后兼容的更新。

我们要为项目添加新功能、新特性，我们必须要考虑到项目的兼容性。例如接口中新加了一个参数，那么为了老版本的客户端能够顺利访问这个接口，服务端应该考虑为老版本客户端缺少的请求参数提供一个默认值。我们也可能为响应添加新的属性，或者提供了一些新的接口，当然这些一般都不影响老客户端。

必须进行不兼容的升级。

有时候我们必须进行一些不兼容的升级，对 API 做一些主要的修改，考虑到微服务之间的松耦合性，我们没法强迫客户端进行立马升级，此时可能会考虑在某一个时间段内，两个版本的 API 共存。

多个 API 共存的时候，一个比较简单的办法是在 API 设计的时候，加上版本号，例如 /v1/xxx 或者 /v2/xxx，不过这种写法有一个小小的缺陷，就是路径中加了版本号之后，这个路径看起来就不是一个完美的 REST 路径了。

所以这块还有一个方案，就是把请求的 API 的版本号写到请求头中。

具体的实现思路是这样：

首先，在微服务中，我们所有的请求一般来说都会经过网关，我们可以在网关中提取出请求头的 Accept 参数，然后根据 Accept 中的请求版本号，做不同的请求转发，如果版本号是 1.0，就转发到 1.0 的服务上去；如果版本号是 2.0，则转发到 2.0 的服务上去。基本上就是这个样子。

以现在微服务中主流的网关 Spring Cloud Gateway 为例，我们可以做如下配置：

spring:  application:    name: gateway  cloud:    nacos:      discovery:        password: nacos        username: nacos        server-addr: a.b.c.d:8848        namespace: public    gateway:      discovery:        locator:#          enabled: true          lower-case-service-id: true      routes:        - id: v1_provider          uri: lb://provider          predicates:            - Path=/p/**            - Header=Accept,.*;?version=1/.0(|;.*)          filters:            - StripPrefix=1server:  port: 8082

大家看一下这个配置：

首先记得关闭服务自动发现，否则通过默认的服务名进行代理就不会经过我们配置的过滤器了。
然后我们手动配置服务转发，上面的配置基本上都是常规配置，跟版本号相关的配置是 Header=Accept,.*;?version=1/.0(|;.*)，这个配置就是对请求头提出要求，首先前面的 Accept 表示这里是要判断请求头中的 Accept 字段，然后后面紧跟着的是 value（两者之间用 , 隔开），这个 value 是一个正则表达式 .*;?version=1/.0(|;.*)，意思就是在 version=1.0 之前和之后可以有任意字符串，只要 value 中包含 version=1.0 就算匹配上了。只有匹配上了，才会进行请求转发，否则不会进行请求转发。
最后，我们在发送请求的时候，设置如下请求头即可：

图片

如果版本号是 versinotallow=2.0，则会报一个 404 错误：

图片

好啦，一个小小的版本号话题，感兴趣的小伙伴可以试试最后这段代码哦！

本文链接：http://www.28at.com/showinfo-26-99641-0.html微服务的版本号要怎么设计？你知道吗？

声明：本网页内容旨在传播知识，若有侵权等问题请及时与本网联系，我们将在第一时间删除处理。邮件：2376512515@qq.com

上一篇： 2024 Vue 生态工具最能打的组合！

下一篇：三款C#开源且实用的工具类库，工作效率提升利器！

标签：

热门焦点

Redmi Pad评测：红米充满野心的一次尝试

从Note系列到K系列，从蓝牙耳机到笔记本电脑，红米不知不觉之间也已经形成了自己颇有竞争力的产品体系，在中端和次旗舰市场上甚至要比小米新机的表现来得更好，正所谓“大丈夫生居
小米降噪蓝牙耳机Necklace分享：听一首歌读懂一个故事

在今天下午的小米Civi 2新品发布会上，小米还带来了一款新的降噪蓝牙耳机Necklace，我们也在发布结束的第一时间给大家带来这款耳机的简单分享。现在大家能见到最多的蓝牙耳机
小米平板5 Pro 12.4简评：多专多能兼顾影音娱乐的大屏利器

疫情带来了网课，网课盘活了安卓平板，安卓平板市场虽然中途停滞了几年，但好的一点就是停滞的这几年行业又有了新的发展方向，例如超窄边框、高刷新率、多摄镜头组合等，这就让安卓
Redmi Buds 4开箱简评：才199还有降噪可以无脑入

在上个月举办的Redmi Note11T Pro系列新机发布会上，除了两款手机新品之外，Redmi还带来了两款TWS真无线蓝牙耳机产品，Redmi Buds 4和Redmi Buds 4 Pro，此前我们在Redmi Note11T
7月安卓手机好评榜：三星S23Ultra好评率第一

性能榜和性价比榜之后，我们来看最后的安卓手机好评榜，数据来源安兔兔评测，收集时间2023年7月1日至7月31日，仅限国内市场。第一名：三星Galaxy S23 Ultra好评率：95.71%在即将迎来新
一篇聊聊Go错误封装机制

%w 是用于错误包装（Error Wrapping）的格式化动词。它是用于 fmt.Errorf 和 fmt.Sprintf 函数中的一个特殊格式化动词，用于将一个错误（或其他可打印的值）包装在一个新的错误中。使
华为将推出盘古数字人大模型可帮助用户12小时完成数字人生成

在今日举行的2023年华为云数字文娱AI创新峰会上，华为云全球Marketing与销售服务总裁石冀琳表示，华为云将在后续推出盘古数字人大模型，可帮助用户12小
朋友圈可以修改可见范围了苹果用户可率先体验

近日，iOS用户迎来微信8.0.27正式版更新，除了可更换二维码背景外，还新增了多项实用功能。在新版微信中，朋友圈终于可以修改可见范围，简单来说就是已发布的朋友圈
联想小新Pad Pro 12.6将要推出，搭载高通骁龙 870 处理器

联想小新Pad Pro 12.6将于秋季新品会上推出，官方按照惯例直接在发布会前给出了机型的所有参数。联想小新 Pad Pro 12.6 将搭载高通骁龙 870 处理器，重量为 5