@gbits-jszx/gw-cli
v2026.1110.2-abfbc16
Published
GW-Framework build, publish and k3s delivery CLI
Readme
@gbits-jszx/gw-cli
应用 Helm 安装/更新成功后打印本次解析的项目访问地址;内部存储准备、失败、dry-run 和未配置地址时不打印该入口。WSL / 云 VM 完整命令从 config new 开始,正常流程不要求指定认证路径。
源码已支持残留控制记录的受控恢复:普通/强制启动先持有运行锁并核验实例归属,记录中管理器/服务/构建进程全部退出才回收;存活或复用PID、权限不足及记录变化继续拒绝。已有本机PostgreSQL缺凭据时拒绝生成替代密码。此修复需发布后才进入npm,当前仅为源码行为。
VM首装init自动识别CLI私有registry、Helm默认~/.config/helm/registry/config.json及Docker默认~/.docker/config.json,尊重官方环境路径;缺少有效登录时提示用户名和隐藏密码/Token。认证先于存储写入,重复init仍检查;只导入当前仓库,原Helm/Docker文件保持。无需额外registry-config,正常init/install仍只传project-id/version/tag,详见仓库认证。
本次发布增加整命名空间清空与单项目配置移除:npx -y --prefer-online @gbits-jszx/gw-cli@latest --project-id authgateway deploy k3s destroy --namespace authgateway --namespace-wide --reason approved-fresh-install --dry-run;npx -y --prefer-online @gbits-jszx/gw-cli@latest --project-id authgateway config remove --dry-run。实际执行须携带当前approval摘要;命名空间内数据库/PVC永久删除,配置先私有备份并仅移除指定项目。完整清空说明区分源码与npm发布状态。
本轮发布包含受控恢复预览:npx -y --prefer-online @gbits-jszx/gw-cli@latest --project-id authgateway deploy helm uninstall --namespace authgateway --release authgateway-pg --recover-pending-install --dry-run。操作者先确认各机器部署均已退出;仅接受首次revision1、Pod从未启动、无外部依赖的挂起安装。先备份、复核后正常卸载,保留PVC并恢复相同凭据;普通挂起升级仍拒绝。历史终态Job与Pod不阻断启停,同namespace的Traefik路由受限支持卸载。日常使用 @latest,精确版本以 --version 和npm发布记录为准。版本号在打包阶段同时写入package.json和Windows/Linux原生程序。
本轮包包含根 gw.tasks.yaml 任务模式,run/build/test 和 process status/stop/restart/logs 共用定义,支持 run/build/test --dry-run;见 项目任务与进程管理。以下旧固定映射、端口清理和数据库参数说明只适用于无任务表的兼容路径;任务模式首次迁移先停止旧 run,db/部署不变。
AuthGateway 源码命令 go run ./tools/cli all 准备 PostgreSQL 单库并启动 AuthGW(内置 IAM)、Web、Mock;标准入口是 go run ./tools/cli --project-id authgateway run all。独立 iam 目标已删除,test core 覆盖内置 IAM;普通重启不删库。下方 Demo 说明仅适用于上游框架。
面向多个网关项目的跨平台构建、运行和交付工具。项目级命令的身份唯一来自显式 --project-id <代号>(或 --project-id=<代号>);不需要 gw.project.yaml,不接受旧 --project 路径,也不从 GW_PROJECT_FILE 或用户凭据中的旧 ID 兜底。npm build/package/publish 专用于维护 CLI 本身,不要求项目代号,包名固定为 @gbits-jszx/gw-cli。
当前公开版本为
@gbits-jszx/gw-cli@latest。公网使用npx -y --prefer-online @gbits-jszx/gw-cli@latest;没有 Node/npm 的 Linux/WSL 可直接运行包内bin/native/gw-cli-linux-amd64。源码开发继续使用go run ./tools/cli。默认
all、部署版本自动选择、npm 全局账本和 Helm 部署进度均已进入当前 npm 版本。
PC 开发构建发布、WSL/云 VM 初始化部署更新。公网 registry 为 https://registry.npmjs.org/,包内包含 Windows amd64 和 Linux amd64(含 WSL)二进制。
WSL 必须使用安装在 WSL 内的 Linux Node/npm。若 type -a node npm npx 指向 /mnt/c/...,或 node -p "process.platform" 输出 win32,应先切换到 WSL 原生 Node。即使 Node 正确,也不要在包含 Windows 侧 node_modules 的 /mnt/c/Users/<用户> 下运行;npm 会把它识别为本地项目并污染 WSL 的 bin 查找,表现为 Path contains delimiter (":") / gw-cli: not found。切到 WSL home 或实际仓库后再执行:
cd /mnt/g/Git/Wurq/Projects/GW-Framework
npx -y --prefer-online @gbits-jszx/gw-cli@latest --version打包过程和最终 .tgz 全部位于仓库根目录 .gw-build/npm/;源码目录不会生成 bin/native 或被 npm version 改写。
端口调试与新项目
debug port kill <端口> 已包含在当前 npm 版本中,也可使用源码验证:
go run ./tools/cli debug port kill 18080 --dry-run
go run ./tools/cli debug port kill 18080无需项目代号,查询指定端口的 TCP 监听和 UDP 绑定 PID,并强制结束对应进程。--dry-run 仅预览;不清理远端连接,不跨 Windows/WSL,不自动提权或结束进程树。Linux/WSL 需要 ss(iproute2);查询权限不足或清理失败会返回非零退出码。正在运行的 run all 若有一个 app 被结束,监督进程会退出并清理其余 app 和临时数据库;清理后的占用查询会发现自动重启,但不会自动追杀新 PID。
Windows 默认 run all 启动本机 app,连接 db start 管理的本机持久 PostgreSQL(127.0.0.1:15433);不是 k3s Pod。一次性数据库显式使用 run all --database temporary,默认映射 127.0.0.1:55432,退出时回收容器和数据;--target local|wsl 只控制该临时模式的 Docker 执行位置。
任务表项目使用 run all --force 先独立编译,失败/取消保留旧实例,通过后才经独立认证通道通知 app/Vite 退出,并行最多等待 20 秒,超时才强杀剩余进程;构建立即取消,不等待串行编译。AuthGW 自身排空上限 15 秒;Windows Vite/npm 经专属 stdin EOF 和 Node 预加载适配触发 Vite 自身清理,完成后 npm 自然结束;无响应进程才由超时回收。新适配须重启 CLI 管理器一次生效。请求确认上限 5 秒,随后最多等 30 秒获取运行锁。状态快照位于 .gw-build/local/tasks//run.json,凭据仍留在用户私有目录。此行为以当前源码版为准(管理器协议 4),发布 npm 后才进入对应 npm 版本。首次迁移先退出旧管理器再启动;无任务表项目保留原可执行文件归属校验。单目标不支持 --force,无关进程和持久数据库不在终止范围。
CLI 当前不提供新项目源码脚手架;先准备框架源码布局,再运行 config new 交互登记用户级项目配置。它不会生成目录或改写 Go module;deploy k3s init 只初始化集群资源。完整步骤见新项目接入。
npm build 与 npm package 等价,从当前源码编译 Windows/Linux CLI 并生成 .tgz。编译期间每 5 秒报告已用时间,完成时显示各平台二进制大小、npm 文件清单、压缩包文件名、输出目录和总耗时;任何阶段失败都会保留原始错误并返回非零退出码。npm publish / publish npm 每次重新构建,并在默认自动编号下分配新的 npm 版本,不直接上传之前 build 的归档。源码 go run ./tools/cli --version 显示嵌入的源码基线 2026.9.11-2;打包阶段才把发布版本注入二进制和 package.json。
停止本机任务
本轮包包含顶层停止命令,原 process stop 保留兼容:
go run ./tools/cli --project-id authgateway stop all
go run ./tools/cli --project-id authgateway stop all --force默认并行通知服务退出,最多等 20 秒再强杀,最多等 30 秒释放运行锁;显式 --force 不通知、不排空,直接强杀所属服务/Vite/构建,最多等 10 秒收尾并释放锁。整组停止均走独立认证通道,请求确认上限 5 秒;强杀仅支持 all,可打断已开始的优雅退出。协议 4 支持两种方式;协议 2 仅在显式强杀时复用原 force 通道,协议 3 需先优雅停止再升级后使用强杀。管理器失联不按旧 PID 或端口杀进程。run all --force 先编译预检,通过后优雅退出并复用产物启动;含自定义prepare的force暂拒绝。无控制记录且锁空闲时stop提示无需停止;锁占用/损坏/权限错误仍报错。
日期版本号
npm、Image、Chart 使用相同的 yyyy.Mdd.id-short_sha1 格式,例如 2026.914.1-d3844db,不要求三者同号。Mdd 是去除整体前导零的 MMdd,id 是当天序号并作为 SemVer patch。npm 在 CLI 全局范围独立编号;Image/Chart 按项目和制品类型编号。npm build、npm package、npm publish 和 publish npm 默认 --version auto,使用执行机器的本地日期、当天序号和当前仓库 HEAD 的 7 位 Git SHA;序号从 1 开始、同日递增、跨日重置。也可用完整版本显式重建未发布版本;日期须有效,核心数字段和序号不得带前导零。
该格式可直接被 npm 和 Helm 解析为 SemVer:yyyy.Mdd.id 是 major/minor/patch,short_sha1 是 prerelease 标识。字面 yyyy.MMdd.short_sha1-number 不能直接使用,因为 MMDD 可能有前导零,且 SemVer 第三核心段必须为数字;因此将数字序号放在第三段、SHA 放在连字符之后。CLI 在打包副本中自动同步 package.json 的 version、gwVersion 和 Windows/Linux 二进制编译版本,无需手工修改源码中的 gwVersion。日常安装继续使用 @latest;精确复现使用完整版本号。由于它在 SemVer 中属于 prerelease,普通版本范围默认不会匹配,依赖方应使用 @latest 或精确版本。
npm publish / publish npm 会自动向 npm 传入 --tag latest,明确把本次版本设为 @latest,同时满足 npm 对 prerelease 发布的显式 tag 要求。--dry-run 使用相同参数但不上传;npm pack --dry-run 只检查打包,不能替代发布检查。
真实发布还会创建并向当前源码仓库的 Git origin 推送轻量 tag。前缀分别为 npm-、image-、chart-,格式为 <type>-yyyy-MMdd-id-short_sha1;例如 npm 版本 2026.914.14-fdc9a58 对应 npm-2026-0914-14-fdc9a58。tag 指向版本中 short SHA 对应的源码提交,MMDD 在 Git tag 中固定补齐四位。同名同提交视为幂等成功,同名不同提交拒绝覆盖。制品上传和账本写入先完成,若后续 Git 认证、远端或 tag 冲突失败,CLI 会明确报告“制品已发布、Git tag 失败”,不会删除已发布制品。build/package 与 npm dry-run 不创建 tag;历史 SemVer 显式发布仍使用制品前缀并附加当前 HEAD short SHA。
旧的 yyyy.Mdd.0-short_sha1.id 和 yyyy.MM.dd.id 仅保留为显式输入兼容,用于重建已经发布的旧包;新自动版本不会再生成旧格式。
npm 序号记录位于统一配置 ~/jszx-infra/.gw-cli/config.yaml 的 shared.artifacts.npm;打包开始即占用,失败和 dry-run 也占用一次,避免自动重用版本。同一用户配置下的并发自动打包不会重复分配,清理 .gw-build 或切换仓库副本不会重置编号。首次写入时,旧 projects.*.artifacts.npm 会合并到 shared:每日序号取最大值,最近构建/发布取较新记录,并删除项目内 npm 节点。手动指定版本可用于重打包或在本地验证后发布;换机器或 CI 多节点并行时仍需统一分配并显式传入未发布版本。GW_CLI_PROJECTS 仅覆盖旧账本作为升级兼容路径。
镜像 tag
image build 默认 --tag auto,生成 yyyy.Mdd.id-short_sha1,例如 2026.914.1-d3844db。该格式同时满足 Docker tag 与 Helm SemVer,Image 与 Chart 各自编号。deploy helm install 省略版本参数时,会按 --project-id 从发布账本自动选择最近成功发布的 Chart 版本和目标镜像仓库最近成功发布的 Image tag;换机器或账本缺失时再显式传入。日期按执行 CLI 的机器本地时间计算,SHA 取当前 HEAD,序号从 1 起,同日递增、跨日重置。参数优先级为 --tag > GW_IMAGE_TAG > auto;已存在的 yyyy.Mdd.0-short_sha1.id、yyyy.M.d-id 和 yyyy.MM.dd.id 仍可显式重建或推送。
镜像与 npm 独立计数;镜像编号写入统一配置的 projects.<project-id>.artifacts.image。开始构建时即占号,失败也保留,但只有成功构建才更新该 repository 的最近可推送 tag。同一 project-id 的不同镜像 repository 共用镜像每日序号,各自保存最近成功构建。显式 tag 可用于本地重建;不查询 Harbor。换机器或 CI 多节点构建时,应统一分配并显式传入未发布 tag,不能覆盖已发布镜像。
# 自动编号,输出 Docker 构建日志及最终完整镜像名
go run ./tools/cli --project-id gw-demo image build
# 自动使用该 repository 最近一次成功构建的 tag,不生成新编号
go run ./tools/cli --project-id gw-demo image pushimage push / publish image 的默认 --tag auto 会读取最近成功构建记录;没有记录时要求先 build 或显式传入 tag。优先级为 --tag > GW_IMAGE_TAG > 自动识别;为兼容已有本地镜像,显式推送仍接受旧 tag 格式。默认仓库为 <Harbor>/<Harbor项目>/<project-id>,完整地址可用 --repository 或 GW_IMAGE_REPOSITORY 覆盖。
Chart 版本
chart package 独立生成 yyyy.Mdd.id-short_sha1,例如 2026.914.1-d3844db;Chart metadata、归档名和 Harbor OCI tag 不再二次映射或添加 project-id 前缀。chart push 默认复用统一配置中尚未发布且文件仍存在的精确归档;没有可复用包时自动分配下一版本、打包并推送。旧的 yyyy.Mdd.0-short_sha1.id、yyyy.M.d-id、{project-id}-yyyy.MM.dd.id、yyyy.MM.dd.id 和合法 SemVer 仍可显式用于重建或回滚。Chart 默认地址为 oci://<Harbor>/<Harbor项目>/charts/<project-id>,自动与镜像路径分离,无需另传 /charts;--registry/--repository 可覆盖 registry 和 OCI 父路径。
配置查看与校验
go run ./tools/cli config new
go run ./tools/cli config new --project-id my-gateway --non-interactive --yes
go run ./tools/cli config list
go run ./tools/cli config list --json
go run ./tools/cli config show
go run ./tools/cli config check
go run ./tools/cli --project-id gw-demo config showconfig new 回显确认后写入 projects.<project-id> 并输出接入命令;若同一文件仍是旧版或混合版凭据结构,会先在内存升级和校验,再创建 config.yaml.bak.<时间> 私有备份并原子替换,失败不改原文件。config list 读取统一配置中已记录的项目代号;config show 仅显示凭据状态,不输出 Token 或密码;config check 只做静态校验,不执行集群写操作。运行时配置使用 config runtime get/set/history/rollback。
config show 将 Deployment values 标为 Chart 内置,只在本地源码 values 确实存在时展示 Source values(仅本地开发)。不再展示 Profiles 目录;JSON 删除 profiles-dir,无本地文件时省略 framework-values,新增 deployment-values 来源说明。CLI 不再保存或读取部署 profile,旧字段由 config check 拒绝;无源码 VM 无需在用户目录维护 values 副本。
配置命令已随 2026.9.13-9 发布到 npm latest。
使用
在 GW-Framework 源码根目录执行以下命令;公开 npm 入口的切换条件见本文开头:
go run ./tools/cli --version
go run ./tools/cli --project-id gw-demo doctor
go run ./tools/cli --project-id gw-demo test
go run ./tools/cli --project-id gw-demo build
go run ./tools/cli --project-id gw-demo run all| 命令 | --project-id |
|---|---|
| build/run/test、image/chart/npm/publish 的实际操作 | 必填 |
| deploy k3s/helm 的实际操作,包括状态查询及 dry-run | 必填 |
| 隐藏 cleanup,仅供 npm wrapper 回收本地资源 | 必填 |
| config new --non-interactive | 必填 |
| config list/new/show/check/runtime | 可选;config new 交互询问代号 |
| doctor | 可选 |
| 帮助和版本查询 | 不需要 |
项目代号最长 63 字符,以小写字母开头,只含小写字母、数字和不连续的连字符,末尾为字母或数字。缺失、空值、非法值或重复参数均失败;两次相同值也不接受。源码从当前目录向上找最近 go.mod,不通过项目代号定位另一个仓库。
build、run、test 省略目标时默认 all,也可显式选择 core|mock|web|all;通用 GW-Framework 项目目标固定映射 ./apps/core-gateway、./apps/mock-gateway、./apps/web-service。AuthGateway 保留逻辑目标 core,源码检测后映射到 ./apps/auth-gateway,mock/web 不变;构建和运行的 all 不包含 CLI。test core/mock/web 只执行对应宿主的 go test -short,test all 执行 go test -short ./apps/... 覆盖 apps 下全部包但不扫描 CLI;需要执行 CLI 集成测试时单独运行 go test ./tools/cli,CI 若要测试全部 Go 包但跳过集成测试则运行 go test -short ./...。单目标执行对应 package 的测试子树。旧 manifest 自定义 app/package/build/run/test/health-url 不再生效。smoke 和整个 dev 入口已删除。
基础默认值随 Chart 发布;CLI 不再提供部署 profile 参数或预设选择,部署直接使用 Chart 默认值和项目配置。config check 带 project-id 时验证登记及字段,未知或旧代号不再通过;不带代号只检查全局静态结构。
域名和 TLS Secret 通过 config new 保存。WSL 可显式使用 --windows-hosts 维护开发机解析,云 VM 使用 DNS;不再提供 beta/release 预设。
本地 run all 除了通用宿主、local.* 配置和本机持久 PostgreSQL,还会根据 local.demo 启动仓库内置登录与 Hello Demo,本地演示账号和密码固定为 demo/demo123;不读取用户环境变量。Helm 直接使用 values 中的展示密码,TLS 证书由 Secret 管理。显式 --database temporary 使用随机密码,退出时回收。
Go 项目的 build、run、test 需要源码和 Go。本仓库默认 run 还需要已由 db start 启动的本机 PostgreSQL,以及 Windows 上执行统一迁移脚本所需的 Git for Windows;只有 --database temporary 需要 Docker。run 会按目标先构建,再启动 .gw-build/local/ 下对应二进制;Windows 启动 .exe,省略目标时等同 build all。如果旧 app 仍占用任一 app 端口,run 直接失败,不会自动终止旧进程。npm 发布使用当前平台 npm;镜像命令优先使用当前平台 Docker,Windows 缺少 Docker 时转 WSL;Chart 推送在 Windows 默认走 WSL,可用 --wsl=false 切换。平台能力由 doctor 输出。
根 --help 只展示下一层入口,并按颜色分为“本地 PC · 日常开发”“远程 VM · 日常部署”“高级命令 · 制品与维护”;各级命令沿用所属分组颜色,参数默认值使用洋红色突出。交互终端默认启用颜色;GW_CLI_COLOR=always|never 可强制开关,未强制开启时 NO_COLOR 会关闭颜色。集群操作唯一入口为 deploy k3s / deploy helm,包括 deploy k3s restore/purge;顶层 k3s / helm 已删除。
deploy k3s init 在 WSL 或 Linux amd64 VM 内执行,无需项目文件、源码或 Go。当前公开包已包含新接口;无源码 VM 直接使用 npm 包中的 Linux amd64 CLI,或使用已核对版本的独立二进制。下面是 Windows 源码端的预览入口:
go run ./tools/cli --project-id gw-demo deploy k3s init --dry-run目标机器需预先安装并运行 k3s、安装 Helm,并允许当前用户访问 kubeconfig;不自动安装 k3s 或 Helm。部署前可运行 doctor --scope deploy,该 scope 只检查 Helm/k3s/kubeconfig,不要求 Go、Node.js 或 npm。PostgreSQL 参数使用 --pgsql-*,数据库名为 --pgsql-dbname。已有密码分别复用,首次密码隐藏输入,危险修改需二次确认。显式提供 --tls-secret-name/--tls-cert-file/--tls-key-file/--tls-host 可导入公司证书;WSL 开发机可加 --windows-hosts。完整说明见 k3s 初始化。本轮包包含上述参数和 WSL PowerShell 路径回退。
发布凭据
项目身份仅来自 --project-id,默认交付地址和资源名称从代号推导。Harbor 端点按对应命令支持的参数 > GW_HARBOR_REGISTRY/GW_HARBOR_PROJECT > 用户配置端点 > szharbor.g-bits.com/jszx-infra 默认值解析。用户 ~/jszx-infra/.gw-cli/config.yaml 保存凭据、平台区块和项目制品版本,不保存当前项目;旧 projects.yaml 仅通过显式 GW_CLI_PROJECTS 兼容。CI 显式传代号并注入凭据,无需携带项目清单。帮助和版本查询不创建配置。
Namespace/应用 Release 默认代号,PG Release 默认 <代号>-pg,数据库名/用户名将 - 转为 _,数据库连接 Secret 默认 <代号>-database。超长 Release/资源名自动缩短并保留确定性哈希;Namespace 和制品地址保留完整代号。kubeconfig/context 默认 /etc/rancher/k3s/k3s.yaml / default,可通过现有参数及环境变量覆盖。详细规则见多项目 CLI 指南。
go run ./tools/cli npm publish
go run ./tools/cli --project-id gw-demo image push
go run ./tools/cli --project-id gw-demo chart push缺少 npm Token 或 Harbor Robot 账号/密码时,CLI 会询问并自动保存到 ~/jszx-infra/.gw-cli/config.yaml;可用 GW_CLI_CONFIG 覆盖位置。已有配置不重复询问。命令参数、NODE_AUTH_TOKEN / GW_HARBOR_USERNAME / GW_HARBOR_PASSWORD 优先于用户配置。
deploy helm install 的 release、namespace、Chart 地址、数据库资源名、kubeconfig/context 均由 --project-id 和固定规则推导;Chart 版本和镜像 tag 默认读取该项目的最近成功发布记录。--version、--tag 只用于跨机器、账本缺失、回滚或一次性覆盖。拉取 OCI Chart 时先复用 Helm 原生登录或公共访问;只有确认认证失败才补齐 Harbor 账密,隐藏密码输入、保存后通过 stdin 登录。支持 --username / --password 和 GW_HARBOR_USERNAME / GW_HARBOR_PASSWORD,也支持 --helm-registry-config / HELM_REGISTRY_CONFIG 指定执行机器的 Helm 凭据文件。网络、版本不存在等错误直接报告;--dry-run 不探测、不登录、不询问账密。
实际安装依次输出目标、Chart默认值、前置检查和 Helm 结果,等待期间定期显示 Pod 状态。通用部署检查已有数据库 Secret;AuthGateway VM 的 prepare 由 Chart 创建数据库资源,serve 才要求数据库、TLS 与镜像拉取 Secret 已就绪。
Token 和密码在终端中不回显。配置文件保存明文凭据,Unix 下目录/文件权限为 0700/0600,Windows 使用用户目录 ACL。网关服务不读取此文件。
源码打包与本地验证
已有公开 npm 包;npm 构建/发布在当前源码中不再使用项目代号,版本统一记录到 shared.artifacts.npm:
# 自动使用当天序号,终端会打印版本和文件名
go run ./tools/cli npm build
# 把占位文件名替换为本次 build 实际输出的文件名;这里使用本地新包
$gwNpmArchive = './.gw-build/npm/<本次输出的文件名>.tgz'
npx -y --package $gwNpmArchive gw-cli --version
npx -y --package $gwNpmArchive gw-cli --project-id gw-demo config show
# 只检查发布包,不上传、不询问 Token
go run ./tools/cli npm publish --dry-run
# 获得发布授权后执行:重新构建并自动编号,输入具备发布权限的 npm Token
go run ./tools/cli npm publish发布后的版本号不可复用。这里的 gw-cli 是包内命令名,公网下载始终使用 scoped 包 @gbits-jszx/gw-cli。
AuthGateway 首装参数简化
init 不再询问 Namespace、数据库名或业务用户名;config new 保存目标和前缀,配置中的首装能力标记决定流程,不根据 authgateway 等固定名称选择分支。PostgreSQL owner/runtime 角色由前缀派生;Redis 使用独立实例、逻辑库0和默认ACL用户,密码在Secret自动生成并复用。若只想实例名为 authgw,使用已发布制品的 project-id=authgateway,并在引导中填写 Namespace/Release=authgw;改 project-id 会改变默认制品仓库。
首次使用 npx -y --prefer-online @gbits-jszx/gw-cli@latest config new,按显示默认值填写或回车,保存 Namespace/Release、数据库前缀、域名和证书路径。部署自动读取项目配置,日常只传 project-id/version/tag;namespace/release 保留为本次覆盖参数,Chart 地址自动推导。
npx -y --prefer-online @gbits-jszx/gw-cli@latest --project-id authgateway deploy helm install --version 2026.1009.12-a06e78d --tag 2026.1009.6-d6ac256首装按 config new → k3s init一次准备PG16/Redis/PVC/TLS与镜像凭据 → helm install初始化业务并启动应用;后续只执行install。Profile参数和旧预设读取已删除;新项目使用Chart默认值。旧profile字段明确报错,只读检查不自动改写用户配置。--values/--set保留为高级覆盖,非日常必填项。 完整默认值、操作命令和顺序解释见云 VM 指南。
