Dokumen ini memberikan petunjuk untuk memasang persistent disk virtual machine (VM) ke instance di Google Distributed Cloud (GDC) dengan air gap.
Pasang disk non-boot ke VM Anda untuk memenuhi persyaratan workload spesifik Anda. Memisahkan penyimpanan dari instance VM memastikan data penting Anda tetap dipertahankan secara independen dari siklus proses VM, sekaligus menskalakan performa dan kapasitas secara otomatis untuk memenuhi permintaan workload Anda.
Dokumen ini ditujukan untuk developer dalam grup administrator platform atau operator aplikasi yang menambahkan dan mengonfigurasi disk VM di lingkungan Distributed Cloud. Untuk mengetahui informasi selengkapnya, lihat Audiens untuk dokumentasi GDC dengan air gap.
Sebelum memulai
Untuk menggunakan perintah antarmuka command line (CLI) gdcloud, pastikan Anda telah mendownload, menginstal,
dan mengonfigurasi gdcloud CLI.
Semua perintah untuk Distributed Cloud menggunakan CLI gdcloud atau
kubectl, dan memerlukan lingkungan sistem operasi (OS).
Mendapatkan jalur file kubeconfig
Untuk menjalankan perintah terhadap server Management API, pastikan Anda memiliki resource berikut:
Login dan buat file kubeconfig untuk server Management API jika Anda belum memilikinya.
Gunakan jalur ke file kubeconfig server Management API untuk mengganti
MANAGEMENT_API_SERVERdalam petunjuk ini.
Meminta peran IAM
Hubungi IAM Project Admin Anda untuk meminta peran berikut di project Anda:
Virtual Machine Project Admin (
project-vm-admin): membuat, mengubah, mencantumkan, dan menghapus VM di namespace project.Project Viewer(
project-viewer): melihat semua resource dalam namespace project.
Semua peran VM harus terikat ke namespace project tempat VM berada. Ikuti langkah-langkah untuk memverifikasi akses Anda.
Memasang disk ke VM
Membuat dan memasang non-boot disk ke VM Anda. Setiap disk tambahan dapat menentukan image kustom atau disk kosong. Anda dapat menambahkan beberapa disk sekaligus ke VM.
Konsol
Di menu navigasi, klik Virtual Machines > Instances.
Dalam daftar VM, klik nama VM untuk melihat detailnya.
Klik Add new disk.
Pada dialog konfirmasi, klik Stop untuk menghentikan VM.
Tunggu beberapa menit hingga VM berhenti.
Klik Muat ulang.
Saat VM dalam status dihentikan, klik Add new disk lagi.
Di dialog Add disk, pilih disk baru atau disk yang ada.
Untuk menyediakan disk baru, klik tab New disk.
- Di kolom Disk name, masukkan nama disk baru yang unik untuk project.
- Di kolom Size, masukkan ukuran disk antara 10 dan 65536 GiB. Misalnya, 10 GiB.
- Di bagian Deletion rule, klik Keep disk atau Delete disk.
Untuk memilih disk yang ada, klik tab Existing disk.
- Dalam daftar Disk, pilih disk.
- Di bagian Deletion rule, klik Keep disk atau Delete disk.
Klik Simpan. Disk akan muncul dalam daftar disk untuk VM.
API
Buat
VirtualMachineDisk:kubectl --kubeconfig MANAGEMENT_API_SERVER \ -n PROJECT \ apply -f - <<EOF apiVersion: virtualmachine.gdc.goog/v1 kind: VirtualMachineDisk metadata: name: NON_BOOT_BLANK_DISK spec: size: NON_BOOT_BLANK_DISK_SIZE EOFTambahkan
VirtualMachineDiskkeVirtualMachinespec.disksyang ada:kubectl --kubeconfig MANAGEMENT_API_SERVER \ -n PROJECT \ edit virtualmachines.virtualmachine.gdc.goog VM_NAMEEdit hal berikut di editor teks Anda:
# … disks: - virtualMachineDiskRef: name: VM_BOOT_DISK_NAME boot: true - virtualMachineDiskRef: name: NON_BOOT_BLANK_DISK autoDelete: false # …Ganti variabel, menggunakan definisi berikut.
Variabel Definisi MANAGEMENT_API_SERVERFile kubeconfig server Management API. PROJECTProject Google Distributed Cloud dengan air gap (GDC) tempat VM akan dibuat. VM_NAMENama VM baru. VM_BOOT_DISK_NAMENama boot disk VM baru. NON_BOOT_BLANK_DISKNama disk tambahan Anda. NON_BOOT_BLANK_DISK_SIZEUkuran disk tambahan Anda, seperti 20G.
Memformat dan memasang non-boot disk
Setelah memasang disk ke VM, lakukan langkah-langkah yang diperlukan berikut untuk membuatnya dapat diakses dalam VM.
Terhubung ke VM
Gunakan SSH untuk mengakses VM.
Memformat disk
Cantumkan disk yang terpasang ke instance Anda berdasarkan nomor seri dan temukan disk yang ingin Anda format dan pasang.
ls -l /dev/disk/by-id/Contoh output ini menampilkan nama disk sebagai nomor seri:
total 0 lrwxrwxrwx 1 root root 9 Sep 13 23:51 ata-QEMU_HARDDISK_agentSADisk -> ../../sdc lrwxrwxrwx 1 root root 9 Sep 13 23:51 scsi-0ATA_QEMU_HARDDISK_agentSADisk -> ../../sdc lrwxrwxrwx 1 root root 9 Sep 13 23:51 scsi-0QEMU_QEMU_HARDDISK_vm-disk-boot -> ../../sda lrwxrwxrwx 1 root root 10 Sep 13 23:51 scsi-0QEMU_QEMU_HARDDISK_vm-disk-boot-part1 -> ../../sda1 lrwxrwxrwx 1 root root 11 Sep 13 23:51 scsi-0QEMU_QEMU_HARDDISK_vm-disk-boot-part14 -> ../../sda14 lrwxrwxrwx 1 root root 11 Sep 13 23:51 scsi-0QEMU_QEMU_HARDDISK_vm-disk-boot-part15 -> ../../sda15 lrwxrwxrwx 1 root root 9 Sep 13 23:51 scsi-0QEMU_QEMU_HARDDISK_vm-disk-data -> ../../sdb lrwxrwxrwx 1 root root 9 Sep 13 23:51 scsi-1ATA_QEMU_HARDDISK_agentSADisk -> ../../sdc lrwxrwxrwx 1 root root 9 Sep 13 23:51 scsi-SATA_QEMU_HARDDISK_agentSADisk -> ../../sdc lrwxrwxrwx 1 root root 9 Sep 13 23:51 scsi-SQEMU_QEMU_HARDDISK_vm-disk-boot -> ../../sda lrwxrwxrwx 1 root root 10 Sep 13 23:51 scsi-SQEMU_QEMU_HARDDISK_vm-disk-boot-part1 -> ../../sda1 lrwxrwxrwx 1 root root 11 Sep 13 23:51 scsi-SQEMU_QEMU_HARDDISK_vm-disk-boot-part14 -> ../../sda14 lrwxrwxrwx 1 root root 11 Sep 13 23:51 scsi-SQEMU_QEMU_HARDDISK_vm-disk-boot-part15 -> ../../sda15 lrwxrwxrwx 1 root root 9 Sep 13 23:51 scsi-SQEMU_QEMU_HARDDISK_vm-disk-data -> ../../sdbInformasi yang mengikuti panah,
->, di setiap baris menunjukkan nama perangkat disk. Misalnya, discsi-SQEMU_QEMU_HARDDISK_vm-disk-data -> ../../sdb, nomor serinya adalahscsi-SQEMU_QEMU_HARDDISK_vm-disk-datadan nama perangkatnya adalahsdb.Identifikasi nomor seri disk Anda dari daftar ini.
Perilaku fitur situasional penting yang dapat memengaruhi daftar nomor seri:
- Jika nilai
virtualMachineDiskRef.namelebih dari 20 karakter, hanya 20 karakter pertama yang digunakan sebagai nomor seri. - Jika ada dua disk dengan 20 karakter pertama yang sama, hanya disk pertama yang memiliki nomor seri.
- Jika nilai
Format disk:
sudo mkfs.ext4 -m 0 -E lazy_itable_init=0,lazy_journal_init=0,discard /dev/disk/by-id/DISK_ID
- Ganti
DISK_IDdengan nomor seri disk yang sedang Anda format. - Untuk contoh ini, tetapkan
scsi-SQEMU_QEMU_HARDDISK_vm-disk-datauntuk memformat seluruh disk tanpa tabel partisi.
Untuk memaksimalkan performa disk, gunakan opsi pemformatan yang direkomendasikan di
flag -E. Karena Anda tidak perlu mencadangkan ruang untuk volume root pada disk sekunder, tentukan -m 0 untuk menggunakan semua kapasitas disk yang tersedia.
Memasang disk
Buat direktori yang berfungsi sebagai direktori pemasangan disk baru. Anda dapat menggunakan direktori apa pun. Contoh berikut membuat direktori di
/mnt/disks/:sudo mkdir -p /mnt/disks/MOUNT_DIRGanti
MOUNT_DIRdengan direktori tempat Anda ingin memasang disk.Pasang disk ke instance, dan aktifkan opsi discard:
sudo mount -o discard,defaults /dev/disk/by-id/DISK_ID /mnt/disks/MOUNT_DIRGanti kode berikut:
DISK_IDdengan nomor seri disk yang akan dipasang.MOUNT_DIRdengan direktori tempat Anda ingin memasang disk.
Opsional: Konfigurasikan izin baca dan tulis pada disk. Perintah berikut memberikan akses tulis,
a+w, ke disk untuk semua pengguna.sudo chmod a+w /mnt/disks/MOUNT_DIROpsional: Konfigurasikan pemasangan otomatis saat VM dimulai ulang - Menggunakan ID unik universal (UUID) atau skrip startup.
Mengonfigurasi pemasangan otomatis saat VM dimulai ulang - UUID disk
Tambahkan disk ke file /etc/fstab Anda agar disk secara otomatis dipasang lagi saat VM dimulai ulang. Di sistem operasi (OS), nama perangkat berubah setiap kali perangkat dimulai ulang, tetapi UUID perangkat selalu mengarah ke volume yang sama, bahkan saat Anda memindahkan disk antar sistem. Oleh karena itu, selalu gunakan UUID perangkat untuk mengonfigurasi pemasangan otomatis saat VM dimulai ulang.
Buat cadangan file
/etc/fstabsaat ini:sudo cp /etc/fstab /etc/fstab.backupCantumkan UUID untuk disk:
sudo blkid /dev/DEVICE_NAMEContoh output menunjukkan UUID
accc19c5-d0d6-4157-9672-37d4e1d48eb5untuk disk/dev/sdb: UUID="accc19c5-d0d6-4157-9672-37d4e1d48eb5" TYPE="ext4"DEVICE_NAMEadalah nama perangkat disk yang ingin dipasang secara otomatis. Jika Anda membuat tabel partisi di disk, tentukan partisi yang ingin dipasang sebagai akhiran pada nama perangkat. Misalnya, jikasdbadalah nama perangkat disk, dan Anda ingin memasang partisi 1,DEVICE_NAMEakan menjadisdb1.Buka file
/etc/fstabdi editor teks, lalu buat entri yang menyertakan UUID:UUID=UUID_VALUE /mnt/disks/MOUNT_DIR ext4 discard,defaults,MOUNT_OPTION 0 2Ganti kode berikut:
UUID_VALUEdengan diskUUID, yang tercantum sebagai output dari perintah Cantumkan UUID.MOUNT_DIRdengan direktori tempat Anda memasang disk.MOUNT_OPTIONdengan nilaiMOUNT_OPTIONuntuk OS Anda, yang menentukan tindakan OS jika tidak dapat memasang disk saat booting.
Pastikan entri
/etc/fstabAnda sudah benar:Perintah berikut memverifikasi entri
/etc/fstabterhadap disk dan partisi yang ada yang terpasang ke VM:findmnt --verifyContoh berikut menunjukkan verifikasi yang berhasil. Anda dapat mengabaikan peringatan yang diharapkan dengan aman:
[W] your fstab has been modified, but systemd still uses the old version; use 'systemctl daemon-reload' to reload 0 parse errors, 0 errors, 1 warningJika ada error, periksa apakah entri
fstabvalid. Masalah umum adalah saat karakter non-cetak yang tidak valid ditambahkan ke entri. Anda dapat menjalankan perintah berikut untuk menampilkan semua karakter khusus dalam file/etc/fstab:cat --show-nonprinting /etc/fstabBerikut adalah contoh output yang valid:
LABEL=cloudimg-rootfs / ext4 defaults 0 1 LABEL=UEFI /boot/efi vfat umask=0077 0 1 UUID=UUID_VALUE /mnt/disks/MOUNT_DIR ext4 discard,defaults,MOUNT_OPTION 0 2Pastikan tidak ada karakter yang tidak terduga, seperti karakter yang tidak dapat dicetak yang diawali dengan
M-atau^.
Jika Anda melepaskan disk ini atau membuat snapshot dari boot disk untuk VM ini,
edit file /etc/fstab dan hapus entri untuk disk ini. Meskipun Anda telah
menetapkan MOUNT_OPTION ke nofail atau nobootwait, pastikan file /etc/fstab
tetap sinkron dengan perangkat yang terpasang ke VM Anda. Hapus entri ini sebelum Anda membuat snapshot boot disk atau melepaskan disk.
Mengonfigurasi pemasangan otomatis saat VM dimulai ulang - skrip startup VM
Anda juga dapat menggunakan skrip startup untuk memasang disk pada setiap reboot dengan menambahkan perintah dari Memasang Disk ke skrip startup. Sebelum menambahkan skrip untuk memasang disk, format disk menggunakan perintah dari Memformat disk.
Buat secret skrip startup.
cat <<EOF >>mount-disk-script #!/bin/bash mkdir -p /mnt/disks/MOUNT_DIR mount -o discard,defaults /dev/disk/by-id/DISK_ID /mnt/disks/MOUNT_DIR EOFkubectl --kubeconfig MANAGEMENT_API_SERVER \ -n PROJECT \ create secret generic VM_NAME-mount-script \ --from-file=script=mount-disk-scriptrm mount-disk-scriptTambahkan skrip startup ke VM.
kubectl --kubeconfig MANAGEMENT_API_SERVER \ -n PROJECT \ edit virtualmachines.virtualmachine.gdc.goog VM_NAMEEdit
spec.startupScriptsuntuk menyertakan nama secret.apiVersion: virtualmachine.gdc.goog/v1 kind: VirtualMachine metadata: name: VM_NAME namespace: PROJECT spec: # … startupScripts: - name: mount-script scriptSecretRef: name: VM_NAME-mount-script
Untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi skrip startup, lihat.