标准规范下载简介

Q／GDW 12119-2021 微服务架构设计导则.pdf

ICS 29.240

Q/GDW12119—2

signguidelinefor microservice archite

国家电网有限公司 发布

GB50206-2012 木结构工程施工质量验收规范.pdfQ/GDW12119202

为规范基于微服务架构应用的通用设计与技术要求，包括微服务设计要求、运维要求和接口设计要 求，制定本标准。 本标准由国家电网有限公司互联网部提出并解释。 本标准由国家电网有限公司科技部归口。 本标准起草单位：国网信息通信产业集团有限公司、国网山东省电力公司、国网上海市电力公司、 国网浙江省电力有限公司、国网江苏省电力有限公司、国网四川省电力公司、国网陕西省电力公司、国 网甘肃省电力公司、南瑞集团有限公司、中国电力科学研究院有限公司、国网重庆市电力公司。 本标准主要起草人：刘迪、崔蔚、刘泽三、吴钢、邱镇、廖道、赵峰、付炜平、郑建宁、王孟强、 张治志、张晶、刘歆一、李春岐、焦艳斌、王璇、张士林、张小勇、崔雪璐、吴岩、李策、毛冬、潘新 阳、徐冉、杨启帆、吕鹏鹏、唐震宇、张驰、刘少博、刘旭、郭彦飞、李哲、吴高翔。 本标准首次发布。 本标准在执行过程中的意见或建议反馈到国家电网有限公司科技部。

为规范基于微服务架构应用的通用设计与技术要求，包括微服务设计要求、运维要求和接口设计要 求，制定本标准。 本标准由国家电网有限公司互联网部提出并解释。 本标准由国家电网有限公司科技部归口。 本标准起草单位：国网信息通信产业集团有限公司、国网山东省电力公司、国网上海市电力公司、 国网浙江省电力有限公司、国网江苏省电力有限公司、国网四川省电力公司、国网陕西省电力公司、国 网甘肃省电力公司、南瑞集团有限公司、中国电力科学研究院有限公司、国网重庆市电力公司。 本标准主要起草人：刘迪、崔蔚、刘泽三、吴钢、邱镇、廖逍、赵峰、付炜平、郑建宁、王孟强、 张治志、张晶、刘歆一、李春岐、焦艳斌、王璇、张士林、张小勇、崔雪璐、吴岩、李策、毛冬、潘新 阳、徐冉、杨启帆、吕鹏鹏、唐震宇、张驰、刘少博、刘旭、郭彦飞、李哲、吴高翔。 本标准首次发布。 本标准在执行过程中的意见或建议反馈到国家电网有限公司科技部。

Q/GDW12119—2021微服务架构设计导则1范围本标准规定了基于微服务架构应用的通用设计与技术要求，包括微服务设计要求、运维要求、接口设计要求等内容。本标准适用于指导开发团队在公司信息化建设中对微服务架构的总体设计。2规范性引用文件下列文件对于本标准的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T32430信息技术SOA应用的服务分析与设计Q/GDW11822.1国家电网公司一体化“国网云”第1部分术语3：术语和定义Q/GDW11822.1界定的以及下列术语和定义适用于本文件。3. 1微服务microservice些可协同工作、小而自治、分布式模式的软件服务，以服务方式实现的软件包，具有部署独立、通信轻量的特点，支撑单一业务逻辑的功能实现。3. 2微服务架构microservicearchitecture一种基于分布式模式的软件架构，其核心思想是把一个大型的应用程序拆分为若干个服务模块，每个服务模块承担单一职责、模块化、相对独立的一段业务逻辑，可独立部署、独立运行，并采用轻量级的通信机制互相配合为用户提供最终价值。每个微服务可根据业务性能需要进行独立扩展。3. 3分布式服务总线distributed servicebus用于对服务进行管理的平台组件，包括服务注册、发现、调用、路由、监控等，3. 4配置中心configcenter为微服务提供多个环境下的统一动态配置信息的存储，在各个运行环境下通过推拉的方式将更新的信息同步到微服务中。1

Q/GDW12119202

