中国 帮助

应用生命周期

这一页讲七个生命周期动作(部署 / 安装 / 升级 / 停用 / 启用 / 卸载 / 彻底删除)在后端各自做了什么、按什么顺序做、失败停在哪一步,以及「彻底删除」为什么会被一道共享闸拦下一半。它面向要改安装或卸载流程的人。 界面上的操作入

应用生命周期
封面

> 本文整理自平台文档 docs/wujies/1.x/advanced/lifecycle.mdx,用于站点内容演示。

(https://console.wujies.cn/remote-apps/cms-assets/doc-50954fd3b39c-cover.svg)

这一页讲七个生命周期动作(部署 / 安装 / 升级 / 停用 / 启用 / 卸载 / 彻底删除)在后端各自做了什么、按什么顺序做、失败停在哪一步,以及「彻底删除」为什么会被一道共享闸拦下一半。它面向要改安装或卸载流程的人。

界面上的操作入口与排查速查见 [在部署里使用应用](/docs/wujies/1.x/basics/using-apps),任务日志怎么读见 [任务中心与日志](/docs/wujies/1.x/ops/task-center)。

实现全在 wujies-platform/wujies-modules/wujies-app-market/src/main/java/cn/wujies/appmarket/;下面每个结论都标了类名或配置键,可以逐条核对。

编排的收口:一个入口、一张状态机

环节类文件
生命周期入口与状态推进AppInstallServiceImpl(实现 IAppInstallService)service/impl/AppInstallServiceImpl.java
合法迁移表AppLifecycleStateMachinestate/AppLifecycleStateMachine.java
状态编码与中文名AppInstallStatusenums/AppInstallStatus.java
执行器选择AppInstaller.supports()spi/AppInstaller.java
插件型执行器PluginAppInstaller extends ModuleAppInstallerspi/impl/PluginAppInstaller.java
模块型执行器ModuleAppInstallerspi/impl/ModuleAppInstaller.java
进度边跑边落库AppTaskRecorder(ThreadLocal)support/AppTaskRecorder.java
任务表实体AppInstallTask、AppTaskType、AppTaskStatusdomain/、enums/

执行器按清单里的 type 选:AppInstallServiceImpl.requireInstaller 用 installer.supports(manifest) 过滤,默认实现就是比 manifest.type 与 installer.type()。AppInstaller 的注释里预留了 module / plugin / deploy 三种,但 spi/impl/ 下只有前两种有实现类 —— 清单写 type: deploy 会报「没有可处理该应用的安装器」。

### 合法迁移表

起点是 app_install.status 的当前值(AppInstallStatus,无记录表示"未安装"):

起始状态允许到达
无记录(未安装)installing
installinginstalled、failed
installedenabled、uninstalling、failed
enableddisabled、upgrading、uninstalling、failed
disabledenabled、upgrading、uninstalling、failed
upgradingenabled、disabled、failed
failedinstalling、upgrading、uninstalling、uninstalled
uninstallinguninstalled、failed
uninstalledinstalling

四条读表时容易忽略的:

  • 只有 enabled 算"对本租户可见"(AppLifecycleStateMachine.isVisible);installed 不可见。
  • installed 只是路径中间态。安装的成功路径是 installing → installed → enabled(装完即启用),而 successPathOf 的终态才落库 —— 所以实际停靠的状态里不会出现 installed。
  • 升级保留原启停状态:路径写成 upgrading → disabled(原本停用)或 upgrading → enabled。
  • 没有任何状态能直达 uninstalled,必须先过 uninstalling。历史上有一次把卸载路径写成 [uninstalled],于是 disabled → uninstalled 直接抛「非法的应用状态迁移」—— 现在所有路径集中在 successPathOf 一处,就是为了不再各写一份。

### runTask 的三条实现约束

1. 整条路径先校验、后执行:AppInstallServiceImpl.runTask 在插入 app_install_task 之前把成功路径逐跳喂给 AppLifecycleStateMachine.transit。非法就抛「非法的应用状态迁移: …」,而且不产生任务行。 2. "已处于目标状态"只对三类动作生效(goalStatusOf):启用 / 停用 / 卸载。安装与升级刻意不做这个判断 —— 升级一个已停用的应用时路径终态恰好等于当前状态(upgrading → disabled),按终态判重会把"已停用的应用升不了级"做成一个死结。 3. 失败必须落库,连 Error 一起捕:markFailed 把 app_install_task.status 置 failed 并写 error_msg,同时把 app_install.status 也置 failed。只捕 RuntimeException 是不够的 —— NoClassDefFoundError、OOM 会让任务永远停在 running(前端看到"一直在跑",其实早就死了),这是实测踩到过的。

任务类型枚举 AppTaskType 里有 repair(修复)与 rollback(回滚),但 successPathOf 对这两个直接抛 UnsupportedOperationException("尚未实现的生命周期动作") —— 它们目前只是预留。

七个动作各自做了什么

动作接口(权限)后端真实行为状态
部署POST /app/version/{versionId}/deploy(app:console:edit)拉包校验 → 落位 → 热加载。不跑迁移脚本,也不改安装记录不动 app_install
安装POST /app/install(app:install:add)落位 → 迁移 → 断言后端已加载 → 按清单幂等 upsert 菜单 + 授权给本租户管理员角色installing → installed → enabled
升级POST /app/install/{installId}/upgrade?versionId=(app:install:edit)同安装,但强制重新落位;成功后把 app_install.version_id 落成目标版本enabled/disabled → upgrading → 原状态
启用POST /app/install/{installId}/enable先 load 把后端装回运行时,再补授权installed/disabled → enabled
停用POST /app/install/{installId}/disable只 unload;菜单行与授权都保留enabled → disabled
卸载(保留数据,默认)POST /app/install/{installId}/uninstall(purge 缺省 false)撤本租户菜单授权 + unload;菜单行、数据表、迁移记录、本机产物全留→ uninstalling → uninstalled
彻底删除同一条接口 + ?purge=true上面那些 + AppPurgeService.purge()(见下文),最后物理删 app_install 那一行同上

接口清单与权限标识见 [HTTP 接口索引](/docs/wujies/1.x/reference/api)。

  • 安装请求体只有 appCode 与 tenantId(AppInstallBo),版本由目录的 requireLatestVersion(appId)

本文导览

(https://console.wujies.cn/remote-apps/cms-assets/doc-50954fd3b39c-guide.svg)

章节导览
THE END

喜欢就支持以下吧

评论区需要浏览器启用 JavaScript 才能加载。

回到内容