storage-resize

Storage resize - 磁盘扩容

核心定位

两阶段磁盘扩容流程：

1. 云平台阶段：使用 aliyun-ecs skill 完成云盘扩容
2. 操作系统阶段：执行分区调整和文件系统扩容

重要约束：

• ☁️ 阿里云云盘仅支持扩容，不支持缩容
• 📀 支持系统盘和数据盘两种场景
• ⚡ 在线扩容：云盘扩容后无需重启实例，通过 NVMe 重新扫描即可识别（NVMe 设备）

---

前置要求

1. 依赖技能

本技能依赖 aliyun-ecs skill 进行云平台操作：

• 查询磁盘信息 (DescribeDisks)
• 执行磁盘扩容 (ResizeDisk)
• 查询实例信息 (DescribeInstances)

2. 工具安装

# 检查并安装必要工具
yum install -y cloud-utils-growpart xfsprogs e2fsprogs btrfs-progs

# 验证工具已安装
which growpart xfs_growfs resize2fs

3. 权限要求

• 阿里云 CLI 认证：需配置 aliyun configure（优先使用 EcsRamRole）
• 系统权限：需要 root 权限执行分区和文件系统操作

---

快速开始

一键扩容流程

# 1. 确认设备名称和文件系统类型
lsblk -f /dev/nvme0n1

# 2. 云平台扩容（使用 aliyun-ecs skill）
# aliyun ecs ResizeDisk --DiskId <disk-id> --NewSize <new-size> --RegionId <region>

# 3. NVMe 设备重新扫描（让 OS 识别新容量）
echo 1 > /sys/block/nvme0n1/device/rescan_controller

# 4. 确认新容量已识别
lsblk /dev/nvme0n1

# 5. 扩容分区
growpart /dev/nvme0n1 3

# 6. 扩容文件系统（根据类型选择命令）
xfs_growfs /          # XFS（使用挂载点）
resize2fs /dev/nvme0n1p3   # EXT4（使用设备路径）

# 7. 验证
df -h /

---

文件系统支持

文件系统	扩容命令	参数类型	备注
XFS	xfs_growfs /mountpoint	挂载点	Alinux4 默认文件系统
EXT4	resize2fs /dev/vdb1	设备路径	支持在线扩容
Btrfs	btrfs filesystem resize max /mountpoint	挂载点	需要 btrfs-progs

文件系统类型检测

# 方法 1: 使用 df
df -T /

# 方法 2: 使用 lsblk
lsblk -f /dev/nvme0n1p3

# 方法 3: 使用 mount
mount | grep "on / "

---

完整流程

步骤 1: 云平台扩容（使用 aliyun-ecs skill）

# 获取实例 ID 和地域（ECS 实例内）
INSTANCE_ID=$(curl -s http://100.100.100.200/latest/meta-data/instance-id)
REGION_ID=$(curl -s http://100.100.100.200/latest/meta-data/region-id)

# 查询系统盘信息
aliyun ecs DescribeDisks \
  --RegionId $REGION_ID \
  --InstanceId $INSTANCE_ID \
  --DiskType system

# 执行扩容（例如：40GB → 90GB）
aliyun ecs ResizeDisk \
  --DiskId d-bp1234567890abcdef \
  --NewSize 90 \
  --RegionId $REGION_ID

步骤 2: 操作系统内扩容

# 2.1 识别设备类型
lsblk

# 2.2 NVMe 设备重新扫描（关键步骤！）
# 云盘扩容后，NVMe 设备需要重新扫描控制器才能识别新容量
echo 1 > /sys/block/nvme0n1/device/rescan_controller

# 2.3 验证新容量已识别
lsblk /dev/nvme0n1

# 2.4 扩容分区
growpart /dev/nvme0n1 3

# 2.5 扩容文件系统
# 先确认文件系统类型
FS_TYPE=$(df -T / | tail -1 | awk '{print $2}')

if [ "$FS_TYPE" = "xfs" ]; then
    xfs_growfs /
elif [ "$FS_TYPE" = "ext4" ]; then
    resize2fs /dev/nvme0n1p3
elif [ "$FS_TYPE" = "btrfs" ]; then
    btrfs filesystem resize max /
fi

# 2.6 验证结果
df -h /
lsblk /dev/nvme0n1