@gbits-jszx/dg-cli 0.0.0-regress-1777570061

package/README.md

@@ -0,0 +1,61 @@
+# @gbits-jszx/dg-cli
+
+DataGateway CLI — 部署 / 运维 / 配置一站式工具，Go 二进制经由 npx 分发。
+
+## 安装与使用
+
+```bash
+# 一次性运行（推荐）
+npx -y @gbits-jszx/dg-cli@latest doctor
+
+# 全局安装
+npm i -g @gbits-jszx/dg-cli
+dg-cli doctor
+
+# 项目本地依赖
+npm i -D @gbits-jszx/dg-cli
+npx dg-cli doctor
+```
+
+## 平台支持
+
+| OS | Arch |
+|---|---|
+| Linux | x64 / arm64 |
+| macOS | Intel / Apple Silicon |
+| Windows | x64 |
+
+> npm 装包时根据 `process.platform/arch` 自动只下载当前平台的二进制（约 8MB），其它子包跳过。
+
+## 主要命令
+
+- `dg-cli doctor`：环境自检
+- `dg-cli config init|validate|path`：配置文件管理（schema 驱动）
+- `dg-cli deploy install|upgrade|rollback`：VM 部署
+- `dg-cli image build|push`：镜像构建发布
+- `dg-cli system rotate-secret`：业务系统密钥轮换
+
+完整文档：[DataGateway 项目仓库](https://m68gitlab.g-bits.com/jszx-infra/datagateway)。
+
+## 常见问题
+
+**Q1：装完执行报「不支持的平台」**
+当前平台未被收录（仅支持 linux x64/arm64、macOS Intel/Apple Silicon、Windows x64）。请联系维护者补齐 `@gbits-jszx/dg-cli-<platform>-<arch>` 子包，或通过仓库内 GitLab 渠道安装本地构建版本。
+
+**Q2：`npx` 报错「需要登录 https://registry.npmjs.org」**
+本机 `~/.npmrc` 把 registry 切到了私有镜像（如 npmmirror）。临时切回：
+
+```bash
+npm config set registry https://registry.npmjs.org/
+npx -y @gbits-jszx/dg-cli@latest doctor
+```
+
+**Q3：与 `configs/config.yaml`、`.env` 文件的优先级**
+bootstrap 把所有环境变量与当前工作目录原样透传给 Go 二进制，配置加载链与直接跑 `dg-cli` 完全一致：CLI flag > env (`DG_*`) > `configs/config.yaml` > 默认值。
+
+**Q4：内网 / 无公网出口怎么办**
+走 GitLab Generic Package 渠道（详见 `docs/dev-guide/OPS-部署指南.md` 第 4 步「离线兜底」）。
+
+## License
+
+MIT

package/bin/dg-cli.js

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+// dg-cli npm bootstrap: 按 process.platform/arch 解析对应平台子包二进制并透传调用。
+// 设计原则：stdio inherit + 默认 cwd + 默认 env，确保子进程感知到的运行环境与直接跑二进制完全一致。
+
+"use strict";
+const { execFileSync } = require("child_process");
+
+const platform = process.platform; // 'linux' / 'darwin' / 'win32'
+const arch = process.arch;          // 'x64' / 'arm64'
+const pkg = `@gbits-jszx/dg-cli-${platform}-${arch}`;
+const exe = platform === "win32" ? "dg-cli.exe" : "dg-cli";
+
+let binPath;
+try {
+  binPath = require.resolve(`${pkg}/bin/${exe}`);
+} catch (e) {
+  // optionalDependencies 在装包时遇到任何瞬时错误（网络/权限/registry 镜像不同步）都会被
+  // npm 静默跳过、只记 lock，于是这里 require.resolve 找不到。绝大多数情况是缓存或安装
+  // 失败而不是平台真的不支持，按"清缓存 → 强装子包"的顺序给可执行排障步骤。
+  const supported = new Set([
+    "linux-x64", "linux-arm64",
+    "darwin-x64", "darwin-arm64",
+    "win32-x64",
+  ]);
+  const tag = `${platform}-${arch}`;
+  console.error(`[dg-cli] 未能解析平台子包：${pkg}`);
+  if (!supported.has(tag)) {
+    console.error(`[dg-cli] 当前平台 ${tag} 不在支持矩阵内，请联系维护者补齐。`);
+    process.exit(2);
+  }
+  console.error(`[dg-cli] 平台 ${tag} 在支持矩阵内，子包很可能因 npm optionalDependencies 静默跳过未装到。`);
+  console.error(`[dg-cli] 排障步骤（依次尝试，命中即止）：`);
+  console.error(`  1) 清缓存重试：`);
+  console.error(`     rm -rf ~/.npm/_npx ~/.npm/_cacache && npx -y --prefer-online @gbits-jszx/dg-cli@latest --version`);
+  console.error(`  2) 强装当前平台子包：`);
+  console.error(`     npm i -g @gbits-jszx/dg-cli ${pkg}`);
+  console.error(`  3) 内网镜像 registry 同步滞后？换 npmjs 试一次：`);
+  console.error(`     npm --registry=https://registry.npmjs.org/ i -g @gbits-jszx/dg-cli ${pkg}`);
+  process.exit(2);
+}
+
+try {
+  execFileSync(binPath, process.argv.slice(2), {
+    stdio: "inherit",
+    env: process.env,
+  });
+} catch (err) {
+  // 若子进程根本没起来（EACCES / ENOENT 等），stdio:inherit 也拿不到任何输出，
+  // 必须自己打印才能让用户看到根因；正常退出码非 0 时不打扰。
+  if (err && err.code && err.code !== 0 && typeof err.status !== "number") {
+    console.error(`[dg-cli] 启动失败: ${err.code} ${err.message}`);
+    console.error(`[dg-cli] 二进制: ${binPath}`);
+    if (err.code === "EACCES") {
+      console.error(`[dg-cli] 提示: 缺可执行位，尝试 chmod +x "${binPath}" 后重试`);
+    }
+  }
+  process.exit(typeof err.status === "number" ? err.status : 1);
+}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@gbits-jszx/dg-cli",
+  "version": "0.0.0-regress-1777570061",
+  "description": "DataGateway CLI — 部署/运维/配置一站式（Go binary，npx 分发）",
+  "bin": {
+    "dg-cli": "bin/dg-cli.js"
+  },
+  "files": [
+    "bin/",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=14"
+  },
+  "optionalDependencies": {
+    "@gbits-jszx/dg-cli-linux-x64": "0.0.0-regress-1777570061",
+    "@gbits-jszx/dg-cli-linux-arm64": "0.0.0-regress-1777570061",
+    "@gbits-jszx/dg-cli-darwin-x64": "0.0.0-regress-1777570061",
+    "@gbits-jszx/dg-cli-darwin-arm64": "0.0.0-regress-1777570061",
+    "@gbits-jszx/dg-cli-win32-x64": "0.0.0-regress-1777570061"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://m68gitlab.g-bits.com/jszx-infra/datagateway.git"
+  },
+  "keywords": [
+    "datagateway",
+    "cli",
+    "mcp",
+    "gateway"
+  ]
+}