面向中文开发者的 AWS 实战知识库 代维服务
上云咨询

CloudFormation(CloudFormation)服务指南:入门 · 配置 · 排错 · 代运维 · 部署

快速信息

它是什么

CloudFormation 是 AWS 的基础设施即代码(IaC)服务。你把期望的资源形态写进一份 JSON 或 YAML 模板,服务端解析模板、计算资源之间的依赖关系,然后按正确顺序调用各服务的 API 完成创建、更新和删除。它不承载业务流量,位于控制面,负责编排,本身不是运行时组件。

它的部署单元叫 Stack。一个 Stack 是一组共享同一生命周期的资源集合,CloudFormation 在服务端维护每个 Stack 的状态机,并记录每个资源被创建出来的物理标识(例如实例 ID、桶名、ENI ID)。这一点和需要自己保管 state 文件的方案不同:状态由服务托管,多人协作时不需要额外的锁机制。

边界上容易混淆的几个服务:SAM 和 CDK 都是「作者体验层」,最终产物仍然是 CloudFormation 模板,由 CloudFormation 执行部署;Elastic Beanstalk 面向应用运行环境,内部会创建 CloudFormation 栈,但你通常不直接操作模板。Terraform 是功能相近的第三方替代品,二者不是同层协作关系而是二选一。AWS Config 关注资源配置的合规审计与变更记录,不做创建动作。理解这条分工,就知道 CloudFormation 该放在 CI/CD 流水线的「部署」阶段,而不是「监控」阶段。

核心概念

  • Template(模板):一份声明式描述文件,包含 Resources 必选段,以及 Parameters、Mappings、Conditions、Outputs 等可选段。
  • Stack(栈):模板的一次实例化部署,是资源管理、更新、删除和权限控制的最小单位。
  • Change Set(更改集):对已有栈应用新模板前的预演,列出将新增、修改、替换、删除的资源,确认后再执行。
  • Parameter 与 Output:Parameter 是部署时注入的入参,Output 是把栈内资源属性导出给其他栈或人工使用的出口,常配合 Export/Import 做跨栈引用。
  • Nested Stack 与 StackSet:Nested Stack 用一个大模板拆成多个子栈以便复用;StackSet 把同一套模板批量下发到多个账号和区域。

典型场景

  • 把一套环境(VPC、子网、安全组、负载均衡、实例)写成模板,一次部署到开发、测试、生产三个账号。用它可以保证环境之间结构完全一致,避免手工配置漂移。
  • 把模板放进 Git,由 CodePipeline 或第三方 CI 在合并后自动触发部署。用它可以把变更纳入代码评审和回滚流程。
  • 用 StackSet 给组织内的所有成员账号统一铺设审计日志桶、告警主题等基线资源。用它可以在账号数量增长时避免逐个手工配置。
  • 临时拉起一套演示或压测环境,用完删栈回收。用它可以让清理变成一次操作,而不是逐个服务翻查有没有漏删的资源。

计费与成本要点

  • CloudFormation 本身通常不单独收费,成本来自它创建出来的底层资源,例如 EC2 实例、NAT Gateway、EBS 卷。计费以各服务官方文档为准。
  • 创建失败的栈可能已经建成了部分资源,尤其在使用回滚不完整的自定义资源时。需要查看栈事件中哪些资源已进入 CREATE_COMPLETE,确认无残留后再删栈。
  • 模板里设置了 DeletionPolicy: Retain 的资源,在删栈后仍然保留并继续产生费用,适合保护数据库和存储桶,但要有单独的清理流程。
  • 改配置前先走 Change Set,重点看哪些资源被标记为 Replacement。替换型更新会先建新资源再删旧资源,短时间内可能出现双份开销。

上手步骤

  1. 在本地新建 template.yaml,先写最小可用内容:一个 S3 桶加一个 Output 输出桶名。保持 YAML 缩进一致,字符串中的冒号加引号。
  2. 运行 aws cloudformation validate-template --template-body file://template.yaml。返回 Parameters 列表或空对象即语法通过;报错会指出行号,改完重跑。
  3. 运行 aws cloudformation create-stack --stack-name demo --template-body file://template.yaml --capabilities CAPABILITY_IAM。模板含 IAM 资源时必须显式声明 capabilities,否则会被拒绝并给出明确提示。
  4. 用 aws cloudformation describe-stacks --stack-name demo --query "Stacks[0].StackStatus" 轮询状态,直到 CREATE_COMPLETE;再用 describe-stack-resources 核对资源物理 ID 是否符合预期。
  5. 修改模板(例如加一个标签),先 create-change-set 再 describe-change-set 查看变更清单,确认无 Replacement 后执行 execute-change-set。
  6. 验证清理:aws cloudformation delete-stack --stack-name demo,随后 describe-stacks 应返回 DELETE_COMPLETE 或栈不存在,同时到目标服务确认资源已消失。

