如何使用CDK/CloudFormation导入并修改已有云资源（以RDS为例）

1. 将现有RDS实例纳入CDK管理 #

首先要把手动创建的RDS实例导入到CDK栈中，核心是让CDK生成的CloudFormation模板与现有实例属性完全匹配：

• 在CDK代码中定义对应RDS资源，确保所有属性（引擎版本、实例ID、VPC配置、存储设置等）与现有实例一致，暂时保留原有实例类型：

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

const app = new cdk.App();
const stack = new cdk.Stack(app, 'RdsManagementStack');

// 通过fromLookup获取现有VPC（如果VPC是手动创建的）
const existingVpc = ec2.Vpc.fromLookup(stack, 'ExistingVpc', {
  vpcId: 'vpc-xxxxxx', // 替换为你的VPC ID
});

// 定义与手动RDS匹配的资源
const managedRds = new rds.DatabaseInstance(stack, 'ManagedRds', {
  engine: rds.DatabaseInstanceEngine.mysql({ version: rds.MysqlEngineVersion.VER_8_0_33 }), // 匹配现有引擎版本
  instanceIdentifier: 'my-manual-rds-instance', // 替换为你的RDS实例ID
  instanceType: ec2.InstanceType.of(ec2.InstanceClass.T3, ec2.InstanceSize.MICRO), // 原有实例类型
  vpc: existingVpc,
  multiAz: false, // 匹配现有实例的多AZ设置
  storageType: rds.StorageType.GP2, // 匹配现有存储类型
  // 其他必要属性请根据实际实例补充
});

• 生成CloudFormation模板并导入资源：
  运行命令生成模板：

  cdk synth RdsManagementStack > rds-template.yaml
  

  然后使用CDK导入命令将现有实例纳入栈管理：

  cdk import
  

  导入过程中CDK会验证资源属性是否匹配，匹配成功后该实例就归CloudFormation/CDK管理了。

2. 修改实例类型并部署 #

• 修改CDK代码中的instanceType属性为目标类型，例如：

instanceType: ec2.InstanceType.of(ec2.InstanceClass.T3, ec2.InstanceSize.SMALL),

• 运行部署命令执行修改：

cdk deploy RdsManagementStack

CloudFormation会触发RDS实例的类型更新，这个过程可能会导致实例重启，请提前做好业务中断准备。

注意事项 #

• 导入时必须保证CDK定义的所有属性与现有实例完全一致，否则导入会失败。
• RDS部分属性修改后无法回滚，操作前请确认目标配置。
• 如果不熟悉CDK导入流程，也可以直接通过CloudFormation控制台选择"导入现有资源"，上传生成的模板并指定RDS实例ID完成导入，后续再通过模板修改实例类型并更新栈。

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