企业级独立部署配置方法

INFO

独立部署仅针对 企业版 开放

独立部署依赖项

• 云兔提供SQL脚本，完成建表语句和数据导入，当前需要云兔工程师提供导出，后续会支持自助导出

• 下载云兔独立部署SDK，原则上建议下载和使用最新版本的二方包

  • github下载地址：https://github.com/orgs/lovrabet-ai/packages

• 下载云兔独立部署demo工程（github仓库：git@github.com:lovrabet-ai/standalone-demo-jdk21.git）

  • 针对JDK不同的版本，提供JDK8和JDK8以上（11、17、21）不同的版本，按需下载使用
  • jdk8，请使用lovrabet-runtime-adapter-spring5的包
  • jdk11-21，请使用lovrabet-runtime-adapter-spring6的包
  • lovrabet-runtime-adapter-spring5和lovrabet-runtime-adapter-spring6会间接依赖lovrabet-runtime-core包，两者需使用相同的版本号，比如都是1.0.6

• 二方包SDK仓库地址（需授权）：https://packages.aliyun.com/maven/repo-lovrabet/artifacts

demo工程说明

工程结构

• 标准的Springboot+MybatisPlus工程结构
• demo工程中提供了原始的Controller类，Controller依赖的核心Service是依赖云兔二方包
• 用户登录、系统鉴权相关的完全可以自定义，云兔提供了默认的注解+切面的方式，实际应用中也可以在此基础上进行扩展
• 在启动类的MapperScan配置系统依赖所需要的mapper地址

@MapperScan(basePackages = {"com.lovrabet.runtime.model.metadata.mapper", "com.lovrabet.runtime.dao.mapper",
        "com.lovrabet.runtime.model.metadata.core.mapper"})

配置项说明

在application配置文件中的核心配置项说明如下

• appCode：应用code
• apiDomain：自定义的API接口域名（支持path前缀）
• rendererVersion和appPlatformVersion是前端资源依赖的版本

lovrabet:
  appCode: app-c2dd52a2
  apiDomain: http://127.0.0.1:8080
  rendererVersion: 1.1.28
  appPlatformVersion: 1.5.16

前端资源

• 云兔默认提供了阿里云CDN的前端资源，demo试用可以直接体验
• 在实际开发和部署环境，建议替换成适配自己企业的静态资源存储方案

自定义path配置

在实际工程场景中，除了域名是自定义的，可能也需要在API域名后面加统一的path前缀。

以增加统一前缀「/demo」为例，详细配置如下：

step1，在application配置文件中，调整apiDomain配置

apiDomain: http://127.0.0.1:8080/demo

step2，在springboot的WebConfig类中配置统一path前缀。这部分代码默认是注释掉的，请按照实际需要使用即可

@Override
public void configurePathMatch(PathMatchConfigurer configurer) {
    // 为所有控制器添加统一的前缀，比如：/demo
    configurer.addPathPrefix("/demo", clazz -> clazz.isAnnotationPresent(RestController.class));
}

后续升级迭代

绝大部分的集成是一次性的，后续可能需要升级的包括：

• 新增和修改了页面，需要导出页面和菜单相关的数据进行升级
• 基础功能升级，比如新增了组件类型，升级SDK版本号，前端资源版本号

独立部署菜单

• 默认会使用云兔的菜单
• 如果是源码开发子应用的场景，希望使用自己的菜单，根据isInIcestark判断是否渲染导航，参考逻辑：

https://github.com/lovrabet/sub-app-react-demo/blob/main/src/layouts/MainLayout.tsx#L156