Dokumen ini menjelaskan cara memperbarui properti instance virtual machine (VM) di Google Distributed Cloud (GDC) yang terisolasi.
Anda dapat memperbarui properti VM untuk menyelaraskan infrastruktur virtual dengan perubahan permintaan workload yang berjalan di instance. Anda dapat menambah vCPU atau memori fisik (RAM), atau menguranginya untuk mendistribusikan ulang resource di tempat lain dalam project.
Daripada menghancurkan VM, membangunnya kembali, dan memigrasikan data, Anda dapat memilih untuk memperbarui propertinya. Meskipun memperbarui properti biasanya memerlukan mulai ulang cepat, pendekatan ini dapat menghemat waktu konfigurasi Anda selama berjam-jam.
Dokumen ini ditujukan bagi developer dalam grup administrator platform atau operator aplikasi yang melihat dan memperbarui properti 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 CLI gdcloud.
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 menggantikan
MANAGEMENT_API_SERVERdalam petunjuk ini.
Meminta peran IAM
Hubungi Admin IAM Project Anda untuk meminta peran berikut di project Anda:
Admin Project Virtual Machine (
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.
Properti yang dapat diupdate
Anda hanya dapat mengubah properti yang ada di spec VM.
Melihat properti yang dapat diupdate
Temukan properti yang ingin Anda ubah menggunakan konsol GDC atau
kubectl.
Konsol
Di menu navigasi, klik Virtual Machines > Instances.
Dalam daftar VM, klik nama VM untuk melihat propertinya.
Properti yang dapat diedit memiliki ikon edit Edit.
kubectl
Lihat daftar properti untuk
specVM dan nilai valid yang sesuai dengan setiap properti:kubectl --kubeconfig MANAGEMENT_API_SERVER \ explain virtualmachines.virtualmachine.gdc.goog.specOutputnya mirip dengan hal berikut ini:
KIND: VirtualMachine VERSION: virtualmachine.gdc.goog/v1 RESOURCE: spec <Object> DESCRIPTION: Defines the specification of the Virtual Machine. FIELDS: compute <Object> Specifies the CPU and Memory of the VM. CPU and Memory can be defined directly or through the VirtualMachineType. Changes to Compute require a reboot to take effect. Compute is immutable when the VM is in `Unknown` state. disks <[]Object> -required- Specifies the list of disks attached to this vm. There must be exactly one boot disk. Changes to disk attachments require a reboot to take effect. ...Lihat sub-properti secara rekursif untuk setiap properti. Contoh ini menunjukkan hasil yang ditampilkan untuk sub-properti
computedanvcpus:Contoh perintah ini menampilkan kolom untuk sub-properti
compute:kubectl --kubeconfig MANAGEMENT_API_SERVER \ explain virtualmachines.virtualmachine.gdc.goog.spec.computeOutputnya mirip dengan hal berikut ini:
KIND: VirtualMachine VERSION: virtualmachine.gdc.goog/v1 RESOURCE: compute <Object> DESCRIPTION: Specifies the CPU and Memory of the VM. CPU and Memory can be defined directly or through the VirtualMachineType. Changes to Compute require a reboot to take effect. Compute is immutable when the VM is in `Unknown` state. FIELDS: memory <> Specifies the amount of physical memory available to the instance. memory must have a minimum value of `1G`, and can be up to (including) `400G`. vcpus <integer> Specifies the number of VCPUs that are available to the instance. Specify `vcpus` as an integer. This value must be a multiple of 2, with 2 as the minimum and 128 as the maximum allowed. ...Contoh perintah ini menampilkan kolom untuk sub-properti
vcpus:kubectl --kubeconfig MANAGEMENT_API_SERVER \ explain virtualmachines.virtualmachine.gdc.goog.spec.compute.vcpusOutputnya mirip dengan hal berikut ini:
KIND: VirtualMachine VERSION: virtualmachine.gdc.goog/v1 FIELD: vcpus <integer> DESCRIPTION: Specifies the number of VCPUs that are available to the instance. Specify `vcpus` as an integer. This value must be a multiple of 2, with 2 as the minimum and 128 as the maximum allowed.
Semua properti dapat diupdate pada VM yang sedang berjalan, tetapi sering kali mengharuskan VM dimulai ulang agar perubahan diterapkan.
Update properti ini mengharuskan VM dimulai ulang agar perubahan dapat diterapkan:
- compute
- tambahan
- firmware
- startupScripts
Perubahan properti ini akan langsung diterapkan:
- guestEnvironment
- runningState
Memperbarui properti VM
Perbarui properti VM menggunakan konsol GDC atau kubectl.
Konsol
Di menu navigasi, klik Virtual Machines > Instances.
Dalam daftar VM, klik nama VM untuk melihat propertinya.
Klik edit Edit di samping properti yang ingin Anda edit dan buat perubahan.
Jika Anda ingin mengganti boot disk atau menambahkan disk baru, lihat Mengganti boot disk atau Menambahkan disk ke VM.
Klik Simpan.
kubectl
Jalankan perintah berikut:
kubectl --kubeconfig MANAGEMENT_API_SERVER \ -n PROJECT \ edit virtualmachines.virtualmachine.gdc.goog VM_NAMEGanti variabel seperti yang ditentukan dalam tabel berikut.
Variabel Definisi MANAGEMENT_API_SERVERFile kubeconfig server Management API. VM_NAMENama VM. PROJECTNama project. Edit
specuntuk memperbarui kolom dan nilai yang diperlukan untuk properti yang dapat diperbarui.Simpan file.
Jika update properti mengharuskan VM dimulai ulang, gunakan petunjuk Memulai ulang VM untuk memulai ulang VM.