用途:为 MaintainX 集成配置开发、预发布(staging)和生产三套环境,实现环境专属配置、密钥管理与客户端隔离。
主要能力:提供类型安全的配置加载器(按环境返回 apiKey、orgId、baseUrl、label 与速率限制);客户端工厂按环境缓存并返回隔离的 MaintainXClient;支持 .env.development、.env.staging、.env.production 文件并配合 .gitignore 防止提交真实密钥;集成 GCP Secret Manager 读取生产密钥;提供验证脚本逐一检查各环境凭据是否可用。
使用方式:需为每个环境准备独立的 MaintainX 账号或组织,并具备密钥管理方案(环境变量、GCP Secret Manager 或 AWS SSM),运行环境要求 Node.js 18+。通过 MAINTAINX_ENV 指定当前环境,配置项从对应环境变量读取;客户端通过 getClient(env) 获取。验证脚本可用 npx tsx scripts/validate-environments.ts 运行。
适用场景:需要在多个 MaintainX 环境间切换的开发、测试与部署流程,例如 GitHub Actions 按分支选择环境并注入对应密钥。
限制:资料未提供具体价格、平台支持范围或性能数据;示例中的项目名、密钥名与组织 ID 需替换为实际值;GCP Secret Manager 需具备 secretmanager.secretAccessor 权限,否则会返回 403。