@newbeebox/newbeebox-app-engine-cli 1.0.3 → 1.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@newbeebox/newbeebox-app-engine-cli",
-  "version": "1.0.3",
+  "version": "1.2.0",
   "description": "NewBee App Engine 命令行客户端（nae）——参数直达、默认人类可读（加 -o json 出 JSON），便于在终端使用与脚本/管道里解析。",
   "type": "module",
   "bin": {

package/src/index.js

@@ -2,6 +2,7 @@
 // nae —— NewBee App Engine 命令行客户端。
 // 设计：薄壳。每条命令只做「取配置 → 调一个 HTTP 原语 → JSON 出 stdout」，
 // 鉴权/网络/业务错误集中在 run() 归类处理，命令体里不写 try/catch。
+import { readFileSync } from 'fs'
 import { Command } from 'commander'
 import { load, save, configPath } from './config.js'
 import { request, AuthError, NetworkError } from './http.js'
@@ -14,7 +15,7 @@ const program = new Command()
 program
   .name('nae')
   .description('NewBee App Engine CLI —— 默认人类可读，-o json 输出 JSON 供脚本解析')
-  .version('1.0.3')
+  .version('1.2.0')
   .option('--base-url <url>', '覆盖平台地址（也可用环境变量 NAE_BASE_URL）')
   .option('--token <token>', '覆盖访问密钥（也可用环境变量 NAE_TOKEN）')
   .option('-o, --output <format>', '输出格式：text（默认，人类可读）| json', 'text')
@@ -72,6 +73,25 @@ function parseJSONArg(label, s) {
   }
 }
 
+// 环境变量来源：--env-file 优先（从文件读 JSON，绕开 shell 引号），否则 --env 内联 JSON。
+// 两者都没给返回 undefined（create 表示不带 env / update 表示不改 env）。
+function envFromOpts(opts) {
+  if (opts.envFile !== undefined) {
+    let raw
+    try {
+      raw = readFileSync(opts.envFile, 'utf8')
+    } catch (e) {
+      throw new Error(`--env-file 读取失败：${opts.envFile}（${e.message}）`)
+    }
+    try {
+      return JSON.parse(raw)
+    } catch {
+      throw new Error(`--env-file 内容不是合法 JSON：${opts.envFile}`)
+    }
+  }
+  return parseJSONArg('--env', opts.env)
+}
+
 // --- 认证 ---
 
 program
@@ -174,9 +194,10 @@ program
   .option('--storage <size>', '模板应用：持久卷大小，如 10Gi')
   .option('--replicas <n>', '副本数', (v) => parseInt(v, 10))
   .option('--env <json>', '环境变量 JSON，如 \'{"KEY":"val"}\'')
+  .option('--env-file <path>', '从文件读环境变量 JSON（绕开 Windows PowerShell 引号问题；与 --env 二选一，优先 --env-file）')
   .option(
     '--config <json>',
-    "模板应用的服务特性参数 JSON。可用字段随模板而定，运行 'nae templates' 看每个模板的 ConfigSchema（key/类型/默认值/可选项）。redis: {\"password\",\"persistence\":\"rdb|aof|none\"}；milvus: {\"root_password\"}"
+    "模板应用的服务特性参数 JSON。可用字段随模板而定，运行 'nae templates' 看每个模板的 ConfigSchema（key/类型/默认值/可选项）。redis: {\"password\",\"persistence\":\"rdb|aof|none\"}；postgres: {\"database\",\"username\",\"password\"}；milvus: {\"root_password\"}"
   )
   .option('--owner <uid>', '管理员代他人创建时的归属用户 ID', (v) => parseInt(v, 10))
   .addHelpText(
@@ -193,6 +214,10 @@ program
   nae create --kind template --app-id myredis --template redis --storage 2Gi \\
     --config '{"password":"s3cret","persistence":"rdb"}'
 
+  # 模板应用 PostgreSQL 14：持久化 + 库名/用户名/密码
+  nae create --kind template --app-id mypg --template postgres --storage 5Gi \\
+    --config '{"database":"appdb","username":"appuser","password":"s3cret"}'
+
   # 模板应用 Milvus
   nae create --kind template --app-id myvec --template milvus --storage 10Gi \\
     --config '{"root_password":"s3cret"}'
@@ -213,7 +238,7 @@ program
         template_key: opts.template,
         storage_size: opts.storage,
         replicas: opts.replicas,
-        env: parseJSONArg('--env', opts.env),
+        env: envFromOpts(opts),
         config: parseJSONArg('--config', opts.config),
         owner_id: opts.owner,
       }
