refactor(dacli): 移除 init --restart 虚假 flag (v3.0+)
用户反馈: --restart 历史目的是 JVM 进程级重启, 但 90% 场景根本不需要重启 JVM.
**移除**:
- .option('--restart', ...) flag
- InitAppOpts.restart 字段
- if (opts.restart) dry-run 逻辑
- installAiHelpHook --restart 引用 + example
- healthCheck 不通时的 --restart 推荐指引 (改为手动 nohup)
**保留**:
- --auto-recover (真工作, v0.11e+ B-2 fix, 检测 system 缺失时自动重建)
- 健康检查 (baseUrl + form list)
- system 缺失检测
**未来扩展** (v0.12+ 可能加, 不在本 turn 范围):
- --reload-config 调 POST /actuator/refresh (Spring Cloud RefreshScope, 替代 dry-run)
- --reload-ds 重新连接数据源
- --reload-menu 重建菜单/权限缓存
**用户决策 (2026-06-29)**: 删 --restart, 有需要场景再加. 务实.
测试: TS 编译干净 + init --help 不显示 --restart + init 实测仍工作 (健康检查 + system 完整)
This commit is contained in:
1 parent
0a0c690c16
commit
baf90faaad
1 file changed
+23
-21
+23
-21
@@ -1,8 +1,16 @@
|
||||
/**
|
||||
* commands/app/init.ts — `dacli app init` (原 `dacli app initapp`, v0.9 进一步简化为 init)
|
||||
* commands/app/init.ts — `dacli app init` (v3.0+ 移除 --restart 虚假 flag)
|
||||
*
|
||||
* 注: v0.7.1+ init 是 "JNPF 后端一键启动/重启 + 健康检查 + 重登 + 自动恢复" 工具,
|
||||
* 不是 form 初始化. 走 dacli.conf 读 jar-pattern/port, 杀进程 + nohup.
|
||||
* v3.0+ (2026-06-29) 移除 --restart 参数:
|
||||
* - 历史: v0.9 设计要实做 kill+nohup+健康检查, 一直是 dry-run (误导)
|
||||
* - 90% 场景根本不需要重启 JVM (改配置/数据源/菜单都能热加载)
|
||||
* - 真要重启: 用户手动 nohup 或后续 v0.12+ 加 `--reload-config` 热加载
|
||||
* - 用户决定 (2026-06-29): 删 --restart, 有需要场景再加
|
||||
*
|
||||
* 当前 init 职责:
|
||||
* - 健康检查 (baseUrl + form list)
|
||||
* - system 缺失检测 (v0.11e+ B-2 fix)
|
||||
* - --auto-recover (真工作, 重建 system)
|
||||
*
|
||||
* v0.11e+ Bug B-2: 检测 base_system 缺失时自动调 `app create` 重建.
|
||||
* 复盘: `dacli app clear --appCode=X` 把 base_system 中 X 删到 history_bak,
|
||||
@@ -22,7 +30,6 @@ import { healthCheck, formatHealthCheckForHuman } from '../../core/_health_check
|
||||
|
||||
interface InitAppOpts {
|
||||
appCode?: string
|
||||
restart?: boolean
|
||||
/** v0.11e+ B-2 fix: 检测到 system 缺失时自动调 app create 重建 */
|
||||
autoRecover?: boolean
|
||||
/** 同上, 重建时传给 app create 的中文名 */
|
||||
@@ -31,9 +38,8 @@ interface InitAppOpts {
|
||||
|
||||
export function buildAppInitCommand(): Command {
|
||||
const cmd = new Command('init')
|
||||
.description('应用初始化 (健康检查; --restart 重启 JNPF; --auto-recover system 缺失时自动重建; v0.11e+)')
|
||||
.description('应用初始化 (健康检查 + system 缺失检测; --auto-recover system 缺失时自动重建; v3.0+ 移除 --restart)')
|
||||
.option('--appCode <code>', '应用 code (不传则用当前登录)')
|
||||
.option('--restart', '重启 JNPF 后端 (v0.9+ 集成, 现在 dry-run)', false)
|
||||
.option('--auto-recover', 'v0.11e+ B-2: 检测到 base_system 缺失时自动调 app create 重建', false)
|
||||
.option('--appName <name>', 'auto-recover 时传给 app create 的中文名 (默认 "未知应用")')
|
||||
.action(async (opts: InitAppOpts) => {
|
||||
@@ -41,15 +47,16 @@ export function buildAppInitCommand(): Command {
|
||||
const appCode = opts.appCode || c.appCode
|
||||
|
||||
// 0. v0.11h+ (2026-06-28) BS-56-helper: baseUrl 健康检查 (前置)
|
||||
// 不通时立即给 nohup 重启指引, 避免后续 form/dm/menu 全 fail "ECONNREFUSED"
|
||||
// 不通时立即给明确指引, 避免后续 form/dm/menu 全 fail "ECONNREFUSED"
|
||||
// 注: 不带 token, 仅看 TCP + HTTP 是否可达 (与 baseUrl 探活对齐)
|
||||
// v3.0+ 调整: 不再推荐 --restart (已删除), 改为推荐手动 nohup 或后续 --reload-config
|
||||
const healthR = await healthCheck(c.baseUrl)
|
||||
log.info(formatHealthCheckForHuman(healthR))
|
||||
if (!healthR.ok) {
|
||||
// 给出明确指引 (含 --restart 提示), 但不 process.exit, 让用户决定是否继续
|
||||
log.warn('⚠ JNPF 不可达, 后续检查 (form list / system 缺失检测) 大概率失败')
|
||||
log.warn(' 推荐先恢复: dacli app init -- --appCode=<app> --restart')
|
||||
log.warn(' 或手动 nohup 拉起 JNPF (见上面指引)')
|
||||
log.warn(' 手动 nohup 拉起 JNPF (见上面 health_check 输出):')
|
||||
log.warn(' nohup java -jar jnpf-admin-*.jar --spring.profiles.active=dev &')
|
||||
log.warn(' 或后续 v0.12+ 的 --reload-config 热加载 (无需重启)')
|
||||
}
|
||||
|
||||
// 1. 健康检查: 拉 form list 看是否能返 (v0.11+ 兼容保留, 与 baseUrl 自检互为补充)
|
||||
@@ -77,24 +84,17 @@ export function buildAppInitCommand(): Command {
|
||||
log.info(` 或手动: dacli app create --appCode=${appCode} --appName=<中文名> --force-rebuild`)
|
||||
}
|
||||
}
|
||||
|
||||
// 3. --restart: v0.9+ 才实做, 现在 dry-run
|
||||
if (opts.restart) {
|
||||
log.warn('--restart 当前 v0.9+ 才实做, 现在 dry-run')
|
||||
log.info(' 计划: 读 dacli.conf 的 jar-pattern/port, kill+rm+nohup+健康检查+重登')
|
||||
}
|
||||
})
|
||||
installAiHelpHook(cmd, {
|
||||
purpose: '应用初始化 (健康检查 / 重启 JNPF / system 缺失时自动重建)',
|
||||
purpose: '应用初始化 (健康检查 + system 缺失检测; v3.0+ 移除 --restart)',
|
||||
optional: {
|
||||
'--appCode': '应用 code (不传则用当前登录)',
|
||||
'--restart': '重启 JNPF 后端 (v0.9+ 集成, 现在 dry-run)',
|
||||
'--auto-recover': 'v0.11e+ B-2: 检测到 base_system 缺失时自动调 app create 重建',
|
||||
'--appName': 'auto-recover 时传给 app create 的中文名 (默认 "未知应用")',
|
||||
},
|
||||
example: [
|
||||
'dacli app init',
|
||||
'dacli app init --appCode=tds --restart',
|
||||
'dacli app init --appCode=tds',
|
||||
'dacli app init --appCode=tds --auto-recover',
|
||||
'dacli app init --appCode=tds --auto-recover --appName=可信数据空间',
|
||||
].join('\n'),
|
||||
@@ -104,8 +104,10 @@ export function buildAppInitCommand(): Command {
|
||||
ref: 'doc/v0.8-plan.md §4 D1 + MEMORY dacli-v011e-100percent-final-2026-06-27.md (B-2); backend: jnpf/.../VisualdevController.java:506 (infoByEnCode null → NPE)',
|
||||
},
|
||||
notes: [
|
||||
'**v0.9+ 实做**: --restart 走 dacli.conf 自动 kill+nohup+健康+重登',
|
||||
'**当前**: --restart dry-run 提示计划',
|
||||
'**v3.0+ 移除 --restart**: 90% 场景不需要 JVM 重启 (热加载/手动 nohup 都能解决)',
|
||||
' 历史: v0.9 设计 kill+nohup+健康检查, 一直是 dry-run (误导)',
|
||||
' 后续 v0.12+ 可能加 --reload-config (actuator/refresh) 热加载替代',
|
||||
'**当前 init 职责**: 健康检查 + system 缺失检测 + --auto-recover 重建',
|
||||
'**v0.11e+ B-2 fix**: --auto-recover 检测 base_system 缺失时, 自动调 app create 重建',
|
||||
' appName 优先级: --appName 参数 > 兜底 "未知应用"',
|
||||
' 重建后会重新 login 到新 appCode 并自动重登',
|
||||
|
||||
Reference in new issue
Block a user