Tutorial do Debian 13 / Expandir LVM e ext4 e comparar a capacidade do LV e do sistema de arquivos

Para aumentar o espaço ext4 em LVM no Debian 13, você precisa verificar o espaço livre no VG, expandir o LV e depois também expandir o sistema de arquivos. Apenas aumentar o tamanho do LV não aumenta imediatamente o espaço disponível mostrado pelo df, então verifique a capacidade e os arquivos existentes em cada etapa separadamente.

Distinga PV, VG, LV e a capacidade do sistema de arquivos

O LVM (Logical Volume Manager, gerenciador de volumes lógicos) agrupa armazenamento e aloca volumes lógicos a partir desse espaço. O teste original no Debian 13 usou lvm2 2.03.31 e um disco de 4 GiB criado separadamente . Preserve tanto o disco do sistema quanto o disco de dados ext4 de 8 GiB criado anteriormente; nenhum dos dois é o alvo.

Hierarquia Significado Esta prática
PV (Physical Volume, volume físico) O dispositivo inicializado para o LVM gerenciar o espaço Todo o novo disco de 4 GiB
VG (Volume Group, grupo de volumes) Um pool que reúne o espaço PV e o aloca para LVs lf_vg23
LV (Logical Volume, volume lógico) Dispositivo de bloco lógico alocado pelo VG /dev/lf_vg23/data, inicialmente 1 GiB
ext4 Sistema de arquivos que armazena arquivos dentro do LV Criado no LV inicial de 1 GiB, depois expandido

Um PV pode ser criado em um disco inteiro ou em uma partição. Aqui, como todo o novo disco é usado como PV, uma partição GPT não é criada primeiro. O manual pvcreate documenta PVs de dispositivo inteiro e de partição. Não use isso como um exemplo de conversão de uma partição ext4 existente em um PV.

Esta configuração é um LV linear simples em um único PV. A própria configuração, que gerencia o espaço de armazenamento, não fornece réplicas ou backups de arquivos em caso de falha no disco. Expandir dados operacionais requer backups pré-verificados e um plano para cada destino.

Instale o LVM e identifique um disco novo separado

sudo apt update
sudo apt install --no-install-recommends lvm2
sudo lvm version
sudo pvs
sudo vgs
sudo lvs
lsblk -b -o NAME,SIZE,TYPE,FSTYPE,MOUNTPOINTS,SERIAL

Verifique e aprove os pacotes e dependências para instalar. No ambiente do teste original, o lvm2 e quatro dependências foram recém-instalados, e não havia PVs, VGs ou LVs existentes. Em um ambiente com outros VGs, registre seus nomes e dispositivos associados, e não os confunda com os nomes dedicados usados aqui.

Desligue a VM normalmente e confirme que está desligada. Anexe um VDI recém-criado de 4 GiB a uma porta SATA vazia e, em seguida, inicialize a VM. O processo de criação e identificação é o mesmo que o procedimento de adição de disco virtual novo. Não reutilize ou formate o disco anterior de 8 GiB. No teste original, o novo disco foi identificado como /dev/sdc com o número de série VBd922d313-5552a22f.

sudo udevadm settle
ls -l /dev/disk/by-id/ata-VBOX_HARDDISK*
pv_disk=/dev/disk/by-id/ata-VBOX_HARDDISK_VBd922d313-5552a22f
expected_serial=VBd922d313-5552a22f
lsblk -b -o NAME,SIZE,TYPE,FSTYPE,MOUNTPOINTS,SERIAL "$pv_disk"
sudo wipefs --no-act "$pv_disk"
sudo vgs lf_vg23
ls -ld /mnt/lf-lvm23 /var/backups/lf-debian13-23

