Skip to content
Search AlmaLinux

This page uses Chinese content. Search opens the Chinese documentation.

    Browse this documentation

    AlmaLinux 10 磁盘扩容实战:growpart、pvresize、lvextend 与 xfs_growfs(容器取证 + 实机佐证)

    This content is not available in your language yet.

    本页的取证分两层:容器补充取证(工具包归属 + 命令面采样)与实机 VM 佐证(真实 EL10 磁盘环境)。在 almalinux:10 容器(aarch64;10.2「Lavender Lion」,镜像 almalinux:10@sha256:5a4b41a4…cfe8,2026-11-01)中实际执行的是:dnf provides 三连(growpart / xfs_growfs / resize2fs 的包归属)、安装三个工具包、growpart --help / xfs_growfs --help / resize2fs --help 命令面采样、xfs_growfs -V 版本核对、无块设备边界记录。原始日志:plans/content-expansion/evidence/logs/alma-disk-expand.log(sha256 88fdc9c3…,脚本 alma-disk-expand-run.sh 可复现)。

    实机侧佐证来自既有 x86_64 VM 301 日志 alma-p4-vm-storage.log(sha256 f3c029d3…,2026-11-01):真实 AlmaLinux 10.2 系统上 growpart、resize2fs、xfs_growfs、parted 四件工具全部在 PATH(/usr/bin/growpart、/usr/sbin/resize2fs、/usr/sbin/xfs_growfs、/usr/sbin/parted),根分区 /dev/sda4 为 xfs 8.8G(df -Th 实测),分区结构 sda1(1M BIOS boot) / sda2(200M EFI) / sda3(1G /boot) / sda4(8.8G /)(lsblk 实测),lvm2-2.03.36-2.el10 已装。

    一个必须先讲清的边界:容器里没有可扩容的磁盘(lsblk 只能看到 OrbStack 挂载面的 loop/nbd/zram/vd* 设备,/dev/sd* 不存在),VM 301 的日志也没有执行过任何扩容变更。所以「云盘扩容后的完整五步流程」本页没有实测——扩容顺序与命令行为按两份手册(xfs_growfs(8)、resize2fs(8))的口径转述,文末「未验证事项」逐条登记。

    分层扩容概念:块设备 → 分区 → PV/VG/LV → 文件系统

    Section titled “分层扩容概念:块设备 → 分区 → PV/VG/LV → 文件系统”

    「磁盘满了」在 Linux 上很少是单层问题。从底向上,一次扩容要穿过四层,每层有各自的工具,顺序不能颠倒:

    层扩容对象命令说明
    ① 块设备层整块磁盘/云盘云平台控制台/API(或物理换盘)OS 之外的操作,OS 里只能等它变大
    ② 分区层分区(sda4 等)growpart(或 parted resizepart)重写分区表,让分区吃满新增空间
    ③ PV/VG/LV 层LVM 逻辑卷pvresize + lvextend仅 LVM 布局需要;分区直挂布局跳过
    ④ 文件系统层文件系统xfs_growfs(XFS)/ resize2fs(ext2/3/4)让文件系统占用新空间,XFS 挂载态在线

    两层之间的衔接是手册明文(不是经验):resize2fs 不操作分区大小——手册原文明确「If you wish to enlarge a file system, you must make sure you can expand the size of the underlying partition first」,扩分区可以用 fdisk 以同起始扇区重建更大分区,或用 lvextend(LVM);xfs_growfs 的前提是设备上已经有新增空间(手册 PRACTICAL USE 节:grow 需要先给文件系统提供可占的新空间,通常经逻辑卷管理器),且文件系统必须挂载中——它也可以直接用于已扩大且起始块不变的普通分区。

    EL10 的工具链包归属(容器 dnf provides 实测,2026-11-01):

    命令提供包仓库路径
    growpartcloud-utils-growpart-0.33-11.el10.noarchAppStream/usr/bin/growpart
    xfs_growfsxfsprogs-6.16.0-1.el10.aarch64BaseOS/usr/sbin/xfs_growfs
    resize2fse2fsprogs-1.47.1-5.el10.aarch64BaseOS/usr/sbin/resize2fs
    Terminal window
    dnf install cloud-utils-growpart xfsprogs e2fsprogs

    基础容器镜像三件都不预装(command -v 全 absent 实测);最小安装的服务器如果缺件,按上表补包即可。

    你属于哪种布局,决定跳过哪几层。 VM 301 的实测布局是分区直挂形态:sda4 这个分区直接格式化成 xfs 挂在 /(EL 云镜像的常见形态),没有 LVM——它的扩容路径只有两步:growpart /dev/sda 4 → xfs_growfs /。传统安装器(含部分 VM 模板)默认 LVM 布局:分区做 PV、PV 上建 VG、VG 上切 LV 再格式化——这类要用完整的五步(下一节)。判断方法很简单:lsblk 里看根分区下面有没有 almalinux-root 这类 LV 节点,或直接 vgs 看输出是否为空。

    扩容前必须知道你要操作的文件系统能进不能退还是可进可退——这决定了流程设计和回滚预案。

    XFS:只能 grow,不能 shrink。 xfs_growfs 在挂载态在线扩容,手册明文「The existing contents of the filesystem are undisturbed, and the added space becomes available for additional file storage」——现有内容不受干扰,新空间即刻可用。收缩方向上,手册 -D size 节只实现「收缩最后一个 AG 且不删除它」这一种受限形态,-l(log 收缩/移动)、-i/-x(内外部 log 转换)直接标注 not implemented——所以实操口径是:XFS 要缩小只能备份、重建、还原,不要指望在线收缩。

    Terminal window
    # xfs_growfs 用法面(--help/-h 不是合法选项,但会打印完整 Usage;-V 报版本)
    # Usage: xfs_growfs [options] mountpoint
    # -d grow data/metadata section
    # -l grow log section
    # -r grow realtime section
    # -n don't change anything, just show geometry
    # -D size grow data/metadata section to size blks
    # -m imaxpct set inode max percent to imaxpct
    # -V print version information
    # xfs_growfs version 6.16.0

    -n 是安全的好习惯:先 xfs_growfs -n / 只读显示几何、不改动,确认无误再去掉 -n 真扩。

    ext4(含 ext2/ext3):可扩可缩,但有挂载态限制。 resize2fs 对未挂载的文件系统支持放大与缩小;文件系统挂载中时只能在线扩大(需内核与文件系统支持在线扩容——手册称现代内核对 ext3/ext4 都支持,ext3 需要 resize_inode 特性)。缩小必须先卸载:-M 收缩到最小尺寸、-P 先估算最小尺寸、-p 打进度条。缩小的操作顺序也有讲究:先 resize2fs 缩文件系统,再用 fdisk 缩分区,且新分区不得小于新文件系统大小——顺序反了数据就没了。

    Terminal window
    # resize2fs 用法面(--help 报 invalid option 但打印 banner 与 Usage,rc=1)
    # resize2fs 1.47.1 (20-May-2024)
    # Usage: resize2fs [-d debug_flags] [-f] [-F] [-M] [-P] [-p] device [-b|-s|new_size] [-S RAID-stride] [-z undo_file]
    XFS(xfs_growfs)ext4(resize2fs)
    在线扩容✓ 挂载态直接扩✓ 挂载态在线扩大
    在线缩容✗ 无全功能实现✗ 需先卸载
    缩容路径备份 → 重建 → 还原卸载 → resize2fs 缩 fs → fdisk 缩分区
    提供包xfsprogs(BaseOS)e2fsprogs(BaseOS)

    AlmaLinux 10 默认根分区是 XFS(VM 301 实测 /dev/sda4 xfs),所以本页主线讲 XFS 的扩容;ext4 的差异按手册口径列出备查。

    五步扩容实操:growpart → pvresize → lvextend → xfs_growfs → df -h

    Section titled “五步扩容实操:growpart → pvresize → lvextend → xfs_growfs → df -h”

    以下流程面向 LVM 布局(根 LV 在 VG 里,安装器默认形态)。命令面为容器实测采样,真实执行未做——需要一块真正扩过容的块设备。

    Terminal window
    # ① 扩分区:让 sda4 吃满块设备的新增空间
    growpart /dev/sda 4
    # -N 先 dry-run 预演(打印新的 sfdisk -d,不落盘)
    # -u auto 是默认:扩后尝试刷新内核分区表(需内核支持与 partx --update)
    # ② 扩 PV:让物理卷认知分区的新大小
    pvresize /dev/sda4
    # ③ 扩 LV:把 VG 里的全部空闲空间分给根 LV
    lvextend -l +100%FREE /dev/almalinux/root
    # ④ 扩文件系统:XFS 用挂载点参数(挂载态在线)
    xfs_growfs /
    # ⑤ 验证:容量已更新
    df -h /

    三个容易踩的点:

    1. growpart 的参数是「磁盘 + 分区号」,不是设备路径——growpart /dev/sda 4,不是 growpart /dev/sda4(用法面实测:growpart disk partition,自带示例 growpart /dev/sda 1)。它还带 --free-percent F(给磁盘留 F% 不分配,适合消费级 SSD/SD 卡延长寿命)与 --fudge(变动小于 F 字节就不动,默认 1 MiB)这类实用选项;--version 不是它的选项(实测 rc=2,FAILED: unknown option)。
    2. xfs_growfs 的参数是挂载点,不是设备——xfs_growfs /;不确定几何时先 xfs_growfs -n / 只读查看。resize2fs 的参数才是设备(resize2fs /dev/almalinux/root),且 size 不指定时默认扩满分区、上限永远是分区大小(手册明文)。
    3. 分区直挂布局(VM 301 的形态)跳过 ②③:growpart /dev/sda 4 之后直接 xfs_growfs /,手册明文支持「分区已扩大且起始块不变」的直接扩容——这也是云镜像最常见的路径。

    df -h 前后对比是最后一步也是唯一能证明「扩容生效」的观测点;配合 lsblk 确认每一层尺寸都对得上(块设备 → 分区 → LV → 文件系统逐层看)。

    云盘和本地盘的差异集中在第①层,第②层往上的操作完全相同:

    • 块设备层的入口不同。 云盘在云厂商控制台/API 上扩容云盘容量——这一步发生在 OS 之外,OS 里能做的只是等块设备变大;本地盘/物理机没有「在线变大」的入口,只能换更大的盘或利用已有空余分区。块设备变大之后,从 growpart 开始的五步两种形态一模一样。
    • 快照与生效时机。 云盘扩容前先打快照是云上习惯;部分云盘需要重启实例或卸载/重新挂载后 guest 才能识别新容量——这属云厂商行为差异,本页不作断言,以你所用云平台的文档为准。识别到新容量后,从分区层开始即可。
    • 缩容几乎不可行。 云盘普遍只提供扩容不提供缩容(文献口径);叠加文件系统层的不对称(XFS 不可缩、ext4 缩需卸载),云上「缩容」实际是「新盘迁移」——新建更大或更小的盘、拷数据、换挂载。

    云盘 resize 本身本页未实测(容器与 VM 取证止于工具链、命令面与磁盘结构),以上为手册与通行实践口径;证据清单 notRunnable 第二条登记。

    • 真实在线扩容全流程:云盘扩容后的 growpart → pvresize → lvextend → xfs_growfs → df -h 五步端到端未执行(VM 301 仅实测工具链在位与分区/文件系统结构,无任何扩容变更;需要真实可扩容块设备与可回滚实机环境)。
    • 云盘 resize 操作本身:云厂商控制台/API 扩容、扩容前快照、生效时机(是否需重启/重新挂载)未实测——属云平台操作,本页为文献口径。
    • growpart 对真实分区的改写:分区表重写与内核分区表刷新(-u auto / partx --update)行为未实测,容器无 /dev/sd* 分区设备;实测止于 --help 采样与 -N dry-run 语义(用法面)。
    • LVM 扩容链在真实磁盘上:pvresize/lvextend 对真实磁盘未执行(VM 301 为分区直挂布局;既有 loop 设备 LVM 实测仅覆盖 thin pool 创建,不含扩容路径)。
    • ext4 在线扩大与离线收缩:resize2fs 挂载态在线扩大(ext3 resize_inode 前提)与 -M/-P 收缩流程均未实测——本环境无真实 ext4 文件系统可操作,页内为手册口径;--help 采样显示用法面(rc=1 如实记录)。
    • XFS 收缩受限形态:-D size「收缩最后一个 AG」的手册描述未验证(EL10 xfsprogs 6.16.0 上无合适文件系统可试);-n 只读几何显示在容器无挂载点场景未跑通。