Menggunakan link simbolis untuk mengakses disk yang terpasang ke instance komputasi Linux

Saat Anda melampirkan disk ke instance Compute Engine yang menggunakan OS Linux, Google Cloud secara otomatis membuat link simbolis (symlink) untuk disk tersebut. Untuk mengakses volume Persistent Disk atau disk SSD Lokal di instance komputasi, gunakan symlink. Symlink ini dapat diprediksi dan tetap konsisten di seluruh proses reboot. Google Cloud membuat symlink untuk semua disk yang terlampir ke instance komputasi di /dev/disk/by-id.

Dokumen ini menjelaskan cara mengidentifikasi symlink yang benar untuk disk yang terlampir ke instance komputasi Linux.

Symlink dibuat di /dev/disk/by-id saat disk dilampirkan ke instance komputasi, baik selama maupun setelah pembuatan instance. Nama symlink dibuat sebagai berikut:

Persistent Disk dan Google Cloud Hyperdisk

Symlink dibuat menggunakan aturan berikut:

  • Jika Anda menentukan nama perangkat kustom saat membuat disk: google-DEVICE_NAME
  • Jika Anda tidak menentukan nama perangkat kustom saat membuat disk:
    • Boot disk: google-INSTANCE_NAME
    • Non-boot disk: google-DISK_NAME

Setelah Anda memformat disk, symlink akan ditambahkan dengan -partN, dengan N adalah nomor partisi, misalnya google-data-disk-part1.

Disk SSD lokal

Symlink SSD lokal memiliki format yang berbeda, bergantung pada antarmuka disk.

  • SCSI:
    • Jika Anda menentukan nama perangkat kustom saat membuat disk: google-DEVICE_NAME
    • Jika Anda tidak menentukan nama perangkat kustom saat membuat disk: google-local-ssd-N, dengan N adalah nomor disk SSD Lokal, mulai dari 0.
  • NVMe: Symlink diberi nama google-local-nvme-ssd-N, dengan N adalah nomor SSD, mulai dari 0.

Setelah Anda memformat disk SSD Lokal, symlink akan ditambahkan dengan -partN, dengan N adalah nomor partisi, misalnya, google-local-nvme-ssd-0-part1.

Symlink perangkat

Compute Engine membuat symlink tambahan di direktori berdasarkan jenis dan antarmuka disk, misalnya scsi-0Google_PersistentDisk_DEVICE_NAME. Link ini menjalankan fungsi yang sama dengan symlink yang disebutkan sebelumnya.

Contoh 1: Instance C3 dengan SSD Lokal terlampir

Misalnya, Anda membuat instance komputasi dengan properti berikut:

  • Nama instance: instance-1
  • Seri mesin: C3
  • Jenis antarmuka disk: NVMe untuk Persistent Disk dan SSD Lokal
  • Disk tambahan: tidak ada
  • Disk SSD Lokal terlampir: 2
  • Nama perangkat kustom yang digunakan: tidak ada

Compute Engine membuat symlink berikut untuk instance komputasi tersebut:

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

Dalam contoh ini, symlink boot disk Persistent Disk adalah google-instance-1, yang didasarkan pada nama instance. Boot disk diformat dan memiliki sistem operasi yang diinstal di dalamnya. Boot disk memiliki 3 partisi: part1, part14, dan part 15. Disk SSD Lokal yang terlampir tidak diformat, sehingga hanya satu symlink yang dibuat untuk setiap disk SSD Lokal.

Contoh 2: Instance N2 dengan SSD Lokal NVMe terlampir dan Persistent Disk tambahan

Misalnya, Anda membuat instance komputasi dengan properti berikut:

  • Nama instance: instance-2
  • Seri mesin: N2
  • Jenis antarmuka disk: SCSI untuk Persistent Disk dan NVMe untuk SSD Lokal
  • Disk tambahan: 1 Persistent Disk bernama extra-scsi-disk
  • Disk SSD Lokal terlampir: 2
  • Nama perangkat kustom yang digunakan: tidak ada

Symlink berikut dibuat untuk instance komputasi tersebut:

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

Dalam contoh ini, symlink boot disk Persistent Disk adalah google-instance-2, yang didasarkan pada nama instance. Boot disk diformat dan memiliki image OS yang diinstal di dalamnya. Boot disk memiliki 3 partisi: part1, part14, dan part 15. Disk SSD Lokal pertama juga dipartisi, dengan satu partisi, sehingga ada symlink tambahan yang dibuat untuk partisi disk tersebut. Persistent Disk tambahan yang ditambahkan ke instance komputasi memiliki symlink google-extra-scsi-disk, yang didasarkan pada nama disk. Persistent Disk tambahan dan disk SSD Lokal kedua tidak diformat, sehingga hanya satu symlink yang tercantum untuk disk tersebut.

Langkah berikutnya