@gbits-jszx/gw-cli 2026.910.6 → 2026.911.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.
package/README.md
CHANGED
|
@@ -22,6 +22,21 @@ npm 的 SemVer 不接受四段数字或带前导零的月日，所以 npm 包版
|
|
|
22
22
|
|
|
23
23
|
序号记录位于 `.gw-build/npm/versions/`，打包开始即占用；失败和 dry-run 也占用一次，避免自动重用版本。并发自动打包不会重复分配；手动指定版本可用于重打包或在本地验证后发布。每份仓库独立编号，不查询 registry；清理记录、换机器或 CI 并行发布时，需统一分配并显式传入未发布的版本。`publish npm` 会重新编译源码，要沿用已验证的版本号应显式指定 `--version`。
|
|
24
24
|
|
|
25
|
+
## 镜像 tag
|
|
26
|
+
|
|
27
|
+
`image build` 默认 `--tag auto`，使用同样的 `yyyy.MM.dd.id` 规则，例如 `2026.09.10.1`。Docker 支持四段 tag，无需 npm 的三段映射。日期按执行 CLI 的机器本地时间计算，序号从 1 起，同日递增、跨日重置。参数优先级为 `--tag` > `GW_IMAGE_TAG` > `auto`；显式 tag 必须是有效日期和不带前导零的正整数序号，不能用 `latest`、`0.2.0-dev` 等旧格式构建。
|
|
28
|
+
|
|
29
|
+
镜像与 npm 独立计数，镜像记录位于 `.gw-build/image/versions/`。开始构建时即占号，失败也保留；同一份仓库并发自动构建不会重复编号。显式 tag 可用于本地重建；不查询 Harbor，同一仓库的不同镜像 repository 共用镜像序号。清理记录、换机器或 CI 多节点构建时，应统一分配并显式传入未发布的 tag，不能覆盖已发布镜像。
|
|
30
|
+
|
|
31
|
+
```powershell
|
|
32
|
+
# 自动编号，输出 Docker 构建日志及最终完整镜像名
|
|
33
|
+
npx -y --prefer-online @gbits-jszx/gw-cli@latest image build
|
|
34
|
+
# 推送时替换为上一步实际输出的 tag，不会生成新编号或重新构建
|
|
35
|
+
npx -y --prefer-online @gbits-jszx/gw-cli@latest image push --tag 2026.09.10.1
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
`image push` / `publish image` 必须通过 `--tag` 或 `GW_IMAGE_TAG` 指定已构建的 tag，不接受空值或 `auto`；为兼容已有本地镜像，推送仍接受旧 tag 格式。构建结束会输出可沿用的推送命令。以上行为在源码修改发布后才进入 npm `@latest`，发布前用 `go run ./tools/cli image build` 验证。
|
|
39
|
+
|
|
25
40
|
## 使用
|
|
26
41
|
|
|
27
42
|
首次发布成功后，在 GW-Framework 项目根目录执行：
|
|
@@ -44,13 +59,15 @@ npx -y --prefer-online @gbits-jszx/gw-cli@latest k3s init --dry-run
|
|
|
44
59
|
npx -y --prefer-online @gbits-jszx/gw-cli@latest k3s init
|
|
45
60
|
```
|
|
46
61
|
|
|
47
|
-
目标机器需预先安装并运行 k3s、安装 Helm，并允许当前用户访问 kubeconfig。Windows 默认走 `Ubuntu-24.04` WSL，Linux 直接执行；不自动安装 k3s 或 Helm。PostgreSQL 参数使用 `--pgsql-*`，数据库名为 `--pgsql-dbname
|
|
62
|
+
目标机器需预先安装并运行 k3s、安装 Helm，并允许当前用户访问 kubeconfig。Windows 默认走 `Ubuntu-24.04` WSL，Linux 直接执行；不自动安装 k3s 或 Helm。PostgreSQL 参数使用 `--pgsql-*`，数据库名为 `--pgsql-dbname`。已有密码分别复用，首次业务及管理员密码人工输入，危险修改需二次确认，缺少 Docker 登录配置时跳过 imagePullSecret。完整说明见 [k3s 初始化](../../../docs/user-docs/K3S-INIT.md)。源码修改发布后才会进入 npm `@latest`。
|
|
48
63
|
|
|
49
64
|
## 发布凭据
|
|
50
65
|
|
|
66
|
+
首次执行任何命令（含帮助、版本、doctor、dry-run）均检查用户配置；不存在或缺少 `project-id` 时引导填写项目代号，Harbor 地址与项目分别默认 `szharbor.g-bits.com`、`jszx-infra`，提示默认值可回车采用。旧配置中的发布凭据保留。镜像和 Chart 仓库末段统一为 `{project-id}`，Chart 打包也使用该包名。CI 需预先准备含 `project-id` 的配置。见 [首次配置说明](../../../configs/README.md)。
|
|
67
|
+
|
|
51
68
|
```powershell
|
|
52
69
|
npx -y --prefer-online @gbits-jszx/gw-cli@latest publish npm --version 2026.09.10.1
|
|
53
|
-
npx -y --prefer-online @gbits-jszx/gw-cli@latest publish image --tag
|
|
70
|
+
npx -y --prefer-online @gbits-jszx/gw-cli@latest publish image --tag 2026.09.10.1
|
|
54
71
|
npx -y --prefer-online @gbits-jszx/gw-cli@latest publish chart --version 0.2.1
|
|
55
72
|
```
|
|
56
73
|
|
|
@@ -75,4 +92,4 @@ go run ./tools/cli publish npm --dry-run
|
|
|
75
92
|
go run ./tools/cli publish npm --version 2026.09.10.1
|
|
76
93
|
```
|
|
77
94
|
|
|
78
|
-
发布后的版本号不可复用。这里的 `gw-cli` 是包内命令名，公网下载始终使用 scoped 包 `@gbits-jszx/gw-cli`。
|
|
95
|
+
发布后的版本号不可复用。这里的 `gw-cli` 是包内命令名，公网下载始终使用 scoped 包 `@gbits-jszx/gw-cli`。
|
|
Binary file
|
|
Binary file
|
package/package.json
CHANGED
|
@@ -9,12 +9,12 @@
|
|
|
9
9
|
"files": [
|
|
10
10
|
"bin"
|
|
11
11
|
],
|
|
12
|
-
"gwVersion": "2026.09.
|
|
12
|
+
"gwVersion": "2026.09.11.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.
|
|
19
|
+
"version": "2026.911.5"
|
|
20
20
|
}
|