Panduan memulai: Membuat VM di cluster Google Distributed Cloud

Panduan memulai ini menunjukkan cara menggunakan Runtime VM di GDC untuk membuat VM (virtual machine) di Google Distributed Cloud. Runtime VM di GDC menggunakan KubeVirt untuk mengatur VM di cluster, dan memungkinkan Anda menggunakan aplikasi dan workload berbasis VM di lingkungan pengembangan yang seragam.

Sebelum memulai

Untuk menyelesaikan panduan memulai ini, Anda memerlukan akses ke cluster Google Distributed Cloud versi 1.12 (anthosBareMetalVersion: 1.12) atau yang lebih tinggi. Anda dapat menggunakan jenis cluster apa pun yang mampu menjalankan workload. Jika diperlukan, coba Google Distributed Cloud di Compute Engine atau lihat ringkasan pembuatan cluster.

Mengaktifkan Runtime VM di GDC

Runtime VM di GDC diinstal secara otomatis di Google Distributed Cloud versi 1.10 atau yang lebih tinggi, tetapi dinonaktifkan secara default. Sebelum dapat menjalankan resource VM di Google Distributed Cloud, Anda harus mengaktifkan Runtime VM di GDC.

bmctl

Google Distributed Cloud versi 1.11 atau yang lebih tinggi dapat menggunakan alat command line bmctl:

• Untuk mengaktifkan runtime, gunakan alat bmctl:

  bmctl enable vmruntime --kubeconfig KUBECONFIG_PATH
  

  Berikan jalur ke file kubeconfig untuk cluster Anda. Google Distributed Cloud membuat file kubeconfig di workstation admin saat Anda membuat cluster. Secara default, jalurnya adalah bmctl-workspace/CLUSTER_NAME/CLUSTER_NAME-kubeconfig.

  Jika Runtime VM di GDC sudah diaktifkan, perintah akan menampilkan error.

Resource kustom

Google Distributed Cloud versi 1.10 atau yang lebih tinggi dapat menggunakan definisi resource kustom untuk mengaktifkan Runtime VM di GDC. Resource kustom ini diinstal secara default.

1. Edit resource kustom VMRuntime:

   kubectl edit vmruntime
   

2. Tetapkan enabled:true dalam spesifikasi:

   apiVersion: vm.cluster.gke.io/v1
   kind: VMRuntime
   metadata:
     name: vmruntime
   spec:
     enabled: true
     # useEmulation defaults to "false" if not set.
     useEmulation: true
     # vmImageFormat defaults to "qcow2" if not set.
     vmImageFormat: qcow2
   

   Di bagian spec sebelumnya, nilai berikut dapat ditetapkan:

   • enabled: ditetapkan ke true untuk mengaktifkan Runtime VM di GDC
   • useEmulation: Jika node Anda tidak mendukung virtualisasi hardware, atau Anda tidak yakin, tetapkan nilai ke benar. Jika tersedia, virtualisasi hardware memberikan performa yang lebih baik daripada emulasi software. Kolom useEmulation ditetapkan secara default ke false, jika tidak ditentukan.
   • vmImageFormat: Mendukung dua nilai format image disk: raw dan qcow2. Jika Anda tidak menetapkan vmImageFormat, Runtime VM di GDC akan menggunakan format image disk raw untuk membuat VM. Format raw dapat memberikan performa yang lebih baik dibandingkan qcow2, format copy on write, tetapi dapat menggunakan lebih banyak disk. Untuk informasi selengkapnya tentang format image untuk VM Anda, lihat Format file image disk dalam dokumentasi QEMU.

3. Simpan resource kustom di editor Anda.

4. Pastikan resource kustom VMRuntime diaktifkan:

   kubectl describe vmruntime vmruntime
   

   Detail resource kustom VMRuntime mencakup bagian Status. Runtime VM di GDC diaktifkan dan berfungsi saat VMRuntime.Status.Ready ditampilkan sebagai true.

Menginstal alat klien virtctl

Untuk membuat dan mengelola VM, instal alat klien virtctl.

