@gbits-jszx/gw-cli 2026.9.13-2 → 2026.9.13-5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.md +17 -6
  2. package/bin/native/gw-cli-linux-amd64 +0 -0
  3. package/bin/native/gw-cli-windows-amd64.exe +0 -0
  4. package/package.json +2 -2
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  面向多个网关项目的跨平台构建、运行和交付工具。项目身份唯一来自显式 `--project-id <代号>`（或 `--project-id=<代号>`）；不需要 `gw.project.yaml`，不接受旧 `--project` 路径，也不从 `GW_PROJECT_FILE` 或用户凭据中的旧 ID 兜底。`npm build/package/publish` 专用于维护 CLI 本身，包名固定为 `@gbits-jszx/gw-cli`，项目代号只隔离版本账本。
4
4
 
5
- > 本文新接口尚未发布。已发布的 `@gbits-jszx/gw-cli@2026.9.12-9` 仍使用旧 `--project`；新示例使用 `go run ./tools/cli`。新版发布并核对版本后，再替换为 `npx -y --prefer-online @gbits-jszx/gw-cli@latest`。历史已执行命令见 [2026-09-12 发布实录](../../../docs/user-docs/GW-DEMO-RELEASE-2026-09-12.md)。
5
+ > 新接口已随 `@gbits-jszx/gw-cli@2026.9.13-3` 发布并核对为 latest，公网使用 `npx -y --prefer-online @gbits-jszx/gw-cli@latest`；`2026.9.12-9` 及更早版本仍是旧 `--project` 接口。源码开发继续使用 `go run ./tools/cli`。
6
6
 
7
7
  [PC 开发构建发布、WSL/云 VM 初始化部署更新](../../../docs/user-docs/CLI-MULTI-PROJECT.md)。公网 registry 为 `https://registry.npmjs.org/`，包内包含 Windows amd64 和 Linux amd64（含 WSL）二进制。
8
8
 
@@ -20,7 +20,7 @@ npm、Image、Chart 使用相同的 `yyyy.M.d-id` 格式，但按项目和制品
20
20
 
21
21
  旧的 `yyyy.MM.dd.id` 仅保留为显式输入兼容，用于重建已经发布的旧包；新自动版本不会再生成旧格式。
22
22
 
23
- 序号记录位于 `~/jszx-infra/.gw-cli/projects.yaml`，按 `project-id` 和制品类型隔离；打包开始即占用，失败和 dry-run 也占用一次，避免自动重用版本。同一用户目录下、同一项目的并发自动打包不会重复分配，清理 `.gw-build` 或切换仓库副本不会重置编号。手动指定版本可用于重打包或在本地验证后发布；换机器或 CI 多节点并行时仍需统一分配并显式传入未发布版本。`GW_CLI_PROJECTS` 可覆盖账本路径。npm 包名固定，不同项目代号的账本隔离不代表能向该包重复发布同一个版本；维护 CLI 应使用稳定代号，当前为 `gw-demo`。上一轮已发布 `2026.9.12-9` 的账本位于该代号下；更换代号必须迁移版本账本，不能靠换 ID 重置 npm 编号。
23
+ 序号记录位于 `~/jszx-infra/.gw-cli/projects.yaml`，按 `project-id` 和制品类型隔离；打包开始即占用，失败和 dry-run 也占用一次，避免自动重用版本。同一用户目录下、同一项目的并发自动打包不会重复分配，清理 `.gw-build` 或切换仓库副本不会重置编号。手动指定版本可用于重打包或在本地验证后发布；换机器或 CI 多节点并行时仍需统一分配并显式传入未发布版本。`GW_CLI_PROJECTS` 可覆盖账本路径。npm 包名固定，不同项目代号的账本隔离不代表能向该包重复发布同一个版本；维护 CLI 应使用稳定代号，当前为 `gw-demo`。该代号名下最新发布为 `2026.9.13-3`。
24
24
 
25
25
  ## 镜像 tag
26
26
 
@@ -41,7 +41,18 @@ go run ./tools/cli --project-id gw-demo image push
41
41
 
42
42
  `chart package` 独立生成 `yyyy.M.d-id`，例如 `2026.9.10-1`；Chart metadata、归档名和 Harbor OCI tag 不再二次映射或添加 project-id 前缀。`chart push` 默认复用 `projects.yaml` 中尚未发布且文件仍存在的精确归档；没有可复用包时自动分配下一版本、打包并推送。旧的 `{project-id}-yyyy.MM.dd.id`、`yyyy.MM.dd.id` 和合法 SemVer 仍可显式用于重建或回滚。Chart 默认地址为 `oci://<Harbor>/<Harbor项目>/charts/<project-id>`，自动与镜像路径分离，无需另传 `/charts`；`--registry/--repository` 可覆盖 registry 和 OCI 父路径。
43
43
 
