mkfs.ext4 /dev/vdb
mkdir -p /data
mount /dev/vdb /data
扩容数据盘
# Resize data disk (reads target size from vms.csv)uv run ansible-playbook playbooks/resize-data-disk.yaml -e vm_name=debian12-dev
从 vms.csv 读取目标 data_disk_gb。playbook 会:
检查目标大小是否大于当前大小(不支持缩小)
若虚拟机正在运行 → 优雅关机并等待停止
使用 qemu-img resize 扩容 qcow2 文件
若虚拟机之前在运行 → 自动重新启动
扩容完成后,在虚拟机内扩展文件系统:
# Linux VMresize2fs /dev/vdb
# Windows VM (PowerShell)$maxSize=(Get-PartitionSupportedSize -DriveLetter E).SizeMax
Resize-Partition -DriveLetter E -Size $maxSize
注意:如果虚拟机已处于关机状态,playbook 直接扩容磁盘,不会自动开机。
挂载磁盘
# Format and mount data disk inside VM (requires VM in hosts.ini)uv run ansible-playbook playbooks/mount-disk.yaml -e "HOSTS=debian13-01" -e "mount_point=/data"
在 Linux 虚拟机内部格式化并挂载数据盘。要求虚拟机已在 hosts.ini 中定义。
参数
disk_device:磁盘设备路径(默认:/dev/vdb)
mount_point:挂载点(必填,如 /data)
disk_format:文件系统类型(默认:ext4)
need_partition:创建 GPT 分区(默认:false,裸盘挂载)
format_force:强制重新格式化(默认:false)
auto_mount:写入 fstab(默认:true)
示例
# With GPT partition (default)uv run ansible-playbook playbooks/mount-disk.yaml -e "HOSTS=debian13-01" -e "mount_point=/data"# Raw disk without partitionuv run ansible-playbook playbooks/mount-disk.yaml -e "HOSTS=debian13-01" -e "mount_point=/data" -e "need_partition=false"# Force reformat (WARNING: destroys data)uv run ansible-playbook playbooks/mount-disk.yaml -e "HOSTS=debian13-01" -e "mount_point=/data" -e "format_force=true"
仅限 Linux 客户机:virtio-blk 热插拔对运行中的虚拟机有效
(--config --live,立即生效,无需重启);已关机的虚拟机只会通过
--config 添加磁盘,下次启动时可见。
添加
# one 10G disk (index/letter picked automatically)uv run ansible-playbook playbooks/add-extra-disk-linux.yaml -e vm_name=debian12-01 -e extra_size=10G
# four 2G disks in one runuv run ansible-playbook playbooks/add-extra-disk-linux.yaml -e vm_name=debian12-01 -e count=4 -e extra_size=2G
# override the target directory (default: VM's storage dir from vms.csv)uv run ansible-playbook playbooks/add-extra-disk-linux.yaml -e vm_name=debian12-01 -e extra_dir=/data/disks
列出
uv run ansible-playbook playbooks/list-extra-disks.yaml -e vm_name=debian12-01