CDK配置Batch计算环境关联LaunchTemplate报NotStabilized错误

排查方向与修复方法 #

• 优先排查配置冲突
  托管式EC2类型的Batch计算环境会自动接管实例的用户数据注入、IAM实例Profile挂载、网卡/安全组/子网关联逻辑，只要LaunchTemplate里手动配置了UserData、IamInstanceProfile、NetworkInterfaces（包含子网、安全组、公网IP分配规则）这类参数，就会和Batch的管控逻辑冲突，导致实例没法正常加入集群，最后抛出未稳定错误。你代码里用LaunchTemplate改块存储的逻辑本身是合规的，重点检查下省略的卷配置之外，CDK生成的LaunchTemplate有没有自动追加上述冲突参数。
• 补全资源强依赖
  现有CDK代码没有显式声明计算环境对LaunchTemplate的依赖，CloudFormation做资源编排的时候，可能在LaunchTemplate还没完全生效的阶段就发起Batch计算环境的创建请求，触发资源未就绪错误。直接在计算环境的构造代码里加一行显式依赖，强制部署顺序即可：

  computeEnv.addDependency(jobLaunchTemplate)
  

• 校验LaunchTemplate和所选实例的兼容性
  第一，你选的是C4.large实例，属于EBS优化型，不支持本地实例存储，如果卷配置里错误加了实例存储映射、或者指定了C4系列不支持的EBS卷类型，实例会直接启动失败。第二，检查LaunchTemplate的InstanceInitiatedShutdownBehavior参数，必须设为terminate，要是设成了stop，会和Batch托管环境的缩容终止逻辑冲突，过不了稳定校验。第三，Batch关联LaunchTemplate时如果不指定版本，默认拉取LaunchTemplate的$Default版本，确认这个默认版本没有错误配置，不要关联到历史的错误版本。
• 校验IAM角色权限
  你代码里instanceRole传的是jobRole.roleName，先确认这个角色是合法的EC2实例角色：信任策略必须同时允许ec2.amazonaws.com和batch.amazonaws.com执行sts:AssumeRole操作，还要附加AmazonEC2ContainerServiceforEC2Role、AmazonSSMManagedInstanceCore这类Batch计算节点必需的权限策略，要是角色权限不对，实例启动后没法向Batch服务注册，资源会一直卡在稳定流程里。

快速验证方法 #

直接去EC2控制台，用你创建好的LaunchTemplate手动起一台同规格的C4.large实例，要是手动启动都失败，跟着实例的启动报错改LaunchTemplate配置就行；要是手动启动完全正常，再回头排查Batch侧的配置冲突、权限、资源依赖类问题。

内容的提问来源于stack exchange，提问作者Sam