Ajuste o caminho e o número de série para corresponder aos valores do seu próprio novo disco. As condições iniciais são 4.294.967.296 bytes, sem partição, sem sistema de arquivos e montagem, sem assinaturas, sem VG existente chamado lf_vg23 e sem diretórios de laboratório existentes. Nesta etapa, vgs deve indicar que lf_vg23 não existe, e ls deve indicar a ausência dos caminhos do laboratório. Preserve quaisquer outros grupos existentes. Não julgue um disco como vazio apenas porque a informação diz que não há assinatura; compare-o com o registro de criação do novo VDI.

Reexamine o destino na mesma sessão Bash usando a seguinte função.

check_new_lvm_disk() {
    test -b "$pv_disk" || return 1
    test "$(lsblk -dnro TYPE "$pv_disk")" = disk || return 1
    test "$(lsblk -dnro SERIAL "$pv_disk")" = "$expected_serial" || return 1
    test "$(sudo blockdev --getsize64 "$pv_disk")" = 4294967296 || return 1
    test "$(lsblk -nr -o NAME "$pv_disk" | wc -l)" = 1 || return 1
    test -z "$(lsblk -nro FSTYPE,MOUNTPOINTS "$pv_disk" | tr -d '[:space:]')" || return 1
    lvm_signature_types=$(sudo wipefs --no-act --noheadings --output TYPE "$pv_disk") || return 1
    test -z "$lvm_signature_types" || return 1
}
check_new_lvm_disk && printf 'New LVM disk checks passed\n'

Não prossiga se a inspeção falhar ou ocorrer um erro de consulta. Esta função é uma verificação suplementar para o tamanho atual e as condições do novo disco. Ela não autoriza a inicialização de armazenamento existente ou de origem desconhecida; a identificação manual do disco recém-criado continua indispensável.

Crie o PV, VG e LV de 1 GiB dedicados

pvcreate grava um rótulo LVM e metadados no dispositivo selecionado. Execute-o apenas uma vez no disco novo confirmado. Não utilize a opção de inicialização forçada e, se ocorrer um erro em qualquer etapa, não o ignore executando os comandos subsequentes separadamente.

check_new_lvm_disk &&
sudo pvcreate "$pv_disk" &&
sudo vgcreate lf_vg23 "$pv_disk" &&
sudo lvcreate -L 1G -n data lf_vg23
sudo pvs -o pv_name,vg_name,pv_size,pv_free
sudo vgs -o vg_name,vg_size,vg_free
sudo lvs -o lv_name,vg_name,lv_size,devices

Verifique se o PV pertence ao lf_vg23 e se o LV de dados aparece com 1 GiB (1.00g na saída em inglês). vgcreate cria o grupo, e lvcreate aloca esse espaço. O VG pode não mostrar os 4 GiB completos como espaço disponível devido aos metadados e ao alinhamento da unidade de alocação.

lv_path=/dev/lf_vg23/data
sudo blockdev --getsize64 "$lv_path"
test "$(sudo blockdev --getsize64 "$lv_path")" = 1073741824 &&
sudo mkfs.ext4 -L lf-lvm23 "$lv_path"
sudo blkid "$lv_path"
sudo test ! -e /mnt/lf-lvm23 &&
sudo install -d -m 755 /mnt/lf-lvm23
sudo mount "$lv_path" /mnt/lf-lvm23
findmnt --mountpoint /mnt/lf-lvm23
sudo install -d -m 750 -o lfstudent -g lfstudent /mnt/lf-lvm23/work

O tamanho do blockdev é esperado ser 1.073.741.824 bytes. Execute mkfs.ext4 apenas no LV recém-criado. Se ele relatar um sistema de arquivos existente inesperado, pare em vez de forçar. Primeiro confirme em findmnt a montagem ext4 no local correto; só depois crie a pasta de trabalho do usuário. Se mount ou a consulta findmnt falhar, pare antes de criar pastas ou escrever dados nesse caminho. /dev/mapper/lf_vg23-data e /dev/lf_vg23/data podem aparecer como caminhos apontando para o mesmo dispositivo lógico.

Registre o arquivo e a capacidade antes do crescimento

