Jacksen的技术博客

本文是H-ZERO 安装部署笔记，出于学习研究目的，刚开始按照开放平台->社区与合作伙伴->文档中心- 《HZERO 轻量版》技术文档进行部署实践，选择快速开始->微服务版进行安装； 但作为初学者， 水平太低， 由于轻量版合并了多个微服务，要改各种配置，过程中遇到多个困难，没有搞定🙂， 后来按照 开放平台->社区与合作伙伴->文档中心- 《HZERO汉得企业级PaaS平台》 技术文档进行 标准版（没有合并微服务的版本） 安装部署实践 ，安装部署成功了。本系列文章记录了这个过程。

需要说明的是，如果不是出于学习研究目的，是不需要这么麻烦的，技术中心有发发行版，可以一键安装，一小时不到可以全部安装完成。

本文是出于学习研究目的，按照技术文档从制品库里面拿各种零件进行组装，所以过程会比较繁琐，供学习研究参考。

实践系统环境：windows自带的Linux虚拟机 WSL ，linux版本在微软应用商店选择 Ubuntu22.04

三、H-ZERO安装介质准备

安装介质包括：

服务端选配：现在项目中心，新建一个项目，我这里新建了一个H-ZERO平台个人研究学习版的项目；

打开项目，进入服务选配

进入选配平台，会看到服务端选配、前端选配、移动端选配；安装平台通常只需要做服务端选配，因为服务端选配完成也会自动生成前端工程；不需要再做前端选配。

进入之后，要选择一个父组件，原来没有父组件，就新建了一个父组件：H-ZERO个人学习版父组件，然后进入下一步：

在右边的批量添加里面选择组件：

组件查询条件输入 “轻量”会出来HZERO轻量组合服务，选上：

依次把网关、注册中心 也选上，在输入平台治理查询条件后会出来平台治理和平台治理客户端，这里只要选择平台治理就可以了，不用选平台治理客户端，这个平台治理客户端是你新建微服务时，如果要调用平台治理服务的功能，才需要选择，相当于调用平台治理服务的SDK，可以在开发时手工添加依赖就好了，不用在选配平台选。

轻量版服务组合中并未包含接口平台（接口平台后面做得越来越复杂，已经难以合并到轻量版的服务组合中去了），所以单独把接口平台在选配时添加进来。

我们这里选HZERO轻量服务组合、网关、注册中心、平台治理、接口平台、飞搭模型服务、飞搭配应用服务 七个；

点“确认” ,输入服务前缀，这里输入的前缀在后面生成的Project目录下的每个模块目录都会加上这里输入的前缀，要求是小写字母命名；

我们是个人学习版，personal study , 简称ps , 所以就用ps作为前缀；配置中心和注册中心留空，表示用默认值：

确认批量修改，回到上个界面，这里服务名称和服务编码不用输入，在右边 打勾”全选7项“，进入”下一步“ 即可生成工程和种子数据；

在生成的工程中，要做些修改：

此处，将lite服务由单体服务架构转为微服务架构，服务与服务之间的访问需要经过中转，所以服务下需要引入一个适配器来进行服务中转的适配。
需要在除了LITE服务之外的其他服务中加入以下依赖：

1. <properties>
2.     <hzero.lite.cloud.version>1.12.0.RELEASE</hzero.lite.cloud.version>
3. </properties>
6. <dependency>
7.         <groupId>org.hzero.starter</groupId>
8.         <artifactId>hzero-starter-litecloud-adapter</artifactId>
9.         <version>${hzero.lite.cloud.version}</version>
10. </dependency>

并在配置文件 application.yml 中开启服务注册的自动注册功能

复制

1. spring:
2.   cloud:
3.     service-registry:
4.       auto-registration:
5.         enabled: true
6. 比如： 在ps-gateway的pom配置文件里面，<properties> 的内容要加在<project> 的直接子目录下；
7. 找到<!–依赖组件列表–> , 把内容<dependency> 内容粘贴到这里，然后单独保存。

备注： 按照产品组建议，那个对lite 的依赖 在 hzero-lite、hzero-admin、hzero-register、hzero-gateway、hzero-license 这几个服务不需要加 ，除了这几个服务之外的服务才需要加，比如飞搭低代码的服务就需要加；

在ps-lite的配置文件 application.yml 中开启服务注册的自动注册功能

在ps-gateway的配置文件 application.yml 中开启服务注册的自动注册功能

……类似方法把其他几个模中也开启服务注册的自动注册功能（具体如何添加，要看各模块的yml文件内容，有的已经有cloud章节了，那么在cloud章节下添加内容就好了，有的没有cloud章节，那就就把cloud章节添加进去。（如果碰到保存报错的情况，不要管，继续操作，后面在IDE环境中直接更改）

种子数据调整

增加跳过初始化数据的表

由于单体服务在进行微服务部署的时候，需要从数据库加载权限信息，而该权限信息在服务合并之后有所变化，所以这里不需要初始化权限信息，而是由服务启动后自动刷入。所以我们需要跳过权限表的初始化数据。

把刚才下载的文件，上传到linux服务器，解压缩：

drwxr-xr-x 5 root root 4096 Jun 27 17:41 ./
drwxr-xr-x 4 root root 4096 Jun 27 17:41 ../
drwxr-xr-x 10 root root 4096 Jun 27 17:39 front/
drwxr-xr-x 9 root root 4096 Jun 27 17:35 project/
drwxr-xr-x 7 root root 4096 Jun 27 17:37 resource-package/
root@desktop-jacksen:/d02/hzero#

在/resource-package/docs/mapping/service-mapping.xml文件中加入如下的配置即可：

复制

1. <skip-table>
2.         iam_permission,iam_permission_tl
3. </skip-table>

