Utiliser des liens symboliques pour accéder aux disques associés à une instance de calcul Linux

Lorsque vous associez un disque à une instance Compute Engine qui utilise un système d'exploitation Linux, Google Cloud crée automatiquement un lien symbolique (symlink) pour le disque. Pour accéder aux volumes Persistent Disk ou aux disques SSD locaux dans votre instance de calcul, utilisez les liens symboliques. Ces liens symboliques sont prévisibles et restent cohérents lors des redémarrages. Google Cloud crée des liens symboliques pour tous les disques associés à une instance de calcul dans /dev/disk/by-id.

Ce document explique comment identifier les liens symboliques appropriés pour les disques associés à une instance de calcul Linux.

Les liens symboliques sont créés dans /dev/disk/by-id lorsqu'un disque est associé à l'instance de calcul, pendant ou après la création de l'instance. Les noms des liens symboliques sont créés comme suit :

Persistent Disk et Google Cloud Hyperdisk

Les liens symboliques sont créés à l'aide des règles suivantes :

  • Si vous avez spécifié un nom d'appareil personnalisé lors de la création du disque : google-DEVICE_NAME
  • Si vous n'avez pas spécifié de nom d'appareil personnalisé lors de la création du disque :
    • Disque de démarrage : google-INSTANCE_NAME
    • Disque non amorçable : google-DISK_NAME

Une fois le disque formaté, le lien symbolique est ajouté avec -partN, où N est le numéro de partition, par exemple google-data-disk-part1.

Disques SSD locaux

Les liens symboliques des disques SSD locaux ont des formats différents selon l'interface du disque.

  • SCSI:
    • Si vous avez spécifié un nom d'appareil personnalisé lors de la création du disque: google-DEVICE_NAME
    • Si vous n'avez pas spécifié de nom d'appareil personnalisé lors de la création du disque: google-local-ssd-N, où N est le numéro de disque SSD local, en partant de 0.
  • NVMe : les liens symboliques sont nommés google-local-nvme-ssd-N, où N correspond au numéro SSD à partir de 0.

Une fois le disque SSD local formaté, le lien symbolique est ajouté avec -partN, où N est le numéro de partition, par exemple google-local-nvme-ssd-0-part1.

Liens symboliques de l'appareil

Compute Engine crée des liens symboliques supplémentaires dans le répertoire en fonction de le type et l'interface du disque, par exemple scsi-0Google_PersistentDisk_DEVICE_NAME. Ces liens remplissent la même fonction que les liens symboliques mentionnés précédemment.

Exemple 1 : Instance C3 avec disque SSD local associé

Supposons que vous ayez créé une instance de calcul avec les propriétés suivantes :

  • Nom de l'instance : instance-1
  • Série de machines : C3
  • Type d'interface du disque : disque persistant local et disque SSD local
  • Disques supplémentaires : aucun
  • Disques SSD locaux associés : 2
  • Noms d'appareils personnalisés utilisés : aucun

Compute Engine crée les liens symboliques suivants pour cette instance de calcul :

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

Dans cet exemple, le lien symbolique du disque de démarrage Persistent Disk est google-instance-1, qui est basé sur le nom de l'instance. Le disque de démarrage est formaté et le système d'exploitation y est installé. Le disque de démarrage comporte trois partitions : partie 1, partie 14 et partie 15. Les disques SSD locaux associés ne sont pas formatés. Par conséquent, un seul lien symbolique a été créé pour chaque disque SSD local.

Exemple 2 : Instance N2 avec disque SSD local NVMe associé et disque persistant supplémentaire

Supposons que vous ayez créé une instance de calcul avec les propriétés suivantes :

  • Nom de l'instance : instance-2
  • Série de machines : N2
  • Type d'interface du disque : SCSI pour disque persistant et NVMe pour SSD local
  • Disques supplémentaires : un disque persistant nommé extra-scsi-disk
  • Disques SSD locaux associés : 2
  • Noms d'appareils personnalisés utilisés : aucun

Les liens symboliques suivants sont créés pour cette instance de calcul :

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

Dans cet exemple, le lien symbolique du disque de démarrage Persistent Disk est google-instance-2, qui est basé sur le nom de l'instance. Le disque de démarrage est formaté et l'image du système d'exploitation y est installée. Le disque de démarrage comporte trois partitions : partie 1, partie 14 et partie 15. Le premier disque SSD local est également partitionné, avec une seule partition. Par conséquent, un lien symbolique supplémentaire est créé pour cette partition de disque. Le disque persistant supplémentaire ajouté à l'instance de calcul possède le lien symbolique google-extra-scsi-disk, qui est basé sur le nom du disque. Le disque persistant supplémentaire et le deuxième disque SSD local ne sont pas formatés. Par conséquent, un seul lien symbolique est répertorié pour ces disques.

Étapes suivantes