用途:Pulumi ESC 用于集中管理跨云基础设施与应用的环境、密钥和配置。团队可将密钥与配置集中存放、通过导入分层组合环境、用 OIDC 为 AWS/Azure/GCP 生成动态凭证、集成外部密钥库(AWS Secrets Manager、Azure Key Vault、Vault、1Password),并对配置变更做版本与审计,配合细粒度 RBAC 控制访问。
主要能力:环境为 YAML 文档,保留顶层键 imports(导入组合其他环境)与 values(定义配置与密钥);values 下保留子键 environmentVariables(映射为 shell 环境变量)、pulumiConfig(配置 Pulumi 栈设置)、files(生成文件)。敏感值用 fn::secret。可用 fn::open::pulumi-stacks 读取其他栈的输出,栈以 <project>/<stackName> 单字段命名,输出直接位于栈名之下(如 ${stacks.network.vpcId},无 .outputs 层级)。
常用命令:pulumi env init <org>/<project-name>/<environment-name> 创建环境;pulumi env edit 编辑;pulumi env set <key> <value> 及 --secret 设置值;pulumi env get 查看定义(密钥显示为 [secret]);pulumi env open 解析并显示全部值(含密钥与动态凭证);pulumi env run <env> -- <command> 以环境变量执行命令;pulumi config env add <project-name>/<environment-name> 关联到 Pulumi 栈。控制台地址为 https://app.pulumi.com/<org>/esc/<project>/<environment>。
适用场景:新建或迁移环境配置、设置 AWS OIDC 等动态凭证、调试凭证错误、将环境关联到栈。
限制与注意:优先使用 pulumi env 子命令而非 esc CLI;仅在必要时用 API。pulumi env open 会暴露密钥,须谨慎。不得仅凭名称选择已有环境,须先用 pulumi env get 检查并确认目标账户与角色;关联环境(pulumi config env add)会改变操作所用凭证,必须获得用户明确确认,且不得传 --yes。关联后凭证常显示 [unknown],须验证后再声称成功。更多语法与集成细节见官方文档。