Todos os produtos
Search
Central de documentação

:Identify disk partitions by UUID in GRUB

Última atualização: Jul 03, 2026

Substitua os identificadores de partição baseados em nome de dispositivo por UUID s no arquivo de configuração do GRUB para evitar falhas de inicialização após operações de disco, como importações de imagem.

Contexto

Nomes de dispositivo como /dev/vda1 podem mudar após operações como importação de imagens. Se o nome do dispositivo na configuração do GRUB não apontar mais para a partição correta, o kernel não carregará o sistema de arquivos e a instância não iniciará.

Procedimento

Configure o GRUB para identificar a partição raiz por UUID e garantir uma inicialização confiável.

Aviso

A modificação da configuração do GRUB é uma operação de alto risco. Alterações incorretas podem impedir a inicialização da instância. Antes de prosseguir, crie um snapshot da instância para garantir a segurança dos dados.

Verifique a versão do GRUB

O GRUB possui duas versões principais: GRUB2 e GRUB Legacy. O GRUB Legacy recebe apenas correções de bugs. Verifique a versão do GRUB conforme descrito abaixo.

  1. Faça logon em uma instância Linux usando o Workbench.

  2. Identifique a versão do GRUB:

    GRUB2

    Verifique a estrutura do diretório de configuração do GRUB:

    sudo ls /etc/grub.d/

    Se a saída incluir arquivos como 00_header e 40_custom, você está usando o GRUB2. Exemplo de saída:

    00_header  05_debian_theme  10_linux  20_linux_xen  30_os-prober  30_uefi-firmware  40_custom  41_custom

    GRUB Legacy

    Verifique o conteúdo do diretório /boot/grub/:

    sudo ls /boot/grub/

    Se o diretório /boot/grub contiver um arquivo menu.lst, você está usando o GRUB Legacy.

Localize o arquivo de configuração

O GRUB2 e o GRUB Legacy usam caminhos diferentes para o arquivo de configuração.

  • GRUB2: /boot/grub/grub.cfg ou /boot/grub2/grub.cfg.

  • GRUB Legacy: /boot/grub/menu.lst ou /boot/grub/grub.conf.

Acesse o diretório /boot para localizar o arquivo de configuração do GRUB.

Obtenha os UUIDs das partições de disco

Obtenha o UUID de cada partição de disco para uso no arquivo de configuração do GRUB.

  1. Visualize os UUIDs das partições de disco:

    sudo blkid

    Exemplo de saída:

    /dev/vda1: LABEL="/" UUID="e7e8xxxx-xxxx-xxxx-xxxx-xxxxb9263645" TYPE="ext4" PARTUUID="0efbxxxx-01"

    Neste exemplo, o UUID de /dev/vda1 é e7e8xxxx-xxxx-xxxx-xxxx-xxxxb9263645.

Modifique o arquivo de configuração

Importante

O exemplo a seguir usa o arquivo de configuração do GRUB2 em /boot/grub2/grub.cfg. Caso utilize o GRUB Legacy ou uma configuração personalizada do GRUB, ajuste os comandos na Etapa 1 e na Etapa 2 adequadamente.

  1. Faça backup do arquivo de configuração atual do GRUB:

    sudo cp /boot/grub2/grub.cfg /boot/grub2/grub.cfg.bak
    Importante

    Para restaurar o arquivo de configuração do GRUB, execute:

    sudo cp -f /boot/grub2/grub.cfg.bak /boot/grub2/grub.cfg

  2. Abra o arquivo de configuração do GRUB:

    sudo vim /boot/grub2/grub.cfg
  3. Pressione i para insira no modo de inserção. Substitua todas as ocorrências de root=/dev/vda1 por root=UUID=e7e8xxxx-xxxx-xxxx-xxxx-xxxxb9263645.

    linux   /boot/vmlinuz-3.16.0-4-amd64 root=/dev/vda1 ro single debian-installer=en_US net.ifnames=0 vga=792 console=tty0 console=ttyS0,115200n8

    Linha modificada:

    linux   /boot/vmlinuz-3.16.0-4-amd64 root=UUID=e7e8xxxx-xxxx-xxxx-xxxx-xxxxb9263645 ro single debian-installer=en_US net.ifnames=0 vga=792 console=tty0 console=ttyS0,115200n8
  4. Pressione Esc para sair do modo de inserção e digite :wq para salve e sair.

  5. (Opcional) Verifique se todos os identificadores de partição de disco no GRUB agora usam UUID:

    sudo cat /boot/grub2/grub.cfg

Referências

Para configurar o arquivo fstab e montar automaticamente um disco de dados, consulte Montagem automática de disco de dados usando UUID.