search

alibaba / spring-cloud-alibaba

Spring Cloud Alibaba provides a one-stop solution for application development for the distributed solutions of Alibaba middleware.
https://sca.aliyun.com
Apache License 2.0
27.96k stars 8.34k forks source link

[Discuss] the package name & maven groupId & version number #761

Closed fangjian0423 closed 5 years ago

fangjian0423 commented 5 years ago

[Discuss] the package name & maven groupId & version number

Hi, everyone! now spring-cloud-alibaba have moved away from spring-cloud repository.

The official policy will be announced in the future by spring-cloud team to explain why spring-cloud-alibaba move away from spring-cloud repository.

The package name will be changed from org.springframework.cloud.alibaba to com.alibaba.cloud.

The maven groupId change from org.springframework.cloud to com.alibaba.cloud. maven artifactId will be keep, we think the fewer modification the better.

since the package name & maven groupId modification, the version number will be changed. This is the mapping table between version number modification and Spring Cloud version number.

Spring Cloud Alibaba Version before change Spring Cloud Alibaba Version after change Spring Cloud Version
0.1.x 1.0.x Spring Cloud Edgware
0.2.x 1.1.x Spring Cloud Finchley
0.9.x 1.2.x Spring Cloud Greenwich

These modifications will effect the usage of spring-cloud-alibaba, we need the suggestions about package name & maven groupId & version number from community, please reply & discuss in the issue.

[讨论] 关于包名 & maven groupId & 版本号的修改

大家好，spring-cloud-alibaba 目前已经从 spring-cloud 的 github 仓库迁移到了 alibaba 仓库下。

spring-cloud 团队会在未来发出官方的公告解释为什么 spring-cloud-alibaba 会迁移到 alibaba 仓库下。

迁移意味着修改，下面是一些改动点的说明。

包名从 org.springframework.cloud.alibaba 变成 com.alibaba.cloud。

maven groupId 从 org.springframework.cloud 变成 com.alibaba.cloud. maven artifactId 会保持原有的名字，我们认为我们改的越少，大家的改动也就越少。

由于包名和 maven groupId 进行了修改，版本号也需要进行修改，这是版本号修改前后跟 Spring Cloud 版本号的映射关系表：

Spring Cloud Alibaba 修改前的版本 Spring Cloud Alibaba 修改后的版本 Spring Cloud 版本
0.1.x 1.0.x Spring Cloud Edgware
0.2.x 1.1.x Spring Cloud Finchley
0.9.x 1.2.x Spring Cloud Greenwich

这些包名和 maven groupId 以及版本号的修改会影响目前 spring-cloud-alibaba 的使用者，我们需要社区的意见，也想听听社区的声音。大家可以在 issue 里进行答复和讨论。

flystar32 commented 5 years ago

倾向于这种模式的，请给这条回复点赞。

Spring Cloud Alibaba Bom 版本号 Starter & 模块名 版本号 Spring Cloud 版本号
Spring Cloud Alibaba 1.0.x 1.0.x Spring Cloud Edgware
Spring Cloud Alibaba 1.1.x 1.1.x Spring Cloud Finchley
Spring Cloud Alibaba 1.2.x 1.2.x Spring Cloud Greenwich

这种模式，参考了之前 Spring Cloud GCP 和 Spring Cloud Kubernetes 的方式。

flystar32 commented 5 years ago

倾向于这种模式的，请给这条回复点赞。

Spring Cloud Alibaba Bom 版本号 Starter & 模块名 版本号 Spring Cloud 版本号
Spring Cloud Alibaba 1.5.x 1.5.x Spring Cloud Edgware
Spring Cloud Alibaba 2.0.x 2.0.x Spring Cloud Finchley
Spring Cloud Alibaba 2.1.x 2.1.x Spring Cloud Greenwich

这个模式，SCA 的版本号与 Spring Boot 的版本号有一个对应关系。

HaojunRen commented 5 years ago

倾向于这种模式的，请给这条回复点赞。

