Use links simbólicos para acessar discos anexados a uma VM Linux

Ao anexar um disco a uma máquina virtual (VM) que usa um sistema operacional Linux,Google Cloud cria automaticamente um link simbólico (link simbólico) para o disco. Para acessar volumes de disco permanente ou discos SSD locais em sua VM Linux, use os links simbólicos. Esses links simbólicos são previsíveis e permanecem consistentes durante as reinicializações.Google Cloud cria links simbólicos para todos os discos anexados a uma VM em /dev/disk/by-id .

Este documento explica como identificar os links simbólicos corretos para os discos anexados a uma VM.

Limitações

Se você anexar discos SSD locais a uma VM C3 ou C3D , talvez seja necessário executar etapas adicionais para criar links simbólicos para os discos SSD locais. Essas etapas só serão necessárias se você usar qualquer uma das seguintes imagens públicas oferecidas por Google Cloud:

  • SLES 15 SP4 e SP5
  • SLES 12 SP4

Estas etapas adicionais se aplicam apenas a discos SSD locais; Você não precisa fazer nada para volumes de disco permanente.

As imagens públicas na lista anterior não possuem os links simbólicos do SSD local no formato /dev/disk/by-id/google-local-nvme-ssd- N . Somente links simbólicos que usam as informações do dispositivo, por exemplo nvme-nvme.1ae0-6e766d655f636172642d7064-6e766d655f636172642d7064-00000001 , existem nessas imagens.

Para obter links simbólicos fáceis de usar para essas imagens do Linux, você deve atualizar as regras udev e adicionar um script à instância.

Para obter instruções sobre como atualizar as regras udev para suportar links simbólicos para discos SSD locais em C3 e C3D, consulte Solução de problemas de discos NVMe .

Como alternativa ao uso de links simbólicos, você pode acessar os discos SSD locais nas VMs usando seus nomes de dispositivos , por exemplo, /dev/nvme0n1 .

Os links simbólicos são criados em /dev/disk/by-id quando um disco é anexado à VM, durante ou após a criação da VM. Os nomes dos links simbólicos são criados da seguinte forma:

Disco permanente e hiperdisco do Google Cloud

Os links simbólicos são criados usando as seguintes regras:

  • Se você especificou um nome de dispositivo personalizado ao criar o disco: google- DEVICE_NAME
  • Se você não especificou um nome de dispositivo personalizado ao criar o disco:
    • Disco de inicialização: google- VM_NAME
    • Disco que não é de inicialização: google- DISK_NAME

Depois de formatar o disco, o link simbólico é anexado com -part N , onde N é o número da partição, por exemplo google-data-disk-part1 .

Discos SSD locais

Os links simbólicos do SSD local têm formatos diferentes dependendo da interface do disco.

  • SCSI: os links simbólicos são denominados google-local-ssd- N , onde N é o número do disco SSD local, começando em 0.
  • NVMe: Os links simbólicos são denominados google-local-nvme-ssd- N , onde N é o número do SSD, começando em 0.

Depois de formatar um disco SSD local, o link simbólico é anexado com -part N , onde N é o número da partição, por exemplo, google-local-nvme-ssd-0-part1 .

Links simbólicos de dispositivos

O Compute Engine cria links simbólicos adicionais no diretório com base no tipo de disco e na interface, por exemplo, scsi-0Google_PersistentDisk_ DEVICE_NAME . Esses links desempenham a mesma função dos links simbólicos mencionados anteriormente.

Exemplo 1: VM C3 com SSD local anexado

Suponha que você criou uma VM com as seguintes propriedades:

  • Nome da VM: instance-1
  • Série de máquinas: C3
  • Tipo de interface de disco: NVMe para disco permanente e SSD local
  • Discos adicionais: nenhum
  • Discos SSD locais anexados: 2
  • Nomes de dispositivos personalizados usados: nenhum

O Compute Engine cria os seguintes links simbólicos para essa VM:

ls -l /dev/disk/by-id/google-*

google-instance-1 -> ../../nvme2n1
google-instance-1-part1 -> ../../nvme2n1p1
google-instance-1-part14 -> ../../nvme2n1p14
google-instance-1-part15 -> ../../nvme2n1p15
google-local-nvme-ssd-0 -> ../../nvme0n1
google-local-nvme-ssd-1 -> ../../nvme1n1

Neste exemplo, o link simbólico do disco de inicialização do disco permanente é google-instance-1 , que é baseado no nome da VM. O disco de inicialização está formatado e possui o sistema operacional instalado. O disco de inicialização possui 3 partições: parte1, parte14 e parte 15. Os discos SSD locais anexados não são formatados, portanto, apenas um único link simbólico foi criado para cada disco SSD local.

Exemplo 2: VM N2 com SSD local NVMe anexado e disco permanente extra

Suponha que você criou uma VM com as seguintes propriedades:

  • Nome da VM: instance-2
  • Série de máquinas: N2
  • Tipo de interface de disco: SCSI para disco permanente e NVMe para SSD local
  • Discos adicionais: 1 disco permanente denominado extra-scsi-disk
  • Discos SSD locais anexados: 2
  • Nomes de dispositivos personalizados usados: nenhum

Os seguintes links simbólicos são criados para essa VM:

ls -l /dev/disk/by-id/google-*

google-extra-scsi-disk -> ../../sdb
google-instance-2 -> ../../sda
google-instance-2-part1 -> ../../sda1
google-instance-2-part14 -> ../../sda14
google-instance-2-part15 -> ../../sda15
google-local-nvme-ssd-0 -> ../../nvme0n1
google-local-nvme-ssd-0-part1 -> ../../nvme0n1p1
google-local-nvme-ssd-1 -> ../../nvme0n2

Neste exemplo, o link simbólico do disco de inicialização do disco permanente é google-instance-2 , que é baseado no nome da VM. O disco de inicialização está formatado e contém a imagem do sistema operacional instalada. O disco de inicialização possui 3 partições: parte1, parte14 e parte 15. O primeiro disco SSD local também é particionado, com uma única partição, portanto, há um link simbólico adicional criado para essa partição de disco. O disco permanente adicional adicionado à VM possui o link simbólico google-extra-scsi-disk , que se baseia no nome do disco. O disco permanente extra e o segundo disco SSD local não são formatados, portanto, apenas um único link simbólico é listado para esses discos.

O que vem a seguir