本文介绍使用 Rainbond 快速部署 Spring Cloud Blade 微服务平台。Spring Cloud Blade 是一个由商业级项目升级优化而来的微服务架构，采用 Spring Boot 2.7 、Spring Cloud 2021 等核心技术构建，完全遵循阿里巴巴编码规范。提供基于 React 和 Vue 的两个前端框架用于快速搭建企业级的 SaaS 多租户微服务平台。

关于 Spring Cloud Blade

• 采用前后端分离的模式，前端开源两个框架：Sword (基于 React、Ant Design)、Saber (基于 Vue、Element-UI)
• 后端采用 SpringCloud 全家桶，并同时对其基础组件做了高度的封装，单独开源出一个框架：BladeTool
• BladeTool 已推送至 Maven 中央库，直接引入即可，减少了工程的臃肿，也可更注重于业务开发
• 集成 Sentinel 从流量控制、熔断降级、系统负载等多个维度保护服务的稳定性。
• 注册中心、配置中心选型 Nacos，为工程瘦身的同时加强各模块之间的联动。
• 极简封装了多租户底层，用更少的代码换来拓展性更强的 SaaS 多租户系统。
• 借鉴 OAuth2，实现了多终端认证系统，可控制子系统的 token 权限互相隔离。
• 借鉴 Security，封装了 Secure 模块，采用 JWT 做 Token 认证，可拓展集成 Redis 等细颗粒度控制方案。
• 项目分包明确，规范微服务的开发模式，使包与包之间的分工清晰。

模块说明

SpringBlade
├── blade-auth -- 授权服务提供
├── blade-common -- 常用工具封装包
├── blade-gateway -- Spring Cloud 网关
├── blade-ops -- 运维中心
├    ├── blade-admin -- spring-cloud后台管理
├    ├── blade-develop -- 代码生成
├    ├── blade-resource -- 资源管理
├    ├── blade-seata-order -- seata分布式事务demo
├    ├── blade-seata-storage -- seata分布式事务demo
├── blade-service -- 业务模块
├    ├── blade-desk -- 工作台模块 
├    ├── blade-log -- 日志模块 
├    ├── blade-system -- 系统模块 
├    └── blade-user -- 用户模块 
├── blade-service-api -- 业务模块api封装
├    ├── blade-desk-api -- 工作台api 
├    ├── blade-dict-api -- 字典api 
├    ├── blade-system-api -- 系统api 
└──  └── blade-user-api -- 用户api 

Spring Cloud Blade 完整部署的服务拓扑图

基于应用商店快速部署 Spring Cloud Blade

通过开源应用商店部署 Spring Cloud Blade，在 平台管理 -> 应用市场 -> 开源应用商店 中搜索 SpringBlade 并一键安装。

部署完成后，如上图 Spring Cloud Blade 完整部署的服务拓扑图 所示。

基于源码部署 Spring Cloud Blade

本篇文章基于 Spring Cloud Blade v3.5.0 版本部署。

一、部署 Nacos

通过开源应用商店部署 Nacos，在开源应用商店中搜索 Nacos单机 并选择安装 2.1.2 版本。

二、部署 Redis

通过开源应用商店部署 Redis，在开源应用商店中搜索 Redis 并选择安装 5.0.7 版本。

三、部署 Sentinel Dashboard

通过开源应用商店部署 Sentinel Dashboard，在开源应用商店中搜索 Sentinel-Dashboard 并选择安装 1.8.6 版本。

四、初始化数据库

从开源应用商店安装的 Nacos 自带了 Mysql 组件，进入该组件中 -> 端口 -> 打开对外服务，通过客户端工具连接。

1. 创建 blade 数据库。
2. 初始化表结构和数据：Blade SQL

五、部署 Blade 后端服务

1. 基于源码创建组件，填写以下信息：

2. 检测出多模块构建，进入多模块构建页面

1. 创建前，在多模块构建页面 -> 右侧修改按钮 -> 修改每个模块的启动命令，如下。
2. 创建后，删除每个组件的默认端口，为每个组件添加对应的新端口和端口别名并打开端口的对内服务，如下。
3. 修改完成后构建组件。

3. 编辑依赖关系，切换到 编排模式 拖动组件进行依赖关系建立。

4. 进入 Nacos 组件内 -> 端口 -> 打开 8848 端口的对外服务，访问 Nacos 并登录，默认用户密码 nacos/nacos，创建配置文件。

创建 blade.yaml 配置文件，内容如下：

#服务器配置
server:undertow:# 以下的配置会影响buffer,这些buffer会用于服务器连接的IO操作,有点类似netty的池化内存管理buffer-size: 1024# 是否分配的直接内存direct-buffers: true# 线程配置threads:# 设置IO线程数, 它主要执行非阻塞的任务,它们会负责多个连接, 默认设置每个CPU核心一个线程io: 16# 阻塞任务线程池, 当执行类似servlet请求阻塞操作, undertow会从这个线程池中取得线程,它的值设置取决于系统的负载worker: 400#spring配置
spring:cloud:sentinel:eager: truedevtools:restart:log-condition-evaluation-delta: falselivereload:port: 23333#feign配置
feign:sentinel:enabled: trueokhttp:enabled: truehttpclient:enabled: false#对外暴露端口
management:endpoints:web:exposure:include: "*"endpoint:health:show-details: always#knife4j配置
knife4j:#启用enable: true#基础认证basic:enable: falseusername: bladepassword: blade#增强配置setting:enableSwaggerModels: trueenableDocumentManage: trueenableHost: falseenableHostText: http://localhostenableRequestCache: trueenableFilterMultipartApis: falseenableFilterMultipartApiMethodType: POSTlanguage: zh-CNenableFooter: falseenableFooterCustom: truefooterCustomContent: Copyright © 2022 SpringBlade All Rights Reserved#swagger配置信息
swagger:title: SpringBlade 接口文档系统description: SpringBlade 接口文档系统version: 3.5.0license: Powered By SpringBladelicenseUrl: https://bladex.vipterms-of-service-url: https://bladex.vipcontact:name: smallchillemail: smallchill@163.comurl: https://gitee.com/smallc#blade配置
blade:token:sign-key: 请配置32位签名提高安全性xss:enabled: trueskip-url:- /weixinsecure:skip-url:- /test/**client:- client-id: swordpath-patterns:- /sword/**- client-id: saberpath-patterns:- /saber/**tenant:column: tenant_idtables:- blade_notice

创建 blade-dev.yaml 配置文件，内容如下：

#spring配置
spring:redis:##redis 单机环境配置host: 127.0.0.1port: 6379password:database: 0ssl: false#项目模块集中配置
blade:#通用开发生产环境数据库地址(特殊情况可在对应的子工程里配置覆盖)datasource:dev:url: jdbc:mysql://127.0.0.1:3306/blade?useSSL=false&useUnicode=true&characterEncoding=utf-8&zeroDateTimeBehavior=convertToNull&transformedBitIsBoolean=true&tinyInt1isBit=false&allowMultiQueries=true&serverTimezone=GMT%2B8username: rootpassword: root

更新或重启除 Nacos Mysql Redis Sentinel Dashboard 之外的所有组件。

六、部署 Blade 前端 Saber

1. 基于源码创建组件，填写以下信息：

1. 进入 Saber 组件内 -> 端口 -> 删除默认端口，新增 8080 端口并打开对外服务。
2. 编辑依赖关系，切换到 编排模式 拖动组件进行依赖关系建立，将 Saber 依赖 blade-gateway 并更新组件。
3. 使用默认域名访问 Saber UI 并登录。