SuperAPI AI 工具集

ssm-runtime-configuration

部署与运维

查看项目

更新于 10-16 00:01

技能介绍

用途:解决配置分散在 .env 文件、CI/CD 密钥和云资源中导致不同步、难管理的问题,把 AWS SSM Parameter Store 作为运行时配置的唯一来源。适用于 AWS 无服务器应用、多环境部署、含敏感配置的项目以及 CI/CD 流水线。

主要能力:按 /{project-id}/{environment}/{service}/VARIABLE_NAME 的命名空间组织参数,按环境隔离,敏感值保存在 AWS 中不进入仓库;流水线可直接从 SSM 取配置,无需本地文件;支持不重新部署即变更配置。

使用方式:应用启动时用 @aws-sdk/client-ssm 的 SSMClient 与 GetParameterCommand 按路径批量获取参数,local 环境可再用 .env.local 覆盖。基础设施用 infrastructure/.env 保存 CDK_DEFAULT_ACCOUNT、CDK_DEFAULT_REGION 等引导配置(不含密钥,可提交);service/.env.local 为本地覆盖(须 gitignore);.env_TEMPLATE 用于记录变量。CLI 示例:ssm-params get /{project-id}/dev/frontend/API_ENDPOINT,ssm-params export-service dev frontend > .env。

限制与权衡:本地开发需要 AWS 访问权限;启动时有网络调用,略慢于纯 .env;比简单 .env 文件更复杂。非 AWS 项目、无敏感配置的简单应用、不涉及多环境的项目不建议使用。该技能为参考模式,需按自身上下文调整,不应逐字复制。