Spring Cloud Alibaba Bom 版本号 Starter & 模块名 版本号 Spring Cloud 版本号
Spring Cloud Alibaba 1.x 1.x Spring Cloud Edgware
Spring Cloud Alibaba 2.x 2.x Spring Cloud Finchley
Spring Cloud Alibaba 3.x 3.x Spring Cloud Greenwich

E版1.x，F版2.x，G版3.x，H版4.x...一目了然

1.0.x，1.1.x，1.2.x方式也有缺陷，无论到多少年，SCA大版本号永远是1。不懂的人以为SCA永远没在升级。 建议E版1.x，F版2.x，G版3.x，H版4.x...这样就更加一目了然

我觉得还是要在一定的原则下设计版本号，这个原则是“以我为主”，即按照自己的版本号规则即可，不用强制绑定spring boot或spring cloud版本。x.y.z；x代表重大架构/设计变化；y代表不兼容的升级或特性；z代表兼容的bug修改或特性升级； 只要在readme显著位置以表格形式标明spring-cloud-alibaba和spring cloud版本兼容关系和推荐组合即可

由于spring cloud E版本的特殊性（长期维护到spring boot 1.5.x EOL） 1.0.0 对应 spring boot 1.5.x 和 spring cloud E

2.0.0 对应 spring boot 2.x 和 spring cloud F版本及以上，如果spring-cloud-alibaba不用修改代码即可兼容spring cloud G则不升级版本

如果由于架构或设计发生重大变化，即使对应的兼容spring cloud版本没有发生变化，我们自己也可以独立升级大版本 例如 2.0.0 和 3.0.0 都对应 spring cloud G

HaojunRen commented 5 years ago

1.0.x，1.1.x，1.2.x方式也有缺陷，无论到多少年，SCA大版本号永远是1。不懂的人以为SCA永远没在升级。 建议E版1.x，F版2.x，G版3.x，H版4.x...这样就更加一目了然

flystar32 commented 5 years ago

倾向于这种模式的，请给这条回复点赞。

Spring Cloud Alibaba Bom 版本号 Starter & 模块名 版本号 Spring Cloud 版本号
Spring Cloud Alibaba Edgware.x Edgware.x Spring Cloud Edgware
Spring Cloud Alibaba Finchley.x Finchley.x Spring Cloud Finchley
Spring Cloud Alibaba Greenwich.x Greenwich.x Spring Cloud Greenwich

这个模式，SCA 的版本号与 Spring Cloud 的版本号有一个对应关系。 缺点是 后面的 x 会与 Spring Cloud 的 SR1 、SR2 这样不同步

flystar32 commented 5 years ago

1.0.x，1.1.x，1.2.x方式也有缺陷，无论到多少年，SCA大版本号永远是1。不懂的人以为SCA永远没在升级。 建议E版1.x，F版2.x，G版3.x，H版4.x...这样就更加一目了然

好的，我把你的原贴编辑一下，也参与到投票中。

liresky commented 5 years ago

版本号的要求其实就是简单易懂，一看就知道怎么个情况，再说清楚点，就是你看到SCA的版本号就知道对应的SpringCloud的版本。起码大版本应该是比较清楚的。但是其内部还牵扯的一个就是SpringBoot的版本。SpringCloud决定了整体技术路线，SpringBoot可以决定一些具体的编码特性和细节。所以个人觉得从易读性考虑，能把SpringBoot和SpringCloud的信息能直接表达出来最好。 单纯来看，数字是最好的选择。

倾向于这种模式的，请给这条回复点赞。

Spring Cloud Alibaba Bom 版本号 Starter & 模块名 版本号 Spring Cloud 版本号
Spring Cloud Alibaba 1.x 1.x Spring Cloud Edgware
Spring Cloud Alibaba 2.x 2.x Spring Cloud Finchley
Spring Cloud Alibaba 3.x 3.x Spring Cloud Greenwich

E版1.x，F版2.x，G版3.x，H版4.x...一目了然

Spring Cloud Alibaba Bom 版本号 Starter & 模块名 版本号 Spring Cloud 版本号
Spring Cloud Alibaba 1.x.y 1.x Spring Cloud Edgware
Spring Cloud Alibaba 2.x.y 2.x Spring Cloud Finchley
Spring Cloud Alibaba 3.x.y 3.x Spring Cloud Greenwich

