Memperbarui properti VM

Halaman ini menjelaskan properti virtual machine (VM) yang dapat Anda update untuk VM yang ada dan cara melakukan update tersebut.

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:

  1. Login dan buat file kubeconfig untuk server Management API jika Anda belum memilikinya.

  2. Gunakan jalur ke file kubeconfig server Management API untuk menggantikan MANAGEMENT_API_SERVER dalam petunjuk ini.

Meminta izin dan akses

Untuk melakukan tugas yang tercantum di halaman ini, Anda harus memiliki peran Project VirtualMachine Admin. Ikuti langkah-langkah untuk memverifikasi bahwa Anda memiliki peran Project VirtualMachine Admin (project-vm-admin) di namespace project tempat VM berada.

Untuk operasi VM menggunakan konsol GDC atau gdcloud CLI, minta Admin IAM Project Anda untuk memberi Anda peran Project VirtualMachine Admin dan peran Project Viewer (project-viewer).

Properti yang dapat diperbarui

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

  1. Di menu navigasi, klik Virtual Machines > Instances.

  2. Dalam daftar VM, klik nama VM untuk melihat propertinya.

  3. Properti yang dapat diedit memiliki ikon Edit.

kubectl

  1. Lihat daftar properti untuk spec VM dan nilai valid yang sesuai dengan setiap properti:

    kubectl --kubeconfig MANAGEMENT_API_SERVER explain virtualmachines.virtualmachine.gdc.goog.spec

    Outputnya 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.

   ...

  2. Lihat subproperti secara rekursif untuk setiap properti. Contoh ini menunjukkan hasil yang ditampilkan untuk sub-properti compute dan vcpus:

    • Contoh perintah ini menampilkan kolom untuk sub-properti compute:

      kubectl --kubeconfig MANAGEMENT_API_SERVER explain virtualmachines.virtualmachine.gdc.goog.spec.compute

      Outputnya 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.vcpus

      Outputnya 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 di VM yang sedang berjalan, tetapi sering kali mengharuskan VM dimulai ulang agar diterapkan.

Update properti ini mengharuskan VM dimulai ulang agar perubahan dapat diterapkan:

Perubahan properti ini akan langsung diterapkan:

  • guestEnvironment
  • runningState

Memperbarui properti VM

Perbarui properti VM menggunakan konsol GDC atau kubectl.

Konsol

  1. Di menu navigasi, klik Virtual Machines > Instances.

  2. Dalam daftar VM, klik nama VM untuk melihat propertinya.

  3. Klik Edit di samping properti yang ingin Anda edit, lalu buat perubahan.

  4. Jika Anda ingin mengganti boot disk atau menambahkan disk baru, lihat Mengganti boot disk atau Menambahkan disk ke VM.

  5. Klik Simpan.

kubectl

  1. Jalankan perintah berikut:

    kubectl --kubeconfig MANAGEMENT_API_SERVER \
   edit virtualmachines.virtualmachine.gdc.goog VM_NAME \
   -n PROJECT

    Ganti variabel seperti yang ditentukan dalam tabel berikut.

    VariabelDefinisi
    MANAGEMENT_API_SERVERFile kubeconfig server Management API.
    VM_NAMENama VM.
    PROJECTNama project.

  2. Edit spec untuk memperbarui kolom dan nilai yang diperlukan untuk properti yang dapat diperbarui.

  3. Simpan file.

  4. Jika update properti mengharuskan VM dimulai ulang, gunakan petunjuk Memulai ulang VM untuk memulai ulang VM.