AWS CDK配置ECS挂载基于快照的EBS卷报错解决方案

snapshotId cannot be modified on root device报错的触发逻辑很直接：你配置中指定的/dev/xvda是EC2实例的根设备，AWS EC2启动规则明确限制，根设备的关联快照由所选AMI决定，启动时不支持替换根设备的快照ID，参数校验阶段就会直接抛出这个错误。

你当前的配置只完成了“给EC2实例加块设备”的第一步，离容器内可访问还差几个必要环节，按以下步骤调整即可：

1. 调整块设备配置，分离根盘与自定义快照数据盘 #

不要把自定义快照的EBS卷绑定到根设备路径，根盘只保留默认配置按需调整大小即可，快照卷作为独立数据盘分配非根设备名（C5属于Nitro架构实例，你指定/dev/sdh这类传统设备名后，系统会自动映射为NVMe设备路径/dev/nvme1n1），调整后的块设备配置参考：

block_devices=[
    # 根设备配置，不要传snapshot_id参数
    autoscaling.BlockDevice(
        device_name="/dev/xvda",
        volume=autoscaling.BlockDeviceVolume.ebs(
            volume_size=30,
            volume_type=autoscaling.EbsDeviceVolumeType.GP3
        ),
    ),
    # 自定义快照生成的数据盘
    autoscaling.BlockDevice(
        device_name="/dev/sdh",
        volume=autoscaling.BlockDeviceVolume.ebs_from_snapshot(
            snapshot_id=snapshot_id,
            volume_size=60,
            delete_on_termination=True,
            volume_type=autoscaling.EbsDeviceVolumeType.GP3
        ),
    )
]

2. 配置实例启动脚本自动挂载数据盘 #

EC2实例启动时不会自动将附加的EBS卷挂载到操作系统目录，需要通过User Data脚本在实例首次启动时完成格式化、挂载操作，脚本示例：

#!/bin/bash
# 创建宿主机挂载目录
mkdir -p /data/ebs-vol
# 仅当磁盘未格式化时执行xfs格式化，避免覆盖快照中已有数据
file -s /dev/nvme1n1 | grep -q 'data' && mkfs -t xfs /dev/nvme1n1
# 挂载磁盘到指定目录
mount /dev/nvme1n1 /data/ebs-vol
# 写入fstab保证重启后自动挂载
echo "/dev/nvme1n1 /data/ebs-vol xfs defaults,nofail 0 2" >> /etc/fstab

在CDK的Auto Scaling Group配置中，将上述脚本传入user_data参数即可。

3. 配置ECS任务卷映射，打通宿主机到容器的路径 #

块设备挂载完成后卷仅在EC2宿主机上可见，需要在ECS任务定义中声明宿主机卷，再将卷挂载到容器内部路径，CDK配置参考：

# 定义EC2启动类型的任务
task_definition = ecs.Ec2TaskDefinition(self, "AppTaskDef")
# 关联宿主机上已挂载的EBS卷目录
task_definition.add_volume(
    name="app-data-volume",
    host=ecs.Host(source_path="/data/ebs-vol")
)
# 添加业务容器
app_container = task_definition.add_container(
    "AppContainer",
    image=ecs.ContainerImage.from_registry("your-business-image:v1"),
    memory_limit_mib=4096,
    cpu=2048
)
# 将卷挂载到容器内部指定路径
app_container.add_mount_points(
    ecs.MountPoint(
        container_path="/opt/app/data", # 容器内访问该卷的路径
        source_volume="app-data-volume",
        read_only=False
    )
)

• 基于快照创建的EBS卷是独立块存储，仅能挂载到单台EC2实例，无法在ECS集群多实例间共享，如果需要多实例共享存储，需要替换为EFS服务。
• Nitro架构实例的设备名会自动转换，脚本中要注意核对实际NVMe设备编号，避免挂载失败。
• 如果快照中已经存在文件系统，不要重复执行格式化操作，否则会丢失快照内原有数据。

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