1.x与Starter保持同步，y这个代表SCA的自我修复版本。在别人的基础上加上bug修复版本

charlesvhe commented 5 years ago

我觉得还是要在一定的原则下设计版本号，这个原则是“以我为主”，即按照自己的版本号规则即可，不用强制绑定spring boot或spring cloud版本。x.y.z；x代表重大架构/设计变化；y代表不兼容的升级或特性；z代表兼容的bug修改或特性升级； 只要在readme显著位置以表格形式标明spring-cloud-alibaba和spring cloud版本兼容关系和推荐组合即可

由于spring cloud E版本的特殊性（长期维护到spring boot 1.5.x EOL） 1.0.0 对应 spring boot 1.5.x 和 spring cloud E

2.0.0 对应 spring boot 2.x 和 spring cloud F版本及以上，如果spring-cloud-alibaba不用修改代码即可兼容spring cloud G则不升级版本

如果由于架构或设计发生重大变化，即使对应的兼容spring cloud版本没有发生变化，我们自己也可以独立升级大版本 例如 2.0.0 和 3.0.0 都对应 spring cloud G

Spring Cloud Alibaba Bom 版本号 Starter & 模块名 版本号 Spring Cloud 版本号 修改内容
Spring Cloud Alibaba 1.0.0 1.x Spring Cloud Edgware spring cloud E初始版本
Spring Cloud Alibaba 1.0.1 1.x Spring Cloud Edgware spring-cloud-alibaba-nacos-config组件安全升级
Spring Cloud Alibaba 2.0.0 2.x Spring Cloud Finchley spring cloud F初始版本
Spring Cloud Alibaba 2.1.0 2.x Spring Cloud Greenwich spring cloud G初始版本
Spring Cloud Alibaba 3.0.0 3.x Spring Cloud Finchley and Greenwich 重大架构设计升级 兼容spring cloud F和G
flystar32 commented 5 years ago

我觉得还是要在一定的原则下设计版本号，这个原则是“以我为主”，即按照自己的版本号规则即可，不用强制绑定spring boot或spring cloud版本。x.y.z；x代表重大架构/设计变化；y代表不兼容的升级或特性；z代表兼容的bug修改或特性升级； 只要在readme显著位置以表格形式标明spring-cloud-alibaba和spring cloud版本兼容关系和推荐组合即可

由于spring cloud E版本的特殊性（长期维护到spring boot 1.5.x EOL） 1.0.0 对应 spring boot 1.5.x 和 spring cloud E

2.0.0 对应 spring boot 2.x 和 spring cloud F版本及以上，如果spring-cloud-alibaba不用修改代码即可兼容spring cloud G则不升级版本

如果由于架构或设计发生重大变化，即使对应的兼容spring cloud版本没有发生变化，我们自己也可以独立升级大版本 例如 2.0.0 和 3.0.0 都对应 spring cloud G

Spring Cloud Alibaba Bom 版本号 Starter & 模块名 版本号 Spring Cloud 版本号 修改内容 Spring Cloud Alibaba 1.0.0 1.x Spring Cloud Edgware spring cloud E初始版本 Spring Cloud Alibaba 1.0.1 1.x Spring Cloud Edgware spring-cloud-alibaba-nacos-config组件安全升级 Spring Cloud Alibaba 2.0.0 2.x Spring Cloud Finchley spring cloud F初始版本 Spring Cloud Alibaba 2.1.0 2.x Spring Cloud Greenwich spring cloud G初始版本 Spring Cloud Alibaba 3.0.0 3.x Spring Cloud Finchley and Greenwich 重大架构设计升级 兼容spring cloud F和G

很好的建议，我把你这条也加入到投票中。和 @HaojunRen 的那条合并了，免得分散了票数。

heqq-github commented 5 years ago

E版 1.x，F版 2.x，G 版 3.x，H 版 4.x...

fangjian0423 commented 5 years ago

Thanks for the vote.