幂等性idempotentity 对同一个系统，使用同样的条件，一次请求和重复的多次请求对系统资源的影响是

微服务架构分为基础设施层、服务层、应用层、DevOps四个主要部分，如图1所示： a）基础设施层应为系统运行提供基础支撑环境，提供控制台及监控中心为系统运维提供便捷管理 方式； 6 服务层应采用微服务架构设计，部署统一的注册中心、配置中心，提供稳定、无状态、抽象的 业务服务能力，并通过微服务网关对应用层提供统一的API接口。其中按业务领域划分的微服 务宜独立设计并维护专属数据库； C 应用层应实现人机界面交互、对外接口交互等，可根据应用场景的交互需求以及开发团队的技 术储备，选择适合的技术架构； d）DevOps应提供需求、设计、开发、测试、发布等阶段的支撑工具。

Q/GDW121192021

微服务设计应遵循以下原则： a）高内聚低耦合原则：将业务完整、职责单一的功能单元拆分为独立微服务，耦合性强或存在紧 密事务联系的相关功能宜设计在同一微服务中： b 粒度适中原则：微服务拆分应保持适中的颗粒度，首次设计不宜过度拆分，宜采用逐步拆分、 持续演进的方式不断细化微服务； c）前后端分离原则：将后端服务剥离为可独立开发及独立部署的微服务，微服务应以API接口方 式为前端应用提供标准的业务支撑能力； d）服务无状态原则：微服务应是无状态的，微服务接口不应包含服务请求的状态信息

微服务拆分可采用以下方法： a）基于业务领域识别：宜将业务完整、职责单一的功能垂直拆分为独立微服务； b）基于基础服务识别：宜将具有重用能力的公共服务水平拆分为基础微服务； c）基于性能指标识别：宜将高并发、海量数据等性能压力大的模块拆分为独立部署的微服务； d）基于其它方法识别：宜将可靠性要求高的核心模块与可靠性要求低的非核心模块拆分为不同 的微服务。

微服务设计应遵循以下要求： a） 微服务治理：微服务治理应包含注册中心、微服务网关、配置中心、服务监控等组件，宜通过 云平台提供的分布式服务总线对所有的微服务进行统一管理； b 事务一致性设计：针对分布式事务可选择最终事务一致性、两阶段提交、事务补偿等解决方案， 宜优先选择最终事务一致性方案： C）分布式日志设计：应提供统一的日志管理组件实现日志的集中采集、管理及分析

6.1开发运维工具要求

Q/GDW121192021

开发运维工具应支撑需求下发、代码提交与编译、测试与验证，部署与运维等阶段，提供软件研发 到端的支持，具体要求如下： a 技术路线可参照附录表A.1； b 微服务应具备持续集成及持续交付能力； C 微服务测试应包括单元测试、组件测试、集成测试、系统测试等各个环节； d 代码仓库应支持SVN、Git等主流配置管理工具； e 镜像库应支持镜像文件的统一管理和共享； f 容器管理模块应提供对容器的管理及编排工具； 8 自动发布功能应提供发布包的资源库管理及发布管理组件

微服务部署要求主要包括如下方面： a）每个部署单元可包括一个或多个微服务； b）可采用多版本共存的灰度发布方式； c）宜考虑高可用和负载均衡； d）宜采用容器方式进行部署。

微服务部署要求主要包括如下方面： a）每个部署单元可包括一个或多个微服务： b）可采用多版本共存的灰度发布方式； c）宜考虑高可用和负载均衡； d）宜采用容器方式进行部署。

微服务接口设计应遵循如下规则： a）微服务接口宜遵循RESTfu1轻量级的接口设计风格，接口报文示例见附录A.2； b） 微服务接口应设计为无状态服务，应避免对用户登录状态的依赖； ）微服务接口宜具有幂等性质

微服务接口设计应遵循如下规则： a）微服务接口宜遵循RESTfu1轻量级的接口设计风格，接口报文示例见附录A.2； b） 微服务接口应设计为无状态服务，应避免对用户登录状态的依赖； c）微服务接口宜具有幂等性质

Q/GDW121192021

