微服务架构技术规范-第一版V2

1、微服务架构技术规范（试行稿）1 总则目前研发中心的后台开发中，基于Java/SpringMVC/SpringBoot框架开发，每个部门引入的支撑组件却各异，缺乏统一性，甚至每个部门都维护着一堆非业务组件，影响开发人员对快速变化业务支持的专注性。这套方案的具有较好的可扩展性、可维护性、及良好的代码风格，可以为公司各类型的应用开发提供统一、通用、而强大的基础架构，完全能支持公司所有后台服务沉淀和演化出一个稳健企业中台。2 适用范围本规范适用于创维数字本部及各分子公司，在使用微服务技术架构进行系统开发时，需遵循此技术规范3 微服务概述3.1 微服务定义什么是微服务？1 .微服务-也称为微服务架构-是

2、一种架构风格，它将应用程序构建为一组服务2 .高度可维护和可测试3 .松散耦合4 .可独立部署5 .围绕业务能力进行组织。6 .微服务架构支持大型复杂应用程序的持续交付/部署。它还使组织能够发展其技术堆栈。ChrisRichardson世界著名软件大师3.2 使用微服务传统的单体服务，或者模块化不彻底的项目可能存在以下弊端：1 .团队职责不清晰2 .构建和部署耗时长3,全量部署耗时长、影响范围广4 .单体只能按整体横向扩展，无法分模块垂直扩展5 .受技术栈限制，团队成员使用同一框架和语言6 .升级和变革技术框架变得困难随着软件行业的发展和演变，服务器软件进入了微服务化阶段。对服务的可维护性、可

3、扩展性、可用性这些维度更加让从业人员关注。而微服务化正是解决这些观注的良好的解决方案。所以微服务化正是软件发展演化的结果。在新的目项目应该微服务化解决方案。微服务化的程度可以具体项目具体场景决定。4 开发规范4.1 基本理念4.1.1 无状态服务(Stateless)无状态就是一次操作，不能保存数据。在编程层面，无状态对象(StatelessBean),就是没有实例变量的对象.不能保存数据，是不变类，是线程安全的。比如Java开发中的EJB,Servlet,SpringMVC,SpringService都是无状态的。HTTP也是一种不保存状态，无状态(stateless)协议。HTTP协议自身

4、不对请求和响应之间的通信状态进行保存。也就是说在HTTP这个级别，协议对于发送过的请求或响应都不做持久化处理。JWT也无状态的Token机制，不需要在服务端存储session信息，因为Token自身包含了所有用户的相关信息。Kubernetes中stateless服务也是一种无状态服务，功能强大，易于扩展和发布。所以无状态是一种非常有价值的架构设计理念4.1.2 幕等性是指任意多次执行所产生的影响，与一次执行的影响相同。一个拥有幕等性设计的接口，保证无论一次或多次来调用接口，都能够得到相同的结果。在微服务场景中，幕等有助于系统的可靠性，易于实现重试机制、易于实现缓存系统的设计。4.2 数据请求

5、规范4.2.1 URL规范针对目前url使用不规范，提出以下建议。般域名后面建议就三层：https:/域名/业务模块名/功能点/功能操作(？或/)可选内容https:/api.skyworthdigitailiotcom/业务模块名/功能点/功能操作https:/admin.skyworthdigitailiotcom/业务模块名/功能点/功能操作注意事项：采用子域名区分请求是amdin或app的，不同子域名采用不同ip,入口隔离。url字符串中不区分amdin或app,但目前的header可以区分不同业务端，同时可用于控制访问权限。controller代码中，admin/app放到不同的co

6、ntroller文件中。但RequestMapping不用区分是admin,还是app的功能。4.2.2 REST要遵循Restful方式(增删改查对应Post,Delete,Put,Get)的接口定义，所有的get请求必须幕等。幕等就是用户对于同一操作发起的一次请求或者多次请求的结果是一致的，不会因为多次点击而产生了副作用。分布式环境下各个服务相互调用，所以尽可能提供幕等性性接口。对外接口一般都是http接口，最好根据Http方法的语义来发放请求。对于资源的具体操作类型，由HTTP动词表示。常用的HTTP动词有下面五个:GET(SELECT):从服务器取出资源(一项或多项)。POST(CRE

7、ATE):在服务器新建一个资源。PUT(UPDATE):在服务器更新资源(客户端提供改变后的完整资源)。PATCH(UPDATE):在服务器更新资源(客户端提供改变的属性)。DELETE(DELETE):从服务器删除资源。Get/Delete采用查询字符申请求。Post/Put请求和响推荐都采用Json格式。一个Json返回的格式举例如下：返回成功状态200OK.("CODE":200,"SUCCESS":TRUE,"DATA":,"MSG":"操作成功"4.3 安全4.3.1 HTTPsHTT

8、Ps可以保障数据的保密性、完整性、身份校验安全性，所以应该实施全站HTTPs化。随着HTTP-2、HTTP-3技术的出现HTTPs的传输效率也有了极大的提高。4.3.2 OAuth2是开放授权的一个标准，旨在让用户允许第三方应用去访问改用户在某服务器中的特定私有资源，而可以不提供其在某服务器的账号密码给到第三方应用4.3.3 JWTJWT提供了一种用于发布接入令牌(AccessToken),并对发布的签名接入令牌进行验证的方法。令牌(Token)本身包含了一系列声明，应用程序可以根据这些声明限制用户对资源的访问。4.3.4 OpenlDConnect它在OAuth2上构建了一个身份层，是一个基

9、于OAuth2协议的身份认证标准协议。OpenIDConnect是OAuth2.0协议之上的简单身份层，用API进行身份交互的框架，允许客户端根据授权服务器的认证结果最终确认用户的身份，以及获取基本的用户信息；它支持包括Web、移动、JavaScript在内的所有客户端类型；它是可扩展的协议，允许你使用某些可选功能，如身份数据加密、OpenID提供商发现、会话管理。4.4 配置中心是配置不同。所以运做到测试环境、正一般来说，测试环境的程序和正式环境的一个重要的差别,维相关的配置、程序参数外置，也符合无状态服务的理念，式环境一个部署包。所以程序配置，应该存放在配置中心集中管理。4.5 服务注册中

10、心注册中心最本质的功能可以看成是一个Query函数Si=F(service-name),以Service-Name为查询参数，Service-Name对应的服务的可用的Endpoints(ip:port)列表为返回值。注册中心机制解耦了服务的提供者和服务的使用者，是微服务的关键设计模式4.6 APIGatewayAPI网关对外采用门面设计模式，实现上采用责任链设计模式，是微服务的关键设计模式。4.7 服务通讯推荐采用HttpRest&JSON方式做服务问通讯，简单也易于调试。随着HTTP3.0基于UDP协议的使用，传输效率也会更好。4.8 流量控制微服务中由于模块较多，网络中因某些原因，有时会出现流量热点，甚于出现拖垮整个集群的可能。我们不能束手无策，所以微服务集群内流量控制上非常必要。目前流量控制推荐使用AlibabaSentinel,它支持丰富的应用场景、完备的实时监控、广泛的开源生态，可以很方便大家接入。4.9 链路跟踪当业务模块间调用关系比较复杂时，应引入链路跟踪功能。5 BaseProject项目在微服务的实践中，我们不需要从头构建去构建一个微服务的体系，所以选择一个合适的BaseProject项目，会使大家对微服务使用有一个良好的开端，有利代码风格的统一、有一个较高的起点、以利于微服务的实施推荐大家使用Bladex项目，基于该项目完成微服务化实施。6 部署和