调整初始化的路由

单体服务在微服务化之后，路由的配置信息有所变化，所以需要调整路由初始化文件。
将/resource-package/init-data/hzero-admin/hzero-admin/hzero-service.xlsx文件替换为
新的 hzero-service.xlsx文件

接下来构建可运行的Jar文件

父组件发布到Maven仓库

先把父组件发布到Maven仓库，在总工程下面有个POM文件，这个就是父组件；

我们自己学习用，没有可用的Maven私服，可以本地仓库进行安装，确保本地的服务能够依赖到项目父组件即可：

默认maven的本地仓库位置在：

/root/.m2/repository

进入project 目录，执行 mvn install , 这会把父组件(包括其所有依赖的组件)安装到本地仓库

root@desktop-jacksen:/d02/hzero# cd project
root@desktop-jacksen:/d02/hzero/project# ll
-rw-r–r– 1 root root 1691 Jun 27 13:52 pom.xml
drwxr-xr-x 4 root root 4096 Jun 27 17:35 ps-modeler/
drwxr-xr-x 4 root root 4096 Jun 27 17:35 ps-register/
root@desktop-jacksen:/d02/hzero/project# mvn install
[INFO] Scanning for projects…
Downloading from Hzero: http://nexus.saas.hand-china.com/repository/hzero/org/hzero/hzero-parent/1.12.0.RELEASE/hzero-parent-1.12.0.RELEASE.pom
Downloaded from Hzero: http://nexus.saas.hand-china.com/repository/hzero/org/hzero/hzero-parent/1.12.0.RELEASE/hzero-parent-1.12.0.RELEASE.pom (96 kB at 796 kB/s)
Downloading from Hzero: http://nexus.saas.hand-china.com/repository/hzero/org/springframework/boot/spring-boot-starter-parent/3.4.1/spring-boot-starter-parent-3.4.1.pom

……

Downloading from Hzero: http://nexus.saas.hand-china.com/repository/hzero/org/springframework/spring-core/6.2.1/spring-core-6.2.1.jar
Downloading from Hzero: http://nexus.saas.hand-china.com/repository/hzero/org/springframework/spring-jcl/6.2.1/spring-jcl-6.2.1.jar

……

Downloaded from central: https://repo.maven.apache.org/maven2/net/java/dev/jna/jna-platform/5.13.0/jna-platform-5.13.0.pom (2.3 kB at 18 kB/s)

……

[INFO] Installing /d02/hzero/project/pom.xml to /root/.m2/repository/com/hand/ps-demo-parent/0.0.1/ps-demo-parent-0.0.1.pom
[INFO] ————————————————————————
[INFO] BUILD SUCCESS
[INFO] ————————————————————————
[INFO] Total time: 44.728 s

接下来进入各子模块，用命令 mvn clean package -Dmaven.test.skip=true

构建jar文件, 先构建 ps-admin 模块

root@desktop-jacksen:/d02/hzero/project/ps-admin# pwd
/d02/hzero/project/ps-admin
root@desktop-jacksen:/d02/hzero/project/ps-admin# mvn clean package -Dmaven.test.skip=true
[INFO] Scanning for projects…
[INFO]
[INFO] ——————< org.hzero:ps-admin-saas-snapshot >——————
[INFO] Building ps-admin-saas 1.12.0.RELEASE
[INFO] ——————————–[ jar ]———————————
Downloading from central: https://repo.maven.apache.org/maven2/org/apache/maven/plugins/maven-clean-plugin/3.4.0/maven-clean-plugin-3.4.0.pom

……

[INFO] The original artifact has been renamed to /d02/hzero/project/ps-admin/target/app.jar.original
[INFO] ————————————————————————
[INFO] BUILD SUCCESS
[INFO] ————————————————————————
[INFO] Total time: 46.631 s

构建成功，生成了jar文件：

同样的命令构建其他模块的Jar

备注：lite在构建是报错：
1、依赖里面，hzero-lite没有指定版本号，解决方案：给他指定版本号：<version>1.12.0.RELEASE</version>

依赖里面，说mysql 连接器没有指定版本号：
<dependency>

<groupId>mysql</groupId>

<artifactId>mysql-connector-java</artifactId>

</dependency>

实际原因，参考其他模块，应该改成：

<dependency>

<groupId>com.mysql</groupId>

<artifactId>mysql-connector-j</artifactId>

</dependency>

改完之后再构建就成功了：

Downloaded from central: https://repo.maven.apache.org/maven2/org/apache/commons/commons-lang3/3.7/commons-lang3-3.7.jar (500 kB at 153 kB/s)
[INFO] Replacing main artifact with repackaged archive
[INFO]
[INFO] — spring-boot-maven-plugin:2.5.6:repackage (default) @ ps-lite-snapshot —
[INFO] Replacing main artifact with repackaged archive
[INFO] ————————————————————————
[INFO] BUILD SUCCESS
[INFO] ————————————————————————
[INFO] Total time: 01:18 min
[INFO] Finished at: 2025-06-27T19:33:54+08:00
[INFO] ————————————————————————
root@desktop-jacksen:/d02/hzero/project/ps-lite#

lowcode在构建时也报错, 解决方案与Lite类似：

[ERROR] The project org.hzero:ps-lowcode-snapshot:2.9.0.RELEASE (/d02/hzero/project/ps-lowcode/pom.xml) has 2 errors
[ERROR] ‘dependencies.dependency.version’ for org.hzero:hzero-lowcode:jar is missing. @ line 21, column 25
[ERROR] ‘dependencies.dependency.version’ for mysql:mysql-connector-java:jar is missing. @ line 40, column 25
[ERROR]

低代码modeler构建时也存在类似问题，解决方案一样；

其他模块没有问题，全部构建成功！