@gbits-jszx/dg-cli

DataGateway CLI — 部署 / 运维 / 配置一站式工具，Go 二进制经由 npx 分发。

安装与使用

# 一次性运行（推荐）
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 项目仓库。

常见问题

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）。临时切回：

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