Resgate uma VM inacessível

Se a VM Linux estiver inacessível por algum motivo, tente resgatá-la seguindo as etapas a seguir.

Para identificar por que uma instância de computação não é inicializada antes de ser resgatada, consulte Resolver problemas de inicialização de instâncias do Linux Compute Engine.

Funções exigidas

Para receber as permissões necessárias para resgatar uma VM, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esses papéis predefinidos contêm as permissões necessárias para resgatar uma VM. Para conferir as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As permissões a seguir são necessárias para resgatar uma VM:

  • compute.instances.create no projeto
  • compute.disks.create no projeto
  • compute.instances.get no projeto
  • compute.disks.createSnapshot nos discos
  • compute.instances.attachDisk em uma nova VM
  • compute.disks.use no disco
  • compute.instances.start em uma VM nova e inacessível
  • compute.instances.stop em uma VM nova e inacessível

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Resgatar uma VM

Se não for possível se conectar à VM ou se o disco de inicialização estiver cheio, crie uma VM temporária para localizar a VM inacessível.

  1. (Opcional) Interrompa a VM inacessível.
  2. Crie um snapshot no disco de inicialização da VM de origem. Se o sistema de arquivos raiz estiver dividido em vários discos, será necessário criar um snapshot de cada disco.
  3. Crie uma VM de resgate usando qualquer imagem pública do Linux compatível. Para evitar conflitos de UUID de disco que podem fazer com que a VM de resgate seja inicializada pelo disco da VM inacessível, o Google recomenda usar uma imagem do SO diferente da VM inacessível. Se você planeja executar ferramentas de reparo do sistema de arquivos específicas do SO ou chroot, selecione uma imagem diferente da mesma família de SO.

    Em alguns casos, uma política de imagem confiável pode impedir que você crie discos de inicialização com base em imagens públicas. Nesses casos, peça a um administrador para suspender temporariamente essa restrição antes de criar uma VM de resgate. Consulte Definir restrições de acesso a imagens para mais informações.

  4. Verifique se a VM de resgate está em execução e se é possível se conectar a ela usando SSH.

  5. Enquanto a VM de resgate estiver em execução, para cada um dos snapshots dos discos de inicialização da VM inacessível que você criou anteriormente, crie um novo disco com base no snapshot e anexe-o à VM de resgate sem interrompê-la:

    1. No console do Google Cloud , acesse a página Instâncias de VM.

      Acessar instâncias de VM

    2. Clique no nome da VM de resgate que você criou.

    3. Clique em Editar.

    4. Em Discos adicionais, clique em Adicionar novo disco e faça o seguinte:

      1. Adicione o nome do disco, como my-recovery-disk
      2. Em Tipo de origem, selecione a guia Snapshot.
      3. No menu suspenso Snapshot de origem, selecione o snapshot da VM de origem criada anteriormente nestas etapas.
      4. Clique em Concluído.
    5. Clique em Salvar.

  6. Identifique o nome de cada um dos discos que você anexou anteriormente à VM executando o seguinte comando:

    lsblk -d -o NAME,SERIAL

    O resultado será o seguinte:

     NAME SERIAL
     sda  rescue-vm
     sdb  my-recovery-disk
     

    Neste exemplo, rescue-vm é o disco de inicialização da VM de resgate e my-recovery-disk é o disco de inicialização do snapshot da VM inacessível. Anote o NAME da VM inacessível para usar na próxima etapa.

  7. Para cada um dos discos que você anexou anteriormente à VM, faça o seguinte:

    1. Identifique o sistema de arquivos de cada partição executando o seguinte comando:

      fdisk -l /dev/NAME -o Device,Size,Type
      

      Substitua NAME pelo nome do disco de inicialização da VM inacessível da etapa anterior. Neste exemplo, o nome seria sdb.

      O resultado será o seguinte:

      Disk /dev/sdb: 10 GiB, 10737418240 bytes, 20971520 sectors
      Disk model: PersistentDisk
      Units: sectors of 1 * 512 = 512 bytes
      Sector size (logical/physical): 512 bytes / 4096 bytes
      I/O size (minimum/optimal): 4096 bytes / 4096 bytes
      Disklabel type: gpt
      Disk identifier: B31430F1-F041-4555-96B9-B2F43DC057AD
      
      Device     Size Type
      /dev/sdb1    2M BIOS boot
      /dev/sdb2   20M EFI System
      /dev/sdb3   10G Linux filesystem
      

      A coluna Type lista o sistema de arquivos de cada partição. Se o tipo de sistema de arquivos estiver ausente em alguma partição, execute o seguinte comando:

      file -sL /dev/PARTITION_NAME
      

      Substitua NAME pelo nome da partição.

      A saída varia de acordo com o tipo de sistema de arquivos:

      • Nenhum sistema de arquivos: se a saída exibir apenas data, a partição não contém um sistema de arquivos. Exemplo de saída:

        /dev/sdb1: data
        
      • Sistema de arquivos EFI: se a saída descrever um setor de inicialização DOS/MBR, a partição terá um sistema de arquivos EFI. Exemplo de saída:

        dev/sdb2: DOS/MBR boot sector, code offset 0x3c+2, OEM-ID "mkfs.fat", sectors/cluster 4, reserved sectors
        4, root entries 512, sectors 40960 (volumes <=32 MB), Media descriptor 0xf8, sectors/FAT 40, sectors/
        track 32, heads 64, serial number 0xf2af2664, label: "EFI        ", FAT (16 bit)
        
      • Sistema de arquivos do Linux: se a saída descrever dados do sistema de arquivos, a partição será um sistema de arquivos do Linux. Exemplo de saída:

        /dev/sdb3: SGI XFS filesystem data (blksz 4096, inosz 512, v2 dirs)
        

      Anote o nome da partição do sistema de arquivos do Linux.

    2. Crie um ponto de montagem em /rescue:

      sudo mkdir /rescue
    3. Monte a partição do sistema de arquivos do Linux em /rescue:

      sudo mount PARTITION_NAME /rescue
      

      Substitua PARTITION_NAME pelo nome do sistema de arquivos do Linux que você anotou anteriormente.

      Se o disco tiver uma partição /boot separada ou uma partição do sistema EFI (como /dev/sdb2 na saída anterior), monte-as antes de entrar no ambiente chroot. Isso torna os arquivos do carregador de inicialização e do kernel acessíveis:

      # Run only if your disk has a separate /boot partition:
      sudo mount /dev/BOOT_PARTITION_NAME /rescue/boot
      
      # Run only if your disk has an EFI System Partition (UEFI VMs):
      sudo mount /dev/EFI_PARTITION_NAME /rescue/boot/efi
      

      Substitua:

      • BOOT_PARTITION_NAME: o nome da partição /boot separada, se houver (por exemplo, sdb1).
      • EFI_PARTITION_NAME: o nome da partição do sistema EFI em VMs UEFI (por exemplo, sdb2).
    4. Monte os sistemas de arquivos e dispositivos virtuais para modificar o diretório raiz do sistema de arquivos usando o comando chroot:

      sudo mount -t proc /proc /rescue/proc
      sudo mount -t sysfs /sys /rescue/sys
      sudo mount -o bind /dev /rescue/dev
      sudo mount -o bind /dev/pts /rescue/dev/pts
      sudo mount -o bind /run /rescue/run
      
    5. Altere o diretório raiz para o sistema de arquivos montado:

      sudo chroot /rescue
      

    O sistema de arquivos do disco de inicialização inacessível agora está montado em /rescue, e o shell é executado em um ambiente chroot nesse sistema de arquivos. É possível navegar pelo sistema de arquivos, alterar arquivos de configuração, corrigir problemas ou recuperar dados.

    Se a VM não inicializar com um erro do GRUB module not found, repare o carregador de inicialização do GRUB no ambiente chroot. As etapas dependem do tipo de firmware da VM:

    • VMs de BIOS legadas (i386-pc) (por exemplo, quando o console serial mostra file '/grub2/i386-pc/increment.mod' not found):

      • RHEL, CentOS, Rocky Linux e SUSE:
      grub2-install --target=i386-pc /dev/NAME
      grub2-mkconfig -o /boot/grub2/grub.cfg
      
      • Debian e Ubuntu:
      grub-install --target=i386-pc /dev/NAME
      update-grub
      

      Substitua NAME pelo nome do dispositivo de disco inteiro do disco de recuperação anexado anteriormente (por exemplo, sdb, não um número de partição, como sdb1).

    • VMs UEFI e VMs protegidas (verifique se /rescue/boot/efi está montado primeiro; não execute grub2-install em VMs UEFI RHEL, CentOS ou Rocky Linux porque ele substitui o shim de inicialização segura assinado):

      • RHEL, CentOS e Rocky Linux (use yum em vez de dnf no CentOS 7 e no RHEL 7):
      dnf reinstall -y shim-* grub2-efi-* grub2-common
      grub2-mkconfig -o /boot/grub2/grub.cfg
      
      • SUSE:
      shim-install --config-file=/boot/grub2/grub.cfg
      grub2-mkconfig -o /boot/grub2/grub.cfg
      
      • Debian e Ubuntu:
      grub-install --efi-directory=/boot/efi --no-nvram
      update-grub
      

