@clever.gy/gcloud-env-secrets

中文文档
1.1.0发布于 2026/06/29MITES Module近 30 天下载 1865

通过检索并插入Google Cloud 秘密管理器的秘密, 从模板生成.env 文件的工具

中文使用文档
文档目录9 节
  1. 说明
  2. * 特性
  3. * 安装
  4. · 先决条件
  5. 使用量
  6. 参数
  7. 模板格式
  8. 发展
  9. • 警卫

@clever.gy/gcloud-env-机密

从 Google 云密管理器获取秘密并生成的 CLI 工具 .env 基于模板的文件.

说明

@clever.gy/gcloud-env-secrets 是一个生成环境文件的命令行工具( q).env通过将模板中的占位符替换为从Google Cloud Secret Management获取的实际值.

* 特性

  • 从 Google 云秘密管理器获取机密
  • 生成 .env 带有占位符的模板文件
  • 校验 gcloud 执行前的配置
  • 在覆盖已存在文件前提示确认

* 安装

npm install -g @clever.gy/gcloud-env-secrets

或在项目中安装:

npm install --save-dev @clever.gy/gcloud-env-secrets

· 先决条件

  1. Google Cloud SDK (gloud) (英语) 安装和配置

  2. 用 Google 云认证

    gcloud auth application-default login
    
  3. GCP 项目已配置

    gcloud config set project YOUR_GCP_PROJECT
    
  4. 所需权限: 您的账户必须拥有访问指定项目中的秘密管理器的权限 .

使用量

gcloud-env-secrets <gcpProjectName> <envFileTemplatePath> <envFileOutputPath>

示例

gcloud-env-secrets my-gcp-project .env.template .env

参数

  • gcpProjectName: Google 云平台项目名称
  • envFileTemplatePath: 路径 .env 带有占位符的模板文件
  • envFileOutputPath: 最终方向的路径 .env 将生成文件

模板格式

使用格式创建有占位符的模板文件 $$SECRET{secret-name}数字 :

DATABASE_URL=$$SECRET{database-url}
API_KEY=$$SECRET{api-key}
JWT_SECRET=$$SECRET{jwt-secret}

工具会找到所有占位符,取而代之的是来自"秘密管理器"的实际值.

发展

npm run lint     # Lint the code
npm start        # Run in development mode
npm run build    # Build the project

• 警卫

  • ⚠️ 从不 生成的承诺 .env 转到您的仓库的文件
  • 使用时间 .gitignore 排除 .env 文件
  • QQ 保留模板(.env.template无敏感值的存储器中

版本与发布记录

@clever.gy/gcloud-env-secrets 共发布 3 个版本,首次发布于 2026/05/05;过去 12 个月发布了 3 个版本。

版本发布日期距今
1.1.0latest2026/06/294 个月前
1.0.12026/05/056 个月前
1.0.02026/05/056 个月前

关于 @clever.gy/gcloud-env-secrets 的常见问题

@clever.gy/gcloud-env-secrets 是什么?

通过检索并插入Google Cloud 秘密管理器的秘密, 从模板生成.env 文件的工具

如何安装 @clever.gy/gcloud-env-secrets?

在项目目录运行 npm install @clever.gy/gcloud-env-secrets,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 gcloud-env-secrets,可以用 npx gcloud-env-secrets 直接运行。

@clever.gy/gcloud-env-secrets 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/clever.gy__gcloud-env-secrets 是否存在。

@clever.gy/gcloud-env-secrets 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@clever.gy/gcloud-env-secrets 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@clever.gy/gcloud-env-secrets 可以商用吗?

@clever.gy/gcloud-env-secrets 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@clever.gy/gcloud-env-secrets 的下载量有多少?

根据 npm 官方下载统计,@clever.gy/gcloud-env-secrets 在 2026/10/10 – 2026/11/08 这 30 天内被下载 1,865 次,日均约 62 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@clever.gy/gcloud-env-secrets 还在维护吗?

最新版本 1.1.0 发布于 2026/06/29(4 个月前);至今共发布 3 个版本,其中过去 12 个月发布了 3 个;首次发布于 2026/05/05。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。