常见问题与排查

创建失败,栈进入 ROLLBACK_COMPLETE,事件列表只写「Resource creation cancelled」

原因:真正的根因通常在被取消资源的上一条事件里,例如实例类型在该 AZ 不可用、AMI ID 不存在、S3 桶名已被全局占用。取消类事件本身只是回滚过程的副产物。

处理:在控制台 Events 标签按时间正序查看,找到第一个状态为某资源 FAILED 的记录,展开 Status reason 读原文。修好模板后该栈无法直接更新,需要先删除再重建。

更新失败,栈停在 UPDATE_ROLLBACK_FAILED

原因:更新过程中某个资源既无法完成也无法回滚,典型场景是资源被手工改动、底层服务处于不一致状态,或自定义资源在回滚时抛出异常。

处理:先到目标服务把该资源手工修复到可被 CloudFormation 管理的状态,再执行 continue-update-rollback,必要时用 --resources-to-skip 跳过卡住的资源。之后重新发起一次干净的更新。

删除栈失败,状态为 DELETE_FAILED

原因:常见于 S3 桶非空、安全组仍被栈外资源引用、ECR 仓库内有镜像。CloudFormation 不负责清空数据,只会报告依赖冲突。

处理:按事件提示清空桶内对象或解除外部依赖后重试删除;确实需要保留的资源可用 --retain-resources 逻辑先分离,再单独删栈。

模板校验通过,但部署时报「属性不支持」或权限不足

原因:validate-template 只检查语法和模板结构,不校验资源属性是否被目标区域支持,也不验证执行身份是否具备所需权限。

处理:确认区域与资源类型的可用性,检查执行角色是否需要 CAPABILITY_IAM / CAPABILITY_NAMED_IAM,以及角色策略是否覆盖了模板中涉及的每一项服务动作。以官方文档中各资源类型的属性说明为准。

最佳实践

  • 模板纳入 Git 管理,配合 Change Set 在合并前做一次预演,把「计划中的变更」当作评审材料,而不是直接执行。
  • 把可变部分抽成 Parameter,把稳定标识抽成 Output 并在其他栈中通过 ImportValue 引用,避免硬编码资源名。
  • 对数据库、存储桶等有状态资源显式声明 DeletionPolicy 和 UpdateReplacePolicy,防止一次误操作导致不可恢复的替换。
  • 对生产栈开启终止保护(EnableTerminationProtection),并为模板与栈统一打标签,便于成本分摊和批量检索。

常见问题

CloudFormation 和 Terraform 主要区别是什么?

CloudFormation 由 AWS 托管状态并使用 AWS 原生语法,深度集成 IAM 与 StackSets;Terraform 跨云、生态更广但需自行管理 state。单云场景两者都可行。

模板写错会不会把线上资源删掉?

直接更新确实可能触发资源替换或删除。建议始终先创建 Change Set 查看变更清单,对有状态资源设置 DeletionPolicy: Retain,并开启终止保护。

自定义资源(Custom Resource)什么时候需要?

当某个配置动作没有对应的原生资源类型时使用,通常由 Lambda 响应 CloudFormation 的创建、更新、删除请求。代价是回滚路径变复杂,需要额外测试。

栈之间如何共享值?

用 Output 导出为 Export,另一个栈通过 Fn::ImportValue 引用。注意被引用方在引用方删除前无法删除,跨区域不支持直接导入。

CloudFormation 支持回滚到旧版本吗?

不支持直接回退到某个历史版本。可行做法是保留上一版模板,用 Change Set 重新部署旧模板,并确认资源替换带来的数据影响。

StackSets 和目标账号的权限怎么配?

通常由管理账号通过 CloudFormation StackSets 结合 AWS Organizations 或 IAM 角色下发,需要在目标账号创建信任角色。具体步骤以官方文档为准。