AWS CloudFormation Bash命令示例部署堆栈失败排查方法
排查CloudFormation堆栈中IopsCalculator资源创建失败的实操步骤
- 提取堆栈事件的明确错误原因
执行aws cloudformation describe-stack-events --stack-name comandrunner-test-iops命令,拉取该堆栈全生命周期的事件记录,定位到IopsCalculator资源对应的事件条目,重点读取「Resource Status Reason」字段的明文报错。该字段会直接给出资源失败的核心触发原因,常见的包括IAM权限不足、依赖组件缺失、参数不合法、服务配额超限等,无需靠猜测定位问题。 - 核查自定义资源的执行链路日志
该场景下IopsCalculator属于通过bash脚本执行逻辑的自定义资源,CloudFormation本身仅会透传自定义资源的状态码,真正的脚本运行报错需要追溯到对应的执行日志:- 先确认自定义资源关联的Lambda执行角色,是否具备CloudWatch Logs的写入权限
- 打开对应Lambda函数的日志组,定位到堆栈创建时间窗口内的运行记录,查看bash脚本的标准输出、错误输出,常见问题包括:脚本依赖的计算工具未安装、临时文件写入权限不足、返回给CloudFormation的响应格式不符合自定义资源协议要求
- 核对模板与配置的一致性
检查本地模板文件的内容:- 确认自定义资源的ServiceToken是否指向已部署完成的Lambda函数ARN,是否存在ARN输入错误、跨区域配置不匹配的问题
- 核对模板内的EBS相关参数值,确认没有触发EBS服务的IOPS、容量配置上限,没有超出账号的服务配额限制
- 验证回滚触发源
针对报错提示的“Rollback requested by user”信息,确认部署过程中是否存在手动触发操作:- 检查部署CLI命令执行过程中是否被手动中断(如按键中断、网络断开导致CLI进程退出)
- 确认是否有其他账号权限持有者在堆栈控制台手动点击了回滚按钮,导致处于创建过程中的资源被直接标记为失败
内容的提问来源于stack exchange,提问作者shantanuo
相关产品推荐
相关产品推荐