附录A （资料性附录） 微服务架构应用开发参考

基于微服务架构的应用的技术路线如表A.1所示

表A.1技术路线要求

A.2微服务接口报文示例

Q/GDW121192021

A. 2. 2 报文示例2

图A.1微服务接口报文示例1

前端应用采用web纯前端架构，在微服务网关中对全部渠道进行统一身份鉴权，token节点直接定义 在微服务报文中，请求报文及应答报文示例，如图A.2所示：

图A.2微服务接口报文示例2

Q/GDW12119202

编制背景 编制主要原则 .10 与其他标准文件的关系. 10 主要工作过程. 标准结构和内容.. 条文说明，

本标准依据国家电网有限公司下达的《2020年第一批技术标准制修订计划的通知》（国家电网利 2020）21号文）的要求编写。 本标准的编制背景为公司在深入推进微服务建设工作的基础上，要求进一步规范信息系统研发单位 设计微服务的架构导则。 本标准的编制目的为满足电力物联网条件下，解决目前公司信息化发展过程中由于缺乏统一微服务 设计规范标准，带来的微服务架构不统一、难以管理等问题。

本标准根据以下原则编制： 坚持先进性与实用性相结合、统一性与灵活性相结合、可靠性与经济性相结合的原则，以标准 化为引领，服务公司科学发展； b 认真研究国内外现行相关的IEC标准、国家标准、行业标准、企业标准，体现微服务架构体系 的最新发展； 调研了解各网省公司微服务业务的业务场景、设备类型、管理制度等方面，充分了解各地微服 务业务的应用现状和功能需求。

钢结构屋面安全施工方案3与其他标准文件的关系

本标准与相关技术领域的国家现行法律、法规和政策保持一致。 本标准不涉及专利、软件著作权等知识产权问题

2020年3月，按照公司技术标准制修订计划，项目立项。 2020年4月，召开项目启动会，成立编写组，讨论大纲，确定分工，制定计划。 2020年6月，各小组按照分工编写标准，小组之间互相审查，形成初稿。 2020年9月，公司互联网技术标准专业工作组组织召开标准初审会，根据专家意见形成征求意见稿 2020年10月，公司互联网技术标准专业工作组采用邮件函审方式在公司范围内征求意见。 2020年11月，根据标准征求意见，完成送审稿编写。 2020年11月19日，由公司互联网技术标准专业工作组组织召开送审稿审查会，对送审稿逐条进行了 充分讨论，审查结论为：审查组经过协商一致，同意修改后以技术标准形式报批。 2020年11月24日，修改形成标准报批稿。

2020年3月，按照公司技术标准制修订计划，项目立项。 2020年4月，召开项目启动会，成立编写组，讨论大纲，确定分工，制定计划。 2020年6月，各小组按照分工编写标准，小组之间互相审查，形成初稿。 2020年9月，公司互联网技术标准专业工作组组织召开标准初审会，根据专家意见形成征求意见稿 2020年10月，公司互联网技术标准专业工作组采用邮件函审方式在公司范围内征求意见。 2020年11月，根据标准征求意见，完成送审稿编写。 2020年11月19日，由公司互联网技术标准专业工作组组织召开送审稿审查会，对送审稿逐条进行了 充分讨论，审查结论为：审查组经过协商一致，同意修改后以技术标准形式报批。 2020年11月24日，修改形成标准报批稿。

本标准按照《国家电网公司技术标准管理办法》（国家电网企管（2018）222号文）的要求编写。 本标准的主要结构和内容如下： 本标准主题章分为3章：包括设计要求、运维要求以及接口设计要求。第5章设计要求规定了微

悬挑式卸料平台专项施工方案Q/GDW121192021

服务设计的总体要求、总体架构、拆分原则、拆分方法及具体设计要求。第6章运维要求规定了微服务 架构的总体接口设计规范

服务设计的总体要求、总体架构、拆分原则、拆分方法及具体设计要求。第6章运维要求规定了微服务 架构的开发运维工具要求及部署要求。第7章接口设计规范规定了微服务架构的总体接口设计规范。