从1.0.0升级到1.3.0
平台已有的前端模块、组件、服务等清单和详细信息可参考 服务列表。
若无特殊说明,本次升级所有前端模块最新版为 1.3.0
,后端组件、服务版本最新版为 1.3.0.RELEASE
,数据版本为 1.3.0.RELEASE
。
- 1.2.0 -> 1.3.0 的重要变更日志请参考 v1.3版本更新
- 1.1.0 -> 1.2.0 的重要变更日志请参考 v1.2版本更新
- 1.0.0 -> 1.1.0 的重要变更日志请参考 v1.1版本更新
新增组件
- 开发支持组件
组件 | 描述 |
---|---|
hzero-starter-redis | Redis依赖,相关工具类等 |
hzero-boot-nlp | NLP服务客户端 |
hzero-starter-social-wechat-enterprise | 企业微信登录 |
hzero-boot-pay | 支付服务客户端 |
hzero-starter-jdbc | 动态JDBC组件 |
hzero-starter-excel | Excel开发帮助组件 |
hzero-starter-fragment | 文件分片组件 |
hzero-starter-keyencrypt | 主键加密组件 |
hzero-starter-sqlparser | Sql解析器组件 |
hzero-starter-tracer | 日志追溯组件 |
- 消息服务三方支持组件
组件 | 描述 |
---|---|
hzero-starter-integrate-wechat-official | 微信公众号支持组件 |
hzero-starter-integrate-wechat-enterprise | 企业微信支持组件 |
hzero-starter-integrate-dd | 钉钉支持组件 |
- 消息服务短信支持组件
组件 | 描述 |
---|---|
hzero-starter-sms-core | 短信服务支持核心组件 |
hzero-starter-sms-aliyun | 阿里云短信支持组件 |
hzero-starter-sms-qcloud | 腾讯云短信支持组件 |
hzero-starter-sms-baidu | 百度云短信支持组件 |
- 消息服务语音消息组件
组件 | 描述 |
---|---|
hzero-starter-call-core | 语音服务支持组件 |
hzero-starter-call-jingdong | 京东语音服务组件 |
- 文件服务各类存储拆分如下组件
组件 | 描述 |
---|---|
hzero-starter-file-core | 对象存储支持核心组件 |
hzero-starter-file-minio | MinIO存储支持组件 |
hzero-starter-file-aliyun | 阿里云存储支持组件 |
hzero-starter-file-bos | 百度云存储支持组件 |
hzero-starter-file-obs | 华为云存储支持组件 |
hzero-starter-file-cos | 腾讯云存储支持组件 |
hzero-starter-file-aws | aws存储支持组件 |
hzero-starter-file-azure | 微软存储支持组件 |
hzero-starter-file-jdcloud | 京东云存储支持组件 |
hzero-starter-file-ceph | Ceph存储支持组件 |
- 认证服务单点登录组件
组件 | 描述 |
---|---|
hzero-starter-sso-core | 单点登录核心组件,负责域名对应跳转控制等 |
hzero-starter-sso-cas | cas类型单点登录 |
hzero-starter-sso-oauth | oauth类型单点登录 |
hzero-starter-sso-saml | saml类型单点登录 |
hzero-starter-sso-idm | idm类型单点登录 |
hzero-starter-sso-azure | 微软云AD单点登录 |
- 认证服务页面模板组件
组件 | 描述 |
---|---|
hzero-template-oauth-main | 简化版登录模板 |
hzero-template-oauth-slide | 带轮播图的登录模板 |
- 服务插件
组件 | 描述 |
---|---|
platform-cusz | 个性化插件 |
platform-search | 高级检索插件 |
admin-ng | Admin服务节点组插件 |
删除组件
组件 | 描述 |
---|---|
hzero-boot-common | 代码移至 hzero-starter-core 中,使用方只需删除 hzero-boot-common 的依赖即可 |
hzero-starter-zuul-ratelimit | 网关Zuul改为spring-cloud-gateway,移除Zuul相关依赖 |
新增服务
组件 | 简称 | 默认端口 | 描述 | SaaS和OP说明 | 数据库Schema |
---|---|---|---|---|---|
hzero-invoice | HIVC | 8015 | 发票服务 | 区分 | hzero_invoice |
hzero-ocr | HOCR | 8290 | 图像识别服务 | 不区分 | |
hzero-webexcel | HEXL | 8045 | 在线Excel服务 | 不区分 | hzero_webexcel |
hzero-admin | HADM | 8060 | 平台治理服务 | 区分 | hzero_admin |
hzero-iot | HIOT | 8070 | IoT服务 | 不区分 | hzero_iot |
hzero-search | HSRH | 8090 | 检索服务 | 不区分 | hzero_search |
hzero-dpm | HDPM | 8055 | 数据模型服务 | 不区分 | hzero_dpm |
hzero-ebank | HEBK | 8075 | 银企直联服务 | 不区分 | hzero_ebank |
hzero-charge | HCHG | 8035 | 计费服务 | 不区分 | hzero_charge |
hzero-rule-engine | HRES | 8065 | 规则引擎服务 | 不区分 | 1.3.0.RELEASE |
服务/组件升级
-
修改 pom.xml,如果 parent 依赖的
hzero-parent
,需修改版本号为1.3.0.RELEASE
;如果是自建的 parent 项目,需将其中的 hzero 服务/组件的版本号修改为1.3.0.RELEASE
<parent> <groupId>org.hzero</groupId> <artifactId>hzero-parent</artifactId> <version>1.3.0.RELEASE</version> </parent>
-
修改依赖的服务版本号
<!-- SAAS 版本 --> <dependency> <groupId>org.hzero</groupId> <artifactId>hzero-xxx-saas</artifactId> <version>1.3.0.RELEASE</version> </dependency> <!-- OP 版本 --> <dependency> <groupId>org.hzero</groupId> <artifactId>hzero-xxx</artifactId> <version>1.3.0.RELEASE</version> </dependency>
重点配置调整
服务治理调整
-
1.1.0 新增了 hzero-admin 平台治理服务,且为基础必须服务,升级时可通过服务选配平台创建 hzero-admin 新服务。hzero-admin 服务主要用于管理服务路由、熔断、限流配置等,并集成了 SpringbootAdmin 监控管理页面。除此之外,hzero-admin 还监听服务注册,通知 hzero-iam 刷新权限、通知 hzero-swagger 刷新文档。
-
原 hzero-config 配置中心服务移除了路由、熔断、限流等功能,作为 Spring cloud 版本的配置中心使用。如果项目上没有动态刷新配置的需要,可不部署此服务,也可以使用其它配置中心替换。
-
hzero-config 服务不再区分 OP 和 SaaS 版本,以前依赖
hzero-config-saas
版本的需调整如下:<dependency> <groupId>org.hzero</groupId> <artifactId>hzero-config</artifactId> </dependency>
-
hzero_swagger、hzero_config 服务的数据库需由原
hzero_governance
调整为hzero_admin
,原 hzero_governance 库已废弃。 -
如果直接从
1.0.0
及之前的版本升级至1.3.0
,请先参考 1.0.2 的ChangeLog文档升级权限集控制
网关服务调整
-
hzero-gateway 网关服务由 Zuul 替换为 Spring cloud gateway,
application.yml
、bootstrap.yml
需要从依赖的 hzero-gateway jar 包中拷贝出来进行覆盖。启动类需调整为如下:@EnableHZeroGateway @EnableDiscoveryClient public class GatewayApplication { public static void main(String[] args) { new SpringApplicationBuilder(GatewayApplication.class).web(WebApplicationType.REACTIVE).run(args); } }
依赖调整
-
1.1 中新增了
hzero-starter-redis
组件,将hzero-starter-core
中与 redis 相关的功能抽取出来,便于按需引入 redis 依赖。因此使用了 Redis 功能的服务,需在 pom.xml 中加入 hzero-starter-redis 依赖:<dependency> <groupId>org.hzero.starter</groupId> <artifactId>hzero-starter-redis</artifactId> </dependency>
-
消息服务拆分了短信支持组件,需自行按需在消息服务中引入依赖
组件 | 描述 |
---|---|
hzero-starter-sms-aliyun | 阿里云短信支持组件 |
hzero-starter-sms-qcloud | 腾讯云短信支持组件 |
hzero-starter-sms-baidu | 百度云短信支持组件 |
- 文件服务拆分了各类存储支持组件,需自行按需在文件服务中引入依赖
组件 | 描述 |
---|---|
hzero-starter-file-minio | MinIO存储支持组件 |
hzero-starter-file-aliyun | 阿里云存储支持组件 |
hzero-starter-file-bos | 百度云存储支持组件 |
hzero-starter-file-obs | 华为云存储支持组件 |
hzero-starter-file-cos | 腾讯云存储支持组件 |
hzero-starter-file-aws | aws存储支持组件 |
hzero-starter-file-azure | 微软存储支持组件 |
hzero-starter-file-jdcloud | 京东云存储支持组件 |
hzero-starter-file-ceph | Ceph存储支持组件 |
-
1.1 中移除了
hzero-boot-common
组件,将源码移至hzero-starter-core
中,对依赖方无影响,需要移除服务中的hzero-boot-common
依赖。 -
1.2 中移除了
hzero-starter-zuul-ratelimit
组件,如果使用了此组件,需从依赖中移除。 -
认证服务拆分了单点登录组件,需自行按需在OAuth认证服务中引入依赖
组件 | 描述 |
---|---|
hzero-starter-sso-cas | cas类型单点登录 |
hzero-starter-sso-oauth | oauth类型单点登录 |
hzero-starter-sso-saml | saml类型单点登录 |
hzero-starter-sso-idm | idm类型单点登录 |
hzero-starter-sso-azure | 微软云AD单点登录 |
- 认证服务登录页面模板组件化,需自行按需在OAuth认证服务中引入依赖
组件 | 描述 |
---|---|
hzero-template-oauth-main | 简化版登录模板 |
hzero-template-oauth-slide | 带轮播图的登录模板 |
引入依赖后,可通过如下配置选择使用哪个模板:
hzero:
oauth:
login:
# 登录页面模板 main/slide
default-template: main
数据升级
-
请先备份每个库的表结构及数据,便于出问题之后恢复
-
值集视图行(
hpfm_lov_view_line
)增加了view_header_id、field_name
字段的唯一索引,考虑到以前有脏数据,需要使用如下SQL手动清理脏数据后再升级 hzero_platform 的数据库脚本。-- 删除 hpfm_lov_view_line 中的脏数据 DELETE FROM hpfm_lov_view_line WHERE view_line_id IN ( SELECT t.* FROM ( SELECT h1.view_line_id FROM hpfm_lov_view_line h1 JOIN hpfm_lov_view_line h2 ON ( h1.view_header_id = h2.view_header_id AND h1.field_name = h2.field_name AND h1.view_line_id <> h2.view_line_id ) JOIN hpfm_lov_view_header h3 ON h3.view_header_id = h1.view_header_id AND h3.lov_id <> h1.lov_id ) t ); -- 删除 hpfm_lov_view_line_tl 中的无效数据 DELETE FROM hpfm_lov_view_line_tl WHERE view_line_id NOT IN ( SELECT view_line_id FROM hpfm_lov_view_line );
-
从 gitlab 上下载
1.3.0.RELEASE
的数据库脚本和Excel期初数据ssh: ~ git clone git@code.choerodon.com.cn:hzero-hzero/hzero-resource.git https: ~ git clone https://code.choerodon.com.cn/hzero-hzero/hzero-resource.git ~ git checkout 1.3.0.RELEASE
-
启动交互式脚本安装工具
- 在根目录下打开 bash 窗口,运行 database-init.sh 脚本
- 按步骤选择安装的数据库类型、数据库连接信息、项目版本
- 在浏览器中打开输出的地址
-
先升级表结构
- 安装页面展示了当前版本及可以安装的服务和对应的数据,服务后显示的是对应的数据库schema。
- 首先更新数据库,选择要更新的服务,再点击【更新数据库】即可,如果数据库不存在对应的 schema,会自动创建。
-
升级数据
- 卡片管理新增一个卡片参数字段,原有的code唯一性改成了code和卡片参数做唯一性,需使用如下SQL修复工作台卡片数据
-- MySQL UPDATE hpfm_dashboard_layout hdl INNER JOIN ( SELECT id, CODE, card_params FROM hpfm_dashboard_card ) b ON b.CODE = hdl.CODE SET hdl.card_id = b.id; -- SqlServer UPDATE hpfm_dashboard_layout SET card_id = hpfm_dashboard_card.id FROM hpfm_dashboard_layout, hpfm_dashboard_card WHERE hpfm_dashboard_layout.CODE = hpfm_dashboard_card.CODE; -- ORACLE UPDATE HPFM_DASHBOARD_LAYOUT hdl SET ( hdl.CARD_ID ) = ( SELECT hdc.ID FROM HPFM_DASHBOARD_CARD hdc WHERE hdc.CODE = hdl.CODE ) WHERE EXISTS ( SELECT 1 FROM HPFM_DASHBOARD_CARD hdc WHERE hdl.CODE = hdc.CODE );
* 由于消息发送配置与发送账户的关联关系由ID改成编码,需在 `hzero_message` 库下通过如下SQL手动修复数据。 ```sql # mysql oracle 执行 UPDATE hmsg_template_server_line htsl SET htsl.server_code = ( SELECT hes.server_code FROM hmsg_email_server hes WHERE hes.server_id = htsl.server_id ) WHERE htsl.type_code = 'EMAIL'; UPDATE hmsg_template_server_line htsl SET htsl.server_code = ( SELECT hss.server_code FROM hmsg_sms_server hss WHERE hss.server_id = htsl.server_id ) WHERE htsl.type_code = 'SMS'; UPDATE hmsg_template_server_line htsl SET htsl.server_code = ( SELECT hwo.server_code FROM hmsg_wechat_official hwo WHERE hwo.server_id = htsl.server_id ) WHERE htsl.type_code = 'WC_O'; UPDATE hmsg_template_server_line htsl SET htsl.server_code = ( SELECT hwe.server_code FROM hmsg_wechat_enterprise hwe WHERE hwe.server_id = htsl.server_id ) WHERE htsl.type_code = 'WC_E'; # mssql 执行 UPDATE htsl SET htsl.server_code = hes.server_code FROM hmsg_template_server_line htsl, hmsg_email_server hes WHERE htsl.server_code = hes.server_code AND htsl.type_code = 'EMAIL'; UPDATE htsl SET htsl.server_code = hss.server_code FROM hmsg_template_server_line htsl, hmsg_sms_server hss WHERE htsl.server_code = hss.server_code AND htsl.type_code = 'SMS'; UPDATE htsl SET htsl.server_code = hwo.server_code FROM hmsg_template_server_line htsl, hmsg_wechat_official hwo WHERE htsl.server_code = hwo.server_code AND htsl.type_code = 'WC_O'; UPDATE htsl SET htsl.server_code = hwe.server_code FROM hmsg_template_server_line htsl, hmsg_wechat_enterprise hwe WHERE htsl.server_code = hwe.server_code AND htsl.type_code = 'WC_E';
* 在安装页面,选择要更新的数据,再点击【导入数据】即可更新期初数据。
数据处理
-
弹性域表新增了多语言表,可通过如下SQL补全弹性域配置多语言数据 (hzero_platform)
-- 插入中文 INSERT INTO hpfm_flex_detail_config_tl ( detail_config_id, lang, field_description ) ( SELECT detail_config_id, 'zh_CN', field_description FROM hpfm_flex_detail_config hfdc WHERE NOT EXISTS ( SELECT 1 FROM hpfm_flex_detail_config_tl tl WHERE hfdc.detail_config_id = tl.detail_config_id AND tl.lang = 'zh_CN' ) ); -- 插入英文 INSERT INTO hpfm_flex_detail_config_tl ( detail_config_id, lang, field_description ) ( SELECT detail_config_id, 'en_US', field_description FROM hpfm_flex_detail_config hfdc WHERE NOT EXISTS ( SELECT 1 FROM hpfm_flex_detail_config_tl tl WHERE hfdc.detail_config_id = tl.detail_config_id AND tl.lang = 'en_US' ) );
-
汇率类型定义添加多语言支持,可通过如下SQL补全多语言数据 (hzero_platform)
INSERT INTO hpfm_exchange_rate_type_tl ( rate_type_id, lang, type_name ) ( SELECT rate_type_id, 'zh_CN', type_name FROM hpfm_exchange_rate_type t WHERE NOT EXISTS ( SELECT 1 FROM hpfm_exchange_rate_type_tl tl WHERE t.rate_type_id = tl.rate_type_id AND tl.lang = 'zh_CN') ); INSERT INTO hpfm_exchange_rate_type_tl ( rate_type_id, lang, type_name ) ( SELECT rate_type_id, 'en_US', type_name FROM hpfm_exchange_rate_type t WHERE NOT EXISTS ( SELECT 1 FROM hpfm_exchange_rate_type_tl tl WHERE t.rate_type_id = tl.rate_type_id AND tl.lang = 'en_US' ) );
-
执行器自动注册逻辑调整,自动注册类型的执行器需要关联服务名,从注册中心获取执行器地址。因此原有自动注册类型的执行器都需要手动编辑执行器关联服务名。
-
租户管理员增加了[租户管理员标签],需通过如下SQL给所有租户管理员加上标签。
-- MySQL INSERT INTO iam_role_label (role_id, label_id )( SELECT ir.id, ( SELECT id FROM iam_label WHERE name = 'TENANT_MGR' ) label_id FROM iam_role ir WHERE ( ir.code = 'role/organization/default/administrator' OR ir.h_inherit_role_id IN ( SELECT id FROM iam_role WHERE code = 'role/organization/default/template/administrator' ) ) AND NOT EXISTS ( SELECT 1 FROM iam_role_label irl WHERE irl.role_id = ir.id AND irl.label_id = ( SELECT id FROM iam_label WHERE name = 'TENANT_MGR' ) ) ); -- ORACLE INSERT INTO iam_role_label ( id, role_id, label_id ) ( SELECT iam_role_label_S.nextval, ir.id, ( SELECT id FROM iam_label WHERE name = 'TENANT_MGR' ) label_id FROM iam_role ir WHERE ( ir.code = 'role/organization/default/administrator' OR ir.h_inherit_role_id IN ( SELECT id FROM iam_role WHERE code = 'role/organization/default/template/administrator' ) ) AND NOT EXISTS ( SELECT 1 FROM iam_role_label irl WHERE irl.role_id = ir.id AND irl.label_id = ( SELECT id FROM iam_label WHERE name = 'TENANT_MGR' ) ) );
服务部署
-
数据升级完成之后再重启已升级的服务
-
重启完成后,如果因数据缓存问题,可到
开发管理>系统工具
下手动刷新缓存 -
建议按如下顺序重启服务
- hzero-register
- hzero-admin
- hzero-gateway
- hzero-iam
- hzero-oauth
- hzero-platform
- 其它服务
前端升级指南
-
新增服务模块
服务模块 描述 hzero-front-hadm 平台治理服务 hzero-front-hdpm 数据模型服务 hzero-front-hexl 在线Excel服务 hzero-front-hims 即时通讯服务 hzero-front-hiot IOT服务 hzero-front-hebk 银企直联服务 hzero-front-hchg 计费服务 hzero-front-hcuz 个性化服务 hzero-front-hres 规则引擎服务 -
调整 package.json 版本
在根目录下的package.json中
手动调整
hzero-front-*的版本号;比如: hzero-front-hiam: ^0.10.0 调整为 hzero-front-hiam: 1.3.0;
服务模块 备注 hzero-front-hlcd
最新版本为1.1.0,后续不再维护,新版lowcode正在迭代中 hzero-front-hptl
最新版本为0.11.2, 后续不再维护 hzero-front-hcnf
最新版本为1.2.0 , 后续不再维护 hzero-front-hsgp
最新版本为1.0.0, 后续不再维护 hzero-front-hwfl
服务 最新版本为 0.11.1 后续不再维护 注意:
除没有1.3.0版本的模块外,所有模块版本都要升级到
1.3.0
, 模块信息详见 服务列表 中前端模块信息
。前端的服务模块中,除了必要的依赖,其他的模块都是
按需安装
的, 不需要的模块直接删除即可- 前端最小依赖至少包含如下模块
- hzero-front
- hzero-front-runtime
- hzero-front-hiam
- hzero-front-hpfm
- hzero-front-himp
- hzero-front-hmsg
- 前端最小依赖至少包含如下模块
-
安装依赖
在根目录下执行该语句,重新安装依赖
lerna bootstrap --registry http://nexus.saas.hand-china.com/content/groups/hzero-npm-group/
或者
yarn --registry http://nexus.saas.hand-china.com/content/groups/hzero-npm-group/
在根目录再次执行
yarn build:dll
编译
lerna run transpile
启动项目
yarn start
-
环境变量的变化
增加环境变量:
IM_ENABLE: 'BUILD_IM_ENABLE', // IM 功能是否启用,默认不启用 IM_WEBSOCKET_HOST: 'BUILD_IM_WEBSOCKET_HOST', // im websocket 地址 CUSTOMIZE_ICON_NAME: 'BUILD_CUSTOMIZE_ICON_NAME', // 客制化的iconfont font family 名称 TRACE_LOG_ENABLE: 'true' // TraceLog日志追溯分析是否启用,true/false MULTIPLE_SKIN_ENABLE: 'true',// UED配置是否启用,true/false
-
升级时可能遇到的问题
-
遇到的报错信息为:
解决办法:在根目录的 src
下创建 assets/icons
文件夹。如果是在子模块启动,也需要在子模块下的 src
下创建 assets/icons
文件夹
- 遇到的报错信息为:
解决办法:将 config/webpack.dll.config.js
中 vendorsGraph
数组中的 bizcharts
@antv/data-set
替换为 echarts
- 遇到的报错信息为:
解决办法:
- 方法1: 更新
hzero-front-runtime
为1.2.0
版本, 执行如下命令:
hzero-front.cli .
- 方法2: 删除根目录下根目录下
src/index.js
中对im的引用,具体操作如下(单模块启动时,上述报错只能使用此方法解决):
- 遇到的报错信息为:
解决办法:删除根目录下的 babelrc
文件