1. Instal alat klien virtctl sebagai plugin kubectl:

   export GOOGLE_APPLICATION_CREDENTIALS="PATH_TO_SERVICE_ACCOUNT_KEY/bm-gcr.json"
   sudo -E bmctl install virtctl
   

   Kredensial memungkinkan Anda mengautentikasi dan mendownload alat klien virtctl, lalu menginstal ke /usr/bin/kubectl-virt di komputer lokal.

2. Pastikan plugin virtctl telah diinstal:

   kubectl plugin list
   

   Jika kubectl-virt tercantum dalam respons, plugin berhasil diinstal.

   Jika kubectl-virt tidak tercantum, periksa file install-virtctl.log seperti yang tercantum dalam output perintah bmctl install sebelumnya, seperti bmctl-workspace/log/install-virtctl-[date]/install-virtctl.log.

Membuat VM

Dalam panduan memulai ini, Anda akan menggunakan CLI kubectl untuk membuat VM yang menggunakan image VM publik dan kredensial default.

Catatan: Untuk petunjuk cara membuat VM dari file manifes YAML VirtualMachine, lihat Tutorial: Membuat dan mengelola VM Linux di Runtime VM di GDC.

1. Buat VM di cluster Anda. Plugin virtctl digunakan dengan perintah kubectl:

   kubectl virt create vm VM_NAME \
       --image ubuntu20.04 \
       --configure-initial-password USERNAME:PASSWORD
   

   Perintah ini membuat VM Ubuntu 20.04 dan setelan default 2 CPU, memori 4Gi, dan disk booting 20Gi dalam mode ReadWriteOnce menggunakan class penyimpanan local-shared. Ganti nilai berikut:

   • VM_NAME: nama untuk VM Anda. Nama VM hanya boleh berisi karakter alfanumerik huruf kecil atau '-', diawali dan diakhiri dengan karakter alfanumerik, dan berisi maksimal 63 karakter. Untuk informasi selengkapnya, lihat Nama Label RFC 1123 dalam dokumentasi Kubernetes.
   • USERNAME: nama pengguna untuk akun yang akan dibuat di VM.
   • PASSWORD: sandi untuk akun pengguna.

   Jika Anda menerima error tentang parameter CLI, pastikan cluster Anda menggunakan versi 1.11.1 atau yang lebih tinggi dan Anda memiliki alat klien virtctl versi terbaru. Untuk mengetahui informasi selengkapnya tentang error CLI, lihat log konsol. Untuk aturan nama pengguna dan sandi, lihat dokumentasi untuk sistem operasi (OS) tamu. Jika ada yang tidak berfungsi seperti yang diharapkan, periksa masalah umum Runtime VM di GDC.

   Catatan: Perintah sebelumnya membuat file YAML, seperti vm-sample1.yaml, di direktori ~/google-virtctl. Anda dapat melihat konten file ini untuk melihat definisi resource Kubernetes yang dibuat oleh Runtime VM di GDC.

2. Diperlukan waktu beberapa menit untuk membuat VM. Periksa status VM dengan perintah kubectl:

   kubectl get gvm
   

   Contoh output berikut menunjukkan VM dalam status Running:

   NAME         STATUS    AGE   IP
   vm-sample1   Running   64s   192.168.2.124
   

Menghubungkan ke VM Anda

Saat VM berjalan, hubungkan ke konsol VM.

1. Untuk mengakses VM dari konsol, gunakan kubectl:

   kubectl virt console VM_NAME
   

2. Saat diminta, masukkan kredensial pengguna yang Anda tentukan untuk membuat VM.

3. Setelah berhasil terhubung ke konsol VM, keluar dari sesi VM dan konsol:

   Ctrl + ]
   

Pembersihan

Untuk membersihkan resource yang dibuat dalam panduan memulai ini, ikuti langkah-langkah berikut.

1. Untuk menghapus VM dan DataVolume terkait, gunakan kubectl:

   kubectl virt delete vm VM_NAME --all
   

Langkah selanjutnya

• Mengelola status daya VM di Google Distributed Cloud.
• Mengedit VM di Google Distributed Cloud.
• Melihat log konsol VM di Google Distributed Cloud.