Jacksen的技术博客

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

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

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

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

九、aPaaS低代码平台安装：

在/d02目录下新建目录hzero-apaas

ls -al ~/.ssh/id_rsa.pub  # 查看RSA密钥,如果没有密钥，创建一个：

ssh-keygen -t rsa -b 4096 -C “your_email@example.com”  # 生成RSA密钥

在生成过程中，按提示连续按回车键即可，无需设置密码。

cat ~/.ssh/id_rsa.pub  #查看密钥，把看到的密钥在猪齿鱼平台填入

ssh -T git@code.choerodon.com.cn  #验证，正常会看到欢迎词

然后可以按文档指示下载种子数据工程了:

git clone -b 2.9-release git@code.choerodon.com.cn:hzero-hlod/hzero-lowcode-resource.git

下周三（7月16日）飞搭产品团队会发2.10版本的产品，新增功能比较多，比如零代码开发能力、AI辅助设计能力、支持通用组件开发能力等等都是大功能；

2.10版本会发两个版本，for-hzero-1.11 和for-hzero-1.12两个版本；之所以会发两个版本是因为hzero 1.11 到 1.12 JDK版本做了大升级，从JDK 8升级到了 JDK 17;  飞搭要分别为hzero 1.11的客户提供JDK8的客户端，为hzero 1.12的客户提供JDK 17的客户端；

飞搭 2.11版本之后将不再兼容hzero 1.11版本；

今天是7月16日，得到消息是2.10的测试未完成，不能按计划发版，那就先安装2.9版本的，目前DIST 文件是7月9日构建的 前端全模块工程，里面的飞搭前端版本是 2.9.1-beta.5 ， 这个前端版本对应的后端飞搭服务版本适配 hzero 1.12 ，需要的后端服务是2.9 -1.12

先安装数据库

1.1 编辑服务的application.yml文件在数据库链接rul中添加：allowPublicKeyRetrieval=true ，然后运行database-init.sh ，启动web页面，成功导入：

但现在以hzero 1.12.1父组件选配低代码组件，得到的是2.10版的，所以数据要升级到2.10版

git clone -b 2.10-release git@code.choerodon.com.cn:hzero-hlod/hzero-lowcode-resource.git

可惜运行第一步更新数据库出错，是数据库URL里面多了一个/, 估计是版本数据有问题，未经充分测试，故意防止其他人成功运行，以免破坏数据的。

那这样的话，我们就还是安装2.9.0 for hzero1.12的版本吧，把选配下来的工程更改下依赖的版本就好了，支持组给了一个产品组打的包，版本号是：2.9.1-1.12.BETA.6，父组件也设置为这个版本。

1、启动model服务

1. 编辑服务的application.yml文件在数据库链接rul中添加：allowPublicKeyRetrieval=true

1.2  编辑 服务的bootstrap.yml 文件，在 spring.cloud层级下添加网卡选择：

    inetutils:

      # 设置首选网卡，对于本机有多块网卡的情况，可以设置首选网卡来注册

      # 指定忽略的网卡

      ignored-interfaces[0]: lo

      # 选择注册的网段

      preferred-networks[0]: 172.18.14.48

1.3 把原来服务模块下的run.sh 和stop.sh都拷贝过来；

编辑run.sh ,把端口号改成跟服务的 bootstrap.yml文件中定义的端口号一致，把 AGENT 变量改成

-javaagent:/d02/hzero/project/ps-license/licenseAgent/license-agent111.jar

服务构建成功，但启动失败，同样的工程支持组同事在他本地是可以成功启动服务的，那就把本地仓库中的hzero目录下的内容清掉再试；

cd /root/.m2/repository/org/hzero

rm -rf ./*

再重新启动 sh run.sh  问题依旧。 经测试发现，如果在启动命令中用agent103 就会出现找不到类的错误：java.lang.NoClassDefFoundError: org/springframework/core/NestedIOException

如果启动命令中不用javaaget参数或者用agent111就不会出现找不到类的错误；

构建Maven依赖树，输出内容粘贴到记事本，然后查找license ,可以看到依赖的版本，

mvn dependency:tree | grep -i license

如果父组件依赖的是

<parent>

        <groupId>org.hzero</groupId>

        <artifactId>hzero-apaas-parent</artifactId>

        <version>2.9.1-1.12.BETA.6</version>

    </parent>

那么Maven树里面依赖的license就是1.1.0.BETA 版本的

如果父组件依赖的是

    <parent>

        <groupId>org.hzero</groupId>

        <artifactId>hzero-parent</artifactId>

        <version>1.12.1.RELEASE</version>

    </parent>

那么Maven树里面依赖的license 就是1.1.2版本的

这说明2.9.1-1.12.BETA.6版本的model服务依赖的是1.1.0.BETA版本的license服务，应该使用license-agent110.jar ；

在run.sh 中更换javaAgent启动参数为license-agent110.jar 后再次启动就能正常启动了，License那段检查过了，日志停在提示

***************************
APPLICATION FAILED TO START
***************************

Description:

Failed to bind properties under ‘hzero.lock.single-server.port’ to int:

Property: hzero.lock.single-server.port
Value: “${spring.redis.port}”
Origin: class path resource [application.yml] from ps-modeler.jar – 186:13
Reason: failed to convert java.lang.String to int (caused by java.lang.NumberFormatException: For input string: “${spring.redis.port}”)

Action:

Update your application’s configuration

把application.yml文件中redis 配置换位老的格式，就正常启动了

不过日志中一直提示不健康，不能注册到Admin

2025-07-16T21:34:10.627+08:00 ERROR 132048 — [hzero-modeler] [ration-Executor] o.h.boot.admin.AdminAutoRegistration     : [hzero-modeler] is unhealthy, cannot be registered to the admin

2025-07-16T21:34:15.643+08:00 ERROR 132048 — [hzero-modeler] [  XNIO-1 task-2]

324043

2、启动lowercode服务

1. 编辑服务的application.yml文件在数据库链接rul中添加：allowPublicKeyRetrieval=true

1.2  编辑 服务的bootstrap.yml 文件，在 spring.cloud层级下添加网卡选择：

    inetutils:

      # 设置首选网卡，对于本机有多块网卡的情况，可以设置首选网卡来注册

      # 指定忽略的网卡

      ignored-interfaces[0]: lo

      # 选择注册的网段

      preferred-networks[0]: 172.18.14.48

1.3 把原来服务模块下的run.sh 和stop.sh都拷贝过来；

编辑run.sh ,把端口号改成跟服务的 bootstrap.yml文件中定义的端口号一致，把 AGENT 变量改成

-javaagent:/d02/hzero/project/ps-license/licenseAgent/license-agent111.jar

• 启动LowCode服务

   所需配置改动跟model服务类似，启动之后在注册中心可见