Reverter as alterações e reiniciar a VM inacessível

Depois de corrigir o problema ou recuperar os dados, siga as etapas abaixo para restaurar a VM original:

  1. Depois de concluir a solução de problemas, saia do ambiente chroot:

     exit
     

  2. Desative os sistemas de arquivos virtuais, os dispositivos e o sistema de arquivos da VM inacessível da VM de resgate:

    Se você montou uma EFI ou uma partição /boot separada, desmonte /rescue/boot/efi seguido por /rescue/boot antes de desmontar o sistema de arquivos raiz (sudo umount /rescue).

     cd /
     sudo umount /rescue/run
     sudo umount /rescue/dev/pts
     sudo umount /rescue/dev
     sudo umount /rescue/sys
     sudo umount /rescue/proc
     sudo umount /rescue
     

  3. No console do Google Cloud , acesse a página Instâncias de VM.

    Acessar instâncias de VM

    1. Selecione a VM de resgate que você criou.

    2. Clique em Editar.

    3. Em Discos adicionais, clique em do disco criado nas etapas anteriores para removê-lo da VM de resgate.

    4. Clique em Salvar.

  4. Acesse a página Instâncias de VM no console do Google Cloud .

    Acessar instâncias de VM

    1. Se a VM inacessível ainda estiver em execução, interrompa a VM.

    2. Clique no nome da VM que você acabou de interromper e clique em Editar.

    3. Em Disco de inicialização, clique em Remover disco de inicialização para remover o disco de inicialização da VM inacessível.

    4. Em seguida, clique em CONFIGURAR DISCO DE INICIALIZAÇÃO para anexar o disco que você criou e corrigiu anteriormente em Resgatar uma VM nesta página.

      1. Na seção Disco de inicialização, clique na guia Discos existentes.
      2. Na lista suspensa, selecione o disco que você criou na seção anterior, por exemplo, my-recovery-disk.
      3. Clique em Selecionar e em Salvar.
    5. Iniciar a VM.

  5. Agora você poderá conectar-se à VM usando SSH.