如何通过Terraform获取EBS盘UUID？解决c5实例NVME盘符映射不一致问题

一、搞定NVME盘符重启后乱序的核心思路 #

先明确一个关键点：AWS c5这类NVME实例的设备名（比如/dev/nvme1n1）确实会在重启、停止再启动后发生变化——这是NVME设备枚举顺序的特性，和Terraform无关。绝对不要依赖设备名来挂载磁盘，靠谱的方案有两种：

1. 用EBS卷ID绑定持久化路径

AWS会给每个EBS卷在实例内生成一个唯一的持久化路径，格式是/dev/disk/by-id/nvme-Amazon_Elastic_Block_Store_<你的卷ID>。比如你的卷ID是vol-0123456789abcdef0，对应的路径就是/dev/disk/by-id/nvme-Amazon_Elastic_Block_Store_vol-0123456789abcdef0，这个路径永远和卷绑定，不会随重启变。

你可以在Terraform的user_data里写自动挂载逻辑：

#!/bin/bash
# 替换成你的目标EBS卷ID
TARGET_VOLUME="vol-0123456789abcdef0"
# 找到对应持久化路径
DEVICE_PATH=$(find /dev/disk/by-id/ -name "*$TARGET_VOLUME*")
# 创建挂载点
mkdir -p /data
# 挂载并写入fstab确保开机自动挂载
mount $DEVICE_PATH /data
echo "$DEVICE_PATH /data ext4 defaults 0 0" >> /etc/fstab

2. 用磁盘UUID挂载

磁盘UUID是操作系统层面的唯一标识，同样不会随设备名变化。你可以在实例启动后通过blkid命令获取，再写入/etc/fstab。

二、Terraform里怎么获取EBS UUID？ #

要说明白：EBS卷的UUID是操作系统生成的，不是AWS的API属性，所以Terraform没法直接通过AWS Provider拿到。得通过实例内的命令获取，推荐两种方式：

方式1：用remote-exec获取并存入本地

适合需要在Terraform state里记录UUID的场景：

resource "aws_instance" "c5_node" {
  ami           = "ami-0c55b159cbfafe1f0" # 替换成你的AMI ID
  instance_type = "c5.large"

  # 附加目标EBS卷
  ebs_block_device {
    device_name = "/dev/sdf"
    volume_id   = aws_ebs_volume.data_disk.id
  }

  # 远程执行命令拿UUID
  provisioner "remote-exec" {
    inline = [
      "blkid -s UUID -o value /dev/nvme1n1 > /tmp/disk_uuid.txt",
    ]

    connection {
      type        = "ssh"
      user        = "ec2-user" #  Ubuntu系统用ubuntu
      private_key = file("~/.ssh/id_rsa")
      host        = self.public_ip
    }
  }

  # 可选：把UUID同步到本地文件
  provisioner "local-exec" {
    command = "scp ec2-user@${self.public_ip}:/tmp/disk_uuid.txt ./data_disk_uuid.txt"
  }
}

resource "aws_ebs_volume" "data_disk" {
  availability_zone = aws_instance.c5_node.availability_zone
  size              = 50
}

方式2：直接在user_data里完成配置（更推荐）

不用依赖SSH连接，启动时自动搞定挂载，稳定性更高：

resource "aws_instance" "c5_node" {
  ami           = "ami-0c55b159cbfafe1f0"
  instance_type = "c5.large"

  ebs_block_device {
    device_name = "/dev/sdf"
    volume_id   = aws_ebs_volume.data_disk.id
  }

  user_data = <<-EOF
              #!/bin/bash
              # 等NVME设备初始化完成
              sleep 10
              # 获取磁盘UUID
              DISK_UUID=$(blkid -s UUID -o value /dev/nvme1n1)
              # 创建挂载点+写入fstab+挂载
              mkdir -p /data
              echo "UUID=$DISK_UUID /data ext4 defaults 0 0" >> /etc/fstab
              mount -a
              EOF
}

总结 #

• 彻底规避盘符变化问题：放弃设备名，改用/dev/disk/by-id路径或UUID；
• Terraform拿UUID只能通过实例内命令，优先用user_data配置，减少依赖更可靠。

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