Memperbarui properti VM

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:

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

  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 sub-properti 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 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:

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 dan 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 \
       -n PROJECT \
       edit virtualmachines.virtualmachine.gdc.goog VM_NAME
    

    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.