如何在AWS CDK部署过程中执行非CDK代码完成RDS初始化

你当前的建库建表代码直接写在了CDK栈的顶层执行逻辑中，而CDK执行cdk synth命令时会运行所有栈的代码来生成CloudFormation模板，写在顶层的SQL执行逻辑会在这个阶段直接被触发，而非等到部署阶段RDS资源创建完成后运行。

方案1：使用自定义资源（CustomResource）关联Lambda执行初始化逻辑（最推荐） #

该方案是CDK官方推荐的标准实现，完全适配CloudFormation的部署周期：

• 将建库建表的SQL逻辑封装在Lambda函数中，Lambda需配置和RDS实例同VPC的网络访问权限、RDS凭据读取权限、RDS安全组的入站访问规则
• 通过CustomResource关联该Lambda作为资源提供者，给自定义资源添加依赖customResource.node.addDependency(rdsInstance)，强制RDS实例创建完成后才触发Lambda执行
• 初始化逻辑天然在CloudFormation部署阶段运行，不会在synth阶段被触发

方案2：在CI/CD流水线中拆分部署阶段 #

如果你的应用通过CI/CD流程部署，可以直接拆分执行步骤：

1. 第一阶段执行cdk deploy RdsStack部署RDS资源栈，等待部署完成后获取RDS的连接信息
2. 第二阶段在流水线的独立任务中执行建库建表脚本
3. 第三阶段执行cdk deploy BusinessStack部署业务应用栈

方案3：使用SSM Run Command执行初始化脚本 #

如果你有同VPC下的EC2实例资源，可以用该方案避免额外维护Lambda代码：

• 将建库建表逻辑封装为SSM命令文档
• 通过AwsCustomResource在部署阶段调用SSM的SendCommand接口，在RDS创建完成后触发EC2执行初始化脚本

• 所有需要在部署阶段才执行的逻辑，禁止直接写在CDK栈的顶层代码中，必须封装在CloudFormation部署周期可触发的资源（自定义资源、流水线步骤）内
• 初始化SQL逻辑要保证幂等性，建库、建表语句建议添加IF NOT EXISTS判断，避免堆栈更新重复触发初始化时抛出异常
• 如果使用Lambda执行初始化，要根据脚本执行时长调整Lambda的超时时间，最大可配置为15分钟

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