Crie o arquivo como o usuário comum lfstudent. Se outro usuário foi selecionado, também defina o proprietário da pasta de trabalho para esse usuário.

printf 'lvm-ext4-grow-lab\n' > /mnt/lf-lvm23/work/probe.txt
cat /mnt/lf-lvm23/work/probe.txt
sha256sum /mnt/lf-lvm23/work/probe.txt
df -B1 --output=source,size,used,avail,target /mnt/lf-lvm23
sudo vgs -o vg_name,vg_size,vg_free
sudo lvs -o lv_name,vg_name,lv_size,devices

df mostra a capacidade dos sistemas de arquivos montados, lvs mostra o tamanho dos volumes lógicos, e VFree de vgs mostra o espaço disponível para alocação no VG. Ter espaço livre no sistema de arquivos root não significa que você pode expandir o LV deste VG. Desta vez, verifique se há VFree suficiente para alocar 1 GiB adicional.

Armazene cópias de arquivos de comparação e metadados LVM fora do LV. Não sobrescreva se o caminho do novo backup já existir.

sudo test ! -e /var/backups/lf-debian13-23 &&
sudo install -d -m 700 /var/backups/lf-debian13-23 &&
sudo cp -a /mnt/lf-lvm23/work/probe.txt /var/backups/lf-debian13-23/probe-before.txt &&
sha256sum /mnt/lf-lvm23/work/probe.txt | sudo tee /var/backups/lf-debian13-23/probe.sha256 > /dev/null &&
sudo vgcfgbackup -f /var/backups/lf-debian13-23/vg-before-grow.vg lf_vg23

vgcfgbackup armazena os metadados de configuração do VG e não faz backup do conteúdo dos arquivos dentro do LV. Aqui, arquivos de prática pequenos foram copiados separadamente, mas para serviços reais, é necessário verificar o backup e a recuperação considerando todos os dados e a consistência.

Aumente apenas o LV para 2 GiB e compare o df

Primeiro, verifique o plano no modo de teste para garantir que o tamanho real não mudou.

sudo lvextend --test -L 2G "$lv_path"
sudo blockdev --getsize64 "$lv_path"
sudo lvs -o lv_name,vg_name,lv_size

No modo de teste, a saída esperada pode parecer que a expansão foi bem-sucedida, mas não registra metadados. Nesta etapa, o LV ainda deve ser 1 GiB. Não julgue a conclusão da expansão apenas com base na saída do modo de teste.

sudo lvextend -L 2G "$lv_path"
sudo blockdev --getsize64 "$lv_path"
sudo lvs -o lv_name,vg_name,lv_size,devices
df -B1 --output=source,size,used,avail,target /mnt/lf-lvm23
sudo sha256sum -c /var/backups/lf-debian13-23/probe.sha256

O LV se torna 2.147.483.648 bytes, ou 2 GiB (2.00g na saída em inglês), mas o tamanho no df ainda é o mesmo que antes da expansão. Verifique também se o hash dos arquivos existentes está correto. Para este exercício, a opção de redimensionar o sistema de arquivos junto com o LV foi deliberadamente omitida para observar a diferença entre as duas camadas. Segundo a documentação do lvextend, -L 2G define o novo tamanho total, e difere de especificar a adição ao tamanho atual como em -L +1G. A execução repetida do comando incremental pode aumentá-lo mais do que o pretendido.

Se o VG não tiver espaço livre, o espaço adicional solicitado não poderá ser alocado. Não reduza ou inicialize outros LVs às cegas; verifique a configuração real e o espaço disponível em pvs, vgs e lvs. Você precisa distinguir entre situações que exigem procedimentos separados para aumentar a capacidade de PV ou VG e situações em que apenas o sistema de arquivos ainda é pequeno em um LV já grande.

Expanda ext4 e verifique o espaço utilizável

