@gbits-jszx/gw-cli 2026.911.5 → 2026.911.9

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
@@ -20,22 +20,26 @@ npm 的 SemVer 不接受四段数字或带前导零的月日,所以 npm 包版
20
20
 
21
21
  这些是可按日期和序号排序的正式版本,可正常使用 `@latest`。包内 `package.json` 的 `version` 保存 npm 版本,`gwVersion` 保存四段显示版本;Windows/Linux 二进制编译时写入同一个显示版本,`gw-cli --version` 不会回退到源码包的旧版本。
22
22
 
23
- 序号记录位于 `.gw-build/npm/versions/`,打包开始即占用;失败和 dry-run 也占用一次,避免自动重用版本。并发自动打包不会重复分配;手动指定版本可用于重打包或在本地验证后发布。每份仓库独立编号,不查询 registry;清理记录、换机器或 CI 并行发布时,需统一分配并显式传入未发布的版本。`publish npm` 会重新编译源码,要沿用已验证的版本号应显式指定 `--version`。
23
+ 序号记录位于 `~/jszx-infra/.gw-cli/projects.yaml`,按 `project-id` 和制品类型隔离;打包开始即占用,失败和 dry-run 也占用一次,避免自动重用版本。同一用户目录下的并发自动打包不会重复分配,清理 `.gw-build` 或切换仓库副本不会重置编号。手动指定版本可用于重打包或在本地验证后发布;换机器或 CI 多节点并行时仍需统一分配并显式传入未发布版本。`GW_CLI_PROJECTS` 可覆盖账本路径。
24
24
 
25
25
  ## 镜像 tag
26
26
 
27
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
28
 
29
- 镜像与 npm 独立计数,镜像记录位于 `.gw-build/image/versions/`。开始构建时即占号,失败也保留;同一份仓库并发自动构建不会重复编号。显式 tag 可用于本地重建;不查询 Harbor,同一仓库的不同镜像 repository 共用镜像序号。清理记录、换机器或 CI 多节点构建时,应统一分配并显式传入未发布的 tag,不能覆盖已发布镜像。
29
+ 镜像与 npm 独立计数,编号同样写入用户级 `projects.yaml`。开始构建时即占号,失败也保留,但只有成功构建才更新该 repository 的最近可推送 tag。同一 `project-id` 的不同镜像 repository 共用镜像每日序号,各自保存最近成功构建。显式 tag 可用于本地重建;不查询 Harbor。换机器或 CI 多节点构建时,应统一分配并显式传入未发布 tag,不能覆盖已发布镜像。
30
30
 
31
31
  ```powershell
32
32
  # 自动编号,输出 Docker 构建日志及最终完整镜像名
33
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
34
+ # 自动使用该 repository 最近一次成功构建的 tag,不生成新编号
35
+ npx -y --prefer-online @gbits-jszx/gw-cli@latest image push
36
36
  ```
37
37
 
38
- `image push` / `publish image` 必须通过 `--tag` `GW_IMAGE_TAG` 指定已构建的 tag,不接受空值或 `auto`;为兼容已有本地镜像,推送仍接受旧 tag 格式。构建结束会输出可沿用的推送命令。以上行为在源码修改发布后才进入 npm `@latest`,发布前用 `go run ./tools/cli image build` 验证。
38
+ `image push` / `publish image` 的默认 `--tag auto` 会读取最近成功构建记录;没有记录时要求先 build 或显式传入 tag。优先级为 `--tag` > `GW_IMAGE_TAG` > 自动识别;为兼容已有本地镜像,显式推送仍接受旧 tag 格式。以上行为在源码修改发布后才进入 npm `@latest`,发布前用 `go run ./tools/cli image build` 验证。
39
+
40
+ ## Chart 版本
41
+
42
+ `chart package` 默认生成 `{project-id}-yyyy.MM.dd.id` 显示版本,例如 `gw-framework-2026.09.10.1`;Helm Chart metadata 只能使用 SemVer,因此包内版本和归档名映射为 `2026.910.1`。`chart push` 默认复用 `projects.yaml` 中尚未发布且文件仍存在的精确归档;没有可复用包时自动分配下一版本、打包并推送。显式 `--version` 接受带/不带 project-id 的日期版本,并兼容合法 SemVer。
39
43
 
40
44
  ## 使用
41
45
 
@@ -67,8 +71,8 @@ npx -y --prefer-online @gbits-jszx/gw-cli@latest k3s init
67
71
 
68
72
  ```powershell
69
73
  npx -y --prefer-online @gbits-jszx/gw-cli@latest publish npm --version 2026.09.10.1
70
- npx -y --prefer-online @gbits-jszx/gw-cli@latest publish image --tag 2026.09.10.1
71
- npx -y --prefer-online @gbits-jszx/gw-cli@latest publish chart --version 0.2.1
74
+ npx -y --prefer-online @gbits-jszx/gw-cli@latest publish image
75
+ npx -y --prefer-online @gbits-jszx/gw-cli@latest publish chart
72
76
  ```
73
77
 
74
78
  缺少 npm Token 或 Harbor Robot 账号/密码时,CLI 会询问并自动保存到 `~/jszx-infra/.gw-cli/config.yaml`;可用 `GW_CLI_CONFIG` 覆盖位置。已有配置不重复询问。命令参数、`NODE_AUTH_TOKEN` / `GW_HARBOR_USERNAME` / `GW_HARBOR_PASSWORD` 优先于用户配置。
Binary file
Binary file
package/package.json CHANGED
@@ -9,12 +9,12 @@
9
9
  "files": [
10
10
  "bin"
11
11
  ],
12
- "gwVersion": "2026.09.11.5",
12
+ "gwVersion": "2026.09.11.9",
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.911.5"
19
+ "version": "2026.911.9"
20
20
  }