目录

系统架构

HCBM 使用的开源组件

HCBM 完全基于开源产品打造。HCBM 的本身是使用 Spring Cloud 作为微服务架构，并使用了一些主流的开源工具进行DevOps及监控管理等。

应用前端

HCBM 前端使用AntD Pro进行封装拓展。

核心组件有：

React：一个用于构建用户界面的 JAVASCRIPT 库。

AntD Pro：基于React的开箱即用的中台前端/设计解决方案。

Node.js：采用Node打包、构建前端应用

微服务后端

HCBM 的微服务后端采用 Spring Cloud 作为微服务框架，使用 Spring Boot 作为开发脚手架。

核心组件有：

Spring Cloud：Spring Cloud 是一个集成了众多开源的框架，利用 Spring Boot 的开发便利性实现了服务治理、服务注册与发现、负载均衡、数据监控，REST API 发布方式等，基本囊括了分布式框架所需要的所有功能。是一套易开放、易部署、易维护的分布式开发工具包，如下是HCBM用到的一些Spring Cloud的组件：

Spring Boot：Spring Boot 是由 Pivotal 团队提供的全新框架，其设计目的是用来简化新 Spring 应用的初始搭建以及开发过程。该框架使用了特定的方式来进行配置，从而使开发人员不再需要定义样板化的配置。

Mybatis：一款优秀的持久层框架,它支持定制化 SQL、存储过程以及高级映射。

其他常用工具：

数据服务层

HCBM 采用 MySQL、Oracle、SqlServer 作为关系型数据存储库，Redis 作为缓存库。

核心组件有：

MySQL：Mysql 是最流行的开源关系型数据库管理系统。

Oracle：Oracle 是主流的企业级关系型数据库管理系统。

SqlServer：SqlServer 是主流的企业级关系型数据库管理系统。

Redis：Redis 是一个开源的使用 ANSI C 语言编写、支持网络、可基于内存亦可持久化的日志型、Key-Value 数据库，并提供多种语言的 API。

运行环境

HCBM 可运行在 Docker、VM、Server 上。

核心组件有：

Docker：Docker 是一个开源的应用容器引擎，让开发者可以打包他们的应用以及依赖包到一个可移植的容器中，然后发布到任何流行的 Linux 机器上，也可以实现虚拟化。

开发测试

HCBM 采用多个代码检查和测试工具，其中，JUnit、Spock 作为后端 Java 代码的测试工具；Selenium 作为前端测试的工具。

核心组件有：

JUnit：JUnit 是一个 Java 语言的单元测试框架。

Spock: Spock 是一个用于Java或Groovy应用的测试框架。

Selenium：Selenium 是一套完整的 web 应用程序测试系统，包含了测试的录制（selenium IDE），编写及运行（Selenium Remote Control）和测试的并行处理（Selenium Grid）。

系统监控

HCBM 利用主流的开源监控工具，从日志、服务运行环境、调用链等进行全面监控，以便在发生问题时能够快速定位和解决问题。

核心组件有：

Zipkin：Zipkin 为分布式链路调用监控系统，聚合各业务系统调用延迟数据，达到链路调用监控跟踪。

Grafana：Grafana 是一个开箱即用的可视化工具，具有功能齐全的度量仪表盘和图形编辑器，有灵活丰富的图形化选项，可以混合多种风格，支持多个数据源特点。

Promethues：Promethues 是由 SoundCloud 开发的开源监控报警系统和时序列数据库(TSDB)。

Micrometer：Micrometer 是一个监控指标的度量类库。

服务调用链路

基础服务之间的关系以及调用链路。

1. 访问网关、鉴权

API 访问 gateway 网关服务，所有请求都会经过 GateWayHelperFilter 过滤器，在过滤器中，会调用 gateway-helper 鉴权。

进入 gateway-helper，根过滤器RootServletFilter包含了一系列过滤器来对请求进行鉴权，将按图中的过滤器顺序进行校验，其中任何一步返回 false 都会直接返回。一般服务出现403、500等问题可先检查 hzero-gateway-helper 的日志，看是哪一步校验不通过。

权限校验通过后，携带 Jwt 返回到 gateway。

获取用户信息

其中，GetUserDetailsFilter会带着 access_token 访问 oauth 认证服务的 /api/user 接口获取用户信息，并转换成 CustomUserDetails。之后，在AddJwtFilter里将 UserDetails 转成 Jwt。

访问API

权限校验通过后，gateway 会将请求路由到具体的服务上，并带上 Jwt。

在服务内，JwtTokenFilter 将 Jwt 解析成 CustomUserDetails，并放入 SecurityContextHolder，代表用户在这个服务内已经登录，之后的程序中就可以通过 DetailsHelper.getUserDetails() 得到用户信息。若要开启此过滤器，需在启动类上配置 @EnableChoerodonResourceServer 注解开启此功能。

之后返回数据，经过网关，再返回到前端。如果服务响应比较慢，就需要调整网关的超时时间。

服务注册

服务启动时，会向 register 注册中心注册自己。服务注册成功后，hzero-swagger、hzero-config、hzero-iam 都会收到服务注册的消息，swagger 会刷新swagger文档信息，config 刷新服务路由，iam刷新权限。

获取服务文档

swagger、config、iam 收到服务注册成功的消息后，会调用服务的 /v2/choerodon/api-docs 接口获取服务文档信息。

注意：拉取服务文档时，服务可能还未完成启动，默认配置会每隔30秒拉取10次，如果10次后都没拉取到文档，就无法刷新路由等信息了，需手动调用接口刷新。

通知服务刷新配置

config 中，服务路由或配置创建成功后，会调用服务/choerodon/config接口通知服务刷新配置。

服务向配置中心获取配置

服务收到通知后，再向配置中心拉取配置，gateway、gateway-helper 还会拉取路由信息。因此如果路由找不到时，检查表中是否有路由信息，没有可通过配置中心手动添加，再调用通知接口通知服务刷新路由和配置信息。

硬件要求

基于现状的硬件要求，当然，如果考虑高可用，服务器会用的更多，因为项目使用微服务思想，所有各个服务其实都可以分开部署，不是说一定要放到一起的。只是放到一起可以节约硬件资源，而且目前来看也没有必要占用过多资源。

1. 正式环境配置

开发环境配置

UAT和正式机的配置最好是一样的的。

整体配置清单

高可用

项目使用springcloud，其各个组件都可以实现高可用，不过网关的话需要外围有负载均衡的支持。

备注

a) 部署方式可为jar部署或者容器部署，如果直接使用jar包部署，则猪齿鱼不需要安装

b) 服务器与服务器之间建议不做端口管控，服务到桌面端口限制根据实际需求而定

c) 正式环境配置只是建议，具体可能需要根据实际使用情况和部署要求调整

d) CPU、内存、硬盘等，只要综合资源满足要求即可，服务器数量没有限制。

e) 开发环境和测试环境可以共用一套数据库。