线上 BeX5 快速更新
BeX5 部署到平台上之后,线下还在新开发或者修改,新开发或者修改的内容线上需要快速更新,可以使用增量更新补丁 curlPath 组件实现,具体如下:
应用模版架构中添加增量更新补丁组件
打开应用模版的 ide 切换到架构
从架构市场组件中添加增量更新补丁组件
拖拽增量更新补丁组件到架构中,点保存并根据提示重启 ide
重启后打开架构,切换到运行架构,配置增量更新补丁组件的远程 patch 地址,用于下载增量包
运行租户中应用
- 是池模式部署,切换到运行架构(POOL),配置远程 patch 地址
- 是 kube 模式部署,切换运行架构(KUBE),配置远程 patch 地址
- 如果不确定,可以两个都配置远程 patch 地址
增量包的名字是 patch.tar.gz,远程 patch 地址需要是 http 或者 https 开头到 patch.tar.gz 结束的完整地址,此地址在平台中能够访问的。如:https://mnewjs014-js01-ide.trunk.xcaas.net/x5/UI2/mobile/patch.tar.gz
配置后保存,然后重新发布模版
制作增量包 patch.tar.gz
增量包的目录是 patch,在 patch 下有 model 目录(模型资源)和 patch.properties(增量配置文件)
patch.properties 的格式如下:
enable=true
version=主版本号_X
delete=/UI2/SA,/UI2/OA,/BIZ/demo,/UI2/demo
说明:
- enable:true 是进行更新,当有增量包不需要更新时可以配置为 false
- version:主版本号就是应用模版每次发布后运行时的版本号,应用模版不发布或者发布后运行环境中没有升级(一般都是默认自动升级的),主版本号是不会变的,增量包更新的时候只需要修改_X 中的 X,可以从0开始,每次加1的方式变化
- 主版本获取方式
https://域名/x5/UI2/sys_version.txt
,域名使用通过应用模版添加的任何一个应用的运行时域名都可以,可以在运行时租户管理员登录后的应用/服务管理列表中查看。如使用 portal 的:https://portaljsx54-vip.trunk.xcaas.net/x5/UI2/sys_version.txt
- delete:配置要删除的目录或者文件,需要是从 /BIZ 或 /UI2 开头的完整路径
如果没有要删除的,delete 可以不用配置,patch.properties 中只配置 enable 和 version,如下:
enable=true
version=a1669253549329_3
model 下就是要更新的资源,如果有 java 必须带相应的 class 文件,即有 src 目录需要有对应的 classes 目录,有 dsrc 目录需要有对应的 dclasses 目录
需要更新的资源和 patch.properties 中的版本号等都修改配置好之后,就可以制作增量包 patch.tar.gz,
制作增量包 patch.tar.gz 时需要注意:要进入到 patch 目录中操作,可以选中 model 和 patch.properties 用 7zip 工具压缩为 tar,然后在把 tar 压缩为 gzip
如果没有 7zip 可以从链接:https://eyun.baidu.com/s/3dQL2pg 密码:Neeg 中下载 glib.zip,下载后解压到任意目录(建议解压到 bex5/tools/git),然后点解压目录里面的 git-bash.exe 执行命令生成增量包,如 patch 目录在压缩 D 盘的 bex5 目录下,执行如下:
cd /d/bex5/patch
tar -czvf /d/patch.tar.gz *
增量包制作成功后就可以把 patchpatch.tar.gz 放到配置的远程 patch 地址下
将所有应用的池解绑
增量包上传放置到配置的远程 patch,配置后重启运行租户中的应用,重启成功后,增量包中的内容就可以起作用。重启应用的时候需要注意使用同一个模版的应用都重启确保资源的一致性。
注意:在某些场景下不想使用增量资源时(例如通过模版完整发布),在池解绑前,删除增量资源或修改 patch.properties 中的 enable=false
所以只是增量包的方式更新时不需要重新发布模版,只需要制作增量包(注意修改配置文件中版本号),上传增量包至配置的远程 patch 路径下,然后重启运行租户中的应用即可。