@@ -221,6 +246,48 @@ program
     })
   )
 
+program
+  .command('update <appid>')
+  .description(
+    '修改应用配置（端口/资源/env/跟踪tag/重启上限/路由前缀）。读-改-写：只覆盖你传的字段，其余保持不变。改后需 restart（运行中）或下次 start 才生效。env/端口/tag/前缀仅普通应用可改；AppID/类型/归属/存储/模板不可改（需删除重建）'
+  )
+  .option('--port <n>', '容器端口（仅普通应用）', (v) => parseInt(v, 10))
+  .option('--cpu <limit>', 'CPU 上限，如 1 / 500m')
+  .option('--mem <limit>', '内存上限，如 512Mi / 1Gi')
+  .option('--tag <tag>', '跟踪的镜像 tag（仅普通应用）')
+  .option('--max-restarts <n>', '失败重启上限，0=不封顶（仅普通应用）', (v) => parseInt(v, 10))
+  .option('--keep-path-prefix', '不剥离 /apps/<appid> 前缀（仅普通应用）')
+  .option('--strip-path-prefix', '剥离 /apps/<appid> 前缀（仅普通应用；与 --keep-path-prefix 互斥）')
+  .option('--env <json>', '环境变量 JSON（整体替换，仅普通应用）')
+  .option('--env-file <path>', '从文件读环境变量 JSON（整体替换；绕开 PowerShell 引号；与 --env 二选一，优先 --env-file）')
+  .action(
+    run(async (appid, opts) => {
+      if (opts.keepPathPrefix && opts.stripPathPrefix) {
+        throw new Error('--keep-path-prefix 与 --strip-path-prefix 互斥，只能给一个')
+      }
+      const c = cfg()
+      // 读-改-写：PATCH 是整体替换语义，必须以当前配置为基线，只覆盖本次传入的字段，
+      // 否则没传的字段会被抹成零值。三态 path 前缀：两个 flag 都不传则沿用当前值。
+      const cur = await request(c, 'GET', `/apps/${appid}`)
+      const envOverride = envFromOpts(opts)
+      const body = {
+        cpu_limit: opts.cpu ?? cur.CPULimit,
+        mem_limit: opts.mem ?? cur.MemLimit,
+        container_port: opts.port ?? cur.ContainerPort,
+        tracked_tag: opts.tag ?? cur.TrackedTag,
+        max_restarts: opts.maxRestarts ?? cur.MaxRestarts,
+        keep_path_prefix: opts.keepPathPrefix
+          ? true
+          : opts.stripPathPrefix
+            ? false
+            : cur.KeepPathPrefix,
+        env: envOverride ?? JSON.parse(cur.EnvJSON || '{}'),
+        sensitive_keys: JSON.parse(cur.SensitiveEnvJSON || '[]'),
+      }
+      emit(await request(c, 'PATCH', `/apps/${appid}`, { body }))
+    })
+  )
+
 program
   .command('delete <appid>')
   .description('删除应用（模板级联清子服务/PVC/secret），幂等')
@@ -247,6 +314,20 @@ program
   .description('滚动重启应用')
   .action(run(async (id) => emit(await request(cfg(), 'POST', `/apps/${id}/restart`))))
 
+program
+  .command('reset-password <appid>')
+  .description('重置模板应用连接密码（不清数据；当前支持 Redis/PostgreSQL）。留空 --password 则随机生成')
+  .option('--password <pw>', '指定新密码（留空=平台随机生成；可打印 ASCII，1-128 位）')
+  .action(
+    run(async (id, opts) => {
+      emit(
+        await request(cfg(), 'POST', `/apps/${id}/reset-credential`, {
+          body: { password: opts.password ?? '' },
+        })
+      )
+    })
+  )
+
 program
   .command('scale <appid> <replicas>')
   .description('扩缩容到指定副本数')