sudo resize2fs "$lv_path"
df -B1 --output=source,size,used,avail,target /mnt/lf-lvm23
sudo blockdev --getsize64 "$lv_path"
sudo blkid "$lv_path"
sudo sha256sum -c /var/backups/lf-debian13-23/probe.sha256
sudo cmp /mnt/lf-lvm23/work/probe.txt /var/backups/lf-debian13-23/probe-before.txt

No ambiente do teste original, o ext4 suportava crescimento online enquanto montado, e o resize2fs expandia o sistema de arquivos para o LV maior. O manual do resize2fs descreve o tamanho padrão e as condições de suporte. Não aplique esta ferramenta a outros sistemas de arquivos como XFS ou Btrfs.

Etapas observadas no teste original LV bytes df -B1 Tamanho em bytes
Configuração inicial 1.073.741.824 1.020.702.720
após lvextend 2.147.483.648 1.020.702.720
Após resize2fs 2.147.483.648 2.077.073.408

Ao verificar com df, os valores podem não coincidir com o tamanho bruto do LV devido a metadados do sistema de arquivos e outros fatores. Não use os números exatos na tabela como valores fixos para todos os ambientes ext4; compare quais valores da camada mudaram sob as mesmas condições. No exercício prático, o UUID do sistema de arquivos foi preservado, e os conteúdos e hashes dos arquivos existentes eram os mesmos.

Para verificar se espaço adicional pode ser usado, você pode executar a pré-alocação a seguir como um usuário normal neste sistema de arquivos de teste dedicado. Não crie arquivos grandes nos caminhos de serviços reais.

fallocate -l 1100M /mnt/lf-lvm23/work/after-grow.bin
stat -c '%s bytes' /mnt/lf-lvm23/work/after-grow.bin
du -B1 /mnt/lf-lvm23/work/after-grow.bin
rm -- /mnt/lf-lvm23/work/after-grow.bin

Confirme que a alocação de espaço do arquivo de 1.100 MiB, ou seja, 1.153.433.600 bytes, foi bem-sucedida e exclua imediatamente apenas este arquivo de teste. fallocate é uma pré-alocação de espaço em arquivo e não é um teste de desempenho para a gravação de todos os dados do usuário deste tamanho. O tamanho lógico e a alocação calculada pelo du podem diferir ligeiramente dependendo dos metadados e das características do sistema de arquivos.

Monte novamente, verifique e deixe o sistema de arquivos desmontado

cd /
sudo umount /mnt/lf-lvm23
sudo mount /dev/lf_vg23/data /mnt/lf-lvm23
sudo sha256sum -c /var/backups/lf-debian13-23/probe.sha256
df -hT /mnt/lf-lvm23
sudo umount /mnt/lf-lvm23
sudo rmdir -- /mnt/lf-lvm23
sudo lvs -o lv_name,vg_name,lv_size,devices
lsblk -o NAME,SIZE,FSTYPE,LABEL,MOUNTPOINTS

Após remontar, verifique se os arquivos são os mesmos e se o tamanho expandido foi mantido. O estado final deixa o PV, VG, um LV de 2GiB, o sistema de arquivos e os arquivos intactos, com o sistema de arquivos desmontado. Esta prática não alterou o fstab. Se a montagem automática for necessária, siga as verificações e a reinicialização descritas na configuração de montagem por UUID no fstab.

Se você tentar reduzir o LV para 1GiB para cancelar a expansão, o espaço usado pelo sistema de arquivos na parte posterior pode ser cortado, o que pode corromper os dados. Reduzir é uma operação que requer um plano separado, incluindo suporte ao sistema de arquivos, desmontagem, verificação e redução, e não é fornecida como um comando de reversão neste curso. Se você precisar inicializar a prática, compare e decida com o método de preparar um novo armazenamento dedicado novamente após verificar o backup dos arquivos necessários. Simplesmente restaurar o backup dos metadados do LVM não retornará com segurança o sistema de arquivos ampliado e o conteúdo dos arquivos ao tamanho anterior.