如何更新CDK/CloudFormation中定义的RDS集群实例类型

问题根源 #

你遇到的报错核心有两个原因：

1. 你先在控制台手动修改了CDK管理的资源，产生了配置漂移，CDK存储的预期配置和云上实际资源状态不一致，导致部署时校验失败。
2. 对于CDK定义的RDS DatabaseCluster（如Aurora集群），实例规格是集群层面的统一配置项，不允许单独修改集群内单个DB实例的规格，你后续同步CDK配置时如果错误修改了单个实例的属性，就会触发该报错。

修复步骤 #

第一步：修正配置漂移（必须优先完成） #

首先对齐CDK配置和云上实际资源状态，消除漂移冲突：

• 运行cdk diff查看当前CDK代码和云上资源的所有差异项
• 暂时将CDK中集群的实例规格值改为你在控制台已经修改后的目标规格，执行cdk deploy完成状态同步，确保无报错后再进行后续操作

第二步：正确修改集群实例规格配置 #

直接修改DatabaseCluster构造函数下instanceProps中的instanceType参数即可，不需要单独调整集群内的实例配置，参考TS代码示例：

import * as rds from 'aws-cdk-lib/aws-rds';
import * as ec2 from 'aws-cdk-lib/aws-ec2';

const auroraCluster = new rds.DatabaseCluster(this, 'BusinessAuroraCluster', {
  engine: rds.DatabaseClusterEngine.auroraMysql({ 
    version: rds.AuroraMysqlEngineVersion.VER_3_03_0 
  }),
  // 核心修改：调整这里的实例规格为目标值即可
  instanceProps: {
    vpc: vpc,
    instanceType: ec2.InstanceType.of(ec2.InstanceClass.R6G, ec2.InstanceSize.XLARGE2),
  },
  // 无停机升级关键配置
  applyImmediately: false, // 设为false则变更会在集群的维护窗口执行，不会主动触发业务中断；需要立即升级可改为true
});

第三步：执行部署验证 #

• 改完配置后先运行cdk diff确认变更仅涉及实例规格调整，无其他意外变更
• 确认无误后执行cdk deploy触发正式更新

无停机升级说明 #

只要你的集群是多AZ部署的生产级集群，升级过程会首先升级备用实例，完成后自动执行秒级故障切换，仅会产生30秒内的连接闪断，业务侧只要配置了合理的数据库重连逻辑，即可实现用户无感知的无停机升级。

注意事项 #

• 后续不要在控制台手动修改CDK管理的资源，避免出现配置漂移导致部署失败
• 如果你的集群是单实例部署，升级过程会存在数分钟的停机，建议在业务低峰期操作
• 升级前建议提前创建集群快照，用于异常场景下的回滚恢复

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