Menggunakan link simbolis untuk mengakses disk yang terpasang ke VM Linux

Saat Anda memasang disk ke mesin virtual (VM) yang menggunakan OS Linux,Google Cloud akan otomatis membuat link simbolis (symlink) untuk disk tersebut. Untuk mengakses volume Persistent Disk atau disk SSD Lokal di VM Linux, gunakan symlink. Symlink ini dapat diprediksi dan tetap konsisten di seluruh proses reboot. Google Cloud membuat symlink untuk semua disk yang terpasang ke VM di /dev/disk/by-id.

Dokumen ini menjelaskan cara mengidentifikasi link simbolik yang benar untuk disk yang terpasang ke VM.

Batasan

Jika Anda memasang disk SSD Lokal ke VM C3 atau C3D, Anda mungkin perlu melakukan langkah-langkah tambahan untuk membuat symlink bagi disk SSD Lokal. Langkah-langkah ini hanya diperlukan jika Anda menggunakan salah satu gambar publik berikut yang ditawarkan oleh Google Cloud:

  • SLES 15 SP4 dan SP5
  • SLES 12 SP4

Langkah tambahan ini hanya berlaku untuk disk SSD Lokal; Anda tidak perlu melakukan apa pun untuk volume Persistent Disk.

Image publik dalam daftar sebelumnya tidak memiliki symlink SSD Lokal dalam bentuk /dev/disk/by-id/google-local-nvme-ssd-N. Hanya symlink yang menggunakan informasi perangkat, misalnya nvme-nvme.1ae0-6e766d655f636172642d7064-6e766d655f636172642d7064-00000001, yang ada di gambar ini.

Untuk mendapatkan link simbolis yang mudah digunakan untuk image Linux ini, Anda harus memperbarui aturan udev dan menambahkan skrip ke instance.

Untuk mengetahui petunjuk tentang cara memperbarui aturan udev guna mendukung symlink untuk disk SSD Lokal di C3 dan C3D, lihat Memecahkan masalah disk NVMe.

Sebagai alternatif untuk menggunakan symlink, Anda dapat mengakses disk SSD Lokal di VM menggunakan nama perangkat, misalnya, /dev/nvme0n1.

Link simbolis dibuat di /dev/disk/by-id saat disk dilampirkan ke VM, baik selama atau setelah pembuatan VM. Nama symlink dibuat sebagai berikut:

Persistent Disk dan Google Cloud Hyperdisk

Link simbolis 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-VM_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

Link simbolis 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, dimulai dari 0.
  • NVMe: Link simbolis diberi nama google-local-nvme-ssd-N, dengan N adalah nomor SSD, dimulai 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.

Link simbolis perangkat

Compute Engine membuat link simbolik 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: VM C3 dengan SSD Lokal yang terpasang

Asumsikan Anda membuat VM dengan properti berikut:

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

Compute Engine membuat symlink berikut untuk VM 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 VM. Boot disk diformat dan sistem operasi diinstal di dalamnya. Boot disk memiliki 3 partisi: part1, part14, dan part 15. Disk SSD Lokal yang terpasang tidak diformat, sehingga hanya satu symlink yang dibuat untuk setiap disk SSD Lokal.

Contoh 2: VM N2 dengan SSD Lokal NVMe terpasang dan Persistent Disk tambahan

Asumsikan Anda membuat VM dengan properti berikut:

  • Nama VM: 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 terpasang: 2
  • Nama perangkat kustom yang digunakan: tidak ada

Symlink berikut dibuat untuk VM 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 VM. 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 VM memiliki link simbolis 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