44
- ## 使用
44
+ ## 配置查看与校验
45
+
46
+ ```powershell
47
+ go run ./tools/cli --project-id gw-demo config show
48
+ go run ./tools/cli --project-id gw-demo config validate
49
+ go run ./tools/cli --project-id gw-demo project show
50
+ ```
51
+
52
+ `config show` 仅显示凭据状态，不输出 Token 或密码；`config validate` 只做静态校验，不执行迁移或集群写操作。
53
+ 配置命令已随 `2026.9.13-3` 发布到 npm latest。
54
+
55
+ ## 使用
45
56
 
46
57
  在 GW-Framework 源码根目录执行以下命令；公开 npm 入口的切换条件见本文开头：
47
58
 
@@ -56,7 +67,7 @@ go run ./tools/cli --project-id gw-demo run all
56
67
  | 命令 | `--project-id` |
57
68
  |---|---|
58
69
  | `build/run/test`、`image/chart/npm/publish` 的实际操作 | 必填 |
59
- | `project show`、`deploy k3s/helm` 的实际操作，包括状态查询及 dry-run | 必填 |
70
+ | `config show/validate`、`project show`、`deploy k3s/helm` 的实际操作，包括状态查询及 dry-run | 必填 |
60
71
  | 隐藏 `cleanup`，仅供 npm wrapper 回收本地资源 | 必填 |
61
72
  | `doctor` | 可选 |
62
73
  | 帮助和版本查询 | 不需要 |
@@ -85,7 +96,7 @@ go run ./tools/cli --project-id gw-demo deploy k3s init --dry-run
85
96
 
86
97
  项目身份仅来自 `--project-id`，默认交付地址和资源名称从代号推导。Harbor 端点按对应命令支持的参数 > `GW_HARBOR_REGISTRY/GW_HARBOR_PROJECT` > 用户配置端点 > `szharbor.g-bits.com/jszx-infra` 默认值解析。用户 `~/jszx-infra/.gw-cli/config.yaml` 保存凭据及其端点，不保存当前项目；`projects.yaml` 按项目记录制品版本。CI 显式传代号并注入凭据，无需携带项目清单。帮助和版本查询不创建配置。
87
98
 
88
- Namespace/应用 Release 默认代号，PG Release 默认 `<代号>-pg`，数据库名/用户名将 `-` 转为 `_`，数据库连接 Secret 默认 `<代号>-database`。超长 Release/资源名自动缩短并保留确定性哈希；Namespace 和制品地址保留完整代号。kubeconfig/context 默认 `/etc/rancher/k3s/k3s.yaml` / `default`，可通过现有参数及环境变量覆盖。已有资源应显式保留原目标，不能覆盖 DataGateway `dg-dev`。详细迁移表见[多项目 CLI 指南](../../../docs/user-docs/CLI-MULTI-PROJECT.md)。
99
+ Namespace/应用 Release 默认代号，PG Release 默认 `<代号>-pg`，数据库名/用户名将 `-` 转为 `_`，数据库连接 Secret 默认 `<代号>-database`。超长 Release/资源名自动缩短并保留确定性哈希；Namespace 和制品地址保留完整代号。kubeconfig/context 默认 `/etc/rancher/k3s/k3s.yaml` / `default`，可通过现有参数及环境变量覆盖。详细规则见[多项目 CLI 指南](../../../docs/user-docs/CLI-MULTI-PROJECT.md)。
89
100
 
90
101
  ```powershell
91
102
  go run ./tools/cli --project-id gw-demo publish npm
@@ -101,7 +112,7 @@ Token 和密码在终端中不回显。配置文件保存明文凭据，Unix 下
101
112
 
102
113
  ## 源码打包与本地验证
103
114
 
104
- 已有公开 npm 包；本次 `--project-id` 改造需先从当前源码打包验证，再按授权发布新版。以下 npm 操作继续使用已有版本账本对应的维护代号 `gw-demo`：
115
+ 已有公开 npm 包；`--project-id` 改造首发于 `2026.9.13-2`，config 命令随 `2026.9.13-3` 发布。以下 npm 操作继续使用版本账本对应的维护代号 `gw-demo`：
105
116
 
106
117
  ```powershell
107
118
  # 自动使用当天序号，终端会打印版本和文件名
package/bin/native/gw-cli-linux-amd64 CHANGED
Binary file
package/bin/native/gw-cli-windows-amd64.exe CHANGED
Binary file
package/package.json CHANGED
@@ -9,12 +9,12 @@
9
9
  "files": [
10
10
  "bin"
11
11
  ],
12
- "gwVersion": "2026.9.13-2",
12
+ "gwVersion": "2026.9.13-5",
13
13
  "license": "MIT",
14
14
  "name": "@gbits-jszx/gw-cli",
15
15
  "publishConfig": {
16
16
  "access": "public",
17
17
  "registry": "https://registry.npmjs.org/"
18
18
  },
19
- "version": "2026.9.13-2"
19
+ "version": "2026.9.13-5"
20
20
  }