如何通过AWS CDK为Auto Scaling Group配置共享多挂载EBS卷

问题描述 #

我正尝试在AWS中为Auto Scaling Group配置共享EBS卷，目前已通过AWS CDK创建了启用Multi-Attach的ec2.Volume实例，但不知如何通过CDK构造将该外部卷挂载到实例上。LaunchTemplate的blockDevices数组要求为BlockDeviceVolume类型，而我需要将已创建的启用Multi-Attach的外部Volume关联到实例，以支持至少2台实例挂载该设备。

我的CDK代码如下：

const sharedVolume = new ec2.Volume(this, 'shared-volume', {
  availabilityZone: 'us-east-1b',
  size: cdk.Size.gibibytes(100),
  volumeName: 'shared-host-volume',
  volumeType: EbsDeviceVolumeType.IO2,
  enableMultiAttach: true
});
const launchTemplate = new ec2.LaunchTemplate(this, 'web-launch-template', {
  associatePublicIpAddress: true,
  launchTemplateName: 'web-host-template',
  role: role,
  instanceType: ec2.InstanceType.of(ec2.InstanceClass.T3, InstanceSize.MEDIUM),
  machineImage: ec2.MachineImage.latestAmazonLinux2023(),
  userData: ec2.UserData.forLinux(),
  keyPair: keyPair,
  securityGroup: this.props.applicationSecurityGroup,
  blockDevices: [ ]
});

const scalingGroup = new asg.AutoScalingGroup(this, 'web-scaling-group', {
  autoScalingGroupName: 'web-scaling-group',
  vpc: props.vpc,
  vpcSubnets: {
    subnetType: ec2.SubnetType.PUBLIC
  },
  desiredCapacity: 1,
  maxCapacity: 2,
  minCapacity: 0,
  launchTemplate: launchTemplate,
});

解决方案 #

1. 关联已有EBS卷到LaunchTemplate #

使用ec2.BlockDeviceVolume.fromEbsVolume()方法，将已创建的共享卷转换为LaunchTemplate所需的类型，添加到blockDevices数组中。注意设置deleteOnTermination: false，防止实例终止时误删共享卷：

const launchTemplate = new ec2.LaunchTemplate(this, 'web-launch-template', {
  associatePublicIpAddress: true,
  launchTemplateName: 'web-host-template',
  role: role,
  instanceType: ec2.InstanceType.of(ec2.InstanceClass.T3, ec2.InstanceSize.MEDIUM),
  machineImage: ec2.MachineImage.latestAmazonLinux2023(),
  userData: ec2.UserData.forLinux(),
  keyPair: keyPair,
  securityGroup: this.props.applicationSecurityGroup,
  blockDevices: [
    {
      deviceName: '/dev/sdf', // 自定义设备名，需匹配后续挂载命令
      volume: ec2.BlockDeviceVolume.fromEbsVolume(sharedVolume, {
        deleteOnTermination: false
      })
    }
  ]
});

2. 通过UserData自动挂载卷 #

仅关联卷还不够，需要在实例启动时自动完成格式化（首次挂载）和挂载操作，同时配置开机自动挂载：

// 构建UserData命令
const userData = ec2.UserData.forLinux();
userData.addCommands(
  // 检查卷是否已格式化，未格式化则执行XFS格式化
  'if ! lsblk /dev/sdf --noheadings --output FSTYPE | grep -q .; then',
  '  mkfs.xfs /dev/sdf',
  'fi',
  // 创建挂载目录并挂载
  'mkdir -p /mnt/shared',
  'mount /dev/sdf /mnt/shared',
  // 添加到fstab，确保重启后自动挂载
  'echo "/dev/sdf /mnt/shared xfs defaults 0 0" >> /etc/fstab'
);

// 将UserData传入LaunchTemplate
const launchTemplate = new ec2.LaunchTemplate(this, 'web-launch-template', {
  // ... 其他原有配置
  userData: userData,
  // ... 已配置的blockDevices
});

3. 关键注意事项 #

• 可用区匹配：确保ASG的子网和共享卷位于同一可用区（你的卷指定了us-east-1b，需确认ASG的vpcSubnets包含该可用区的公有子网）。
• 文件系统要求：Multi-Attach卷必须使用集群兼容的文件系统（如XFS），ext4等普通文件系统不支持多实例同时挂载。
• 权限验证：确保实例角色拥有ec2:AttachVolume、ec2:DescribeVolumes等必要权限，默认EC2角色通常已包含这些权限。

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