Panduan memulai: Membuat VM di cluster Google Distributed Cloud

Panduan memulai ini menunjukkan cara menggunakan VM Runtime di GDC untuk membuat virtual machine (VM) di Google Distributed Cloud. VM Runtime di GDC menggunakan KubeVirt untuk mengatur VM di cluster, dan memungkinkan Anda bekerja dengan 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 dapat menjalankan workload. Jika diperlukan, coba Google Distributed Cloud di Compute Engine atau lihat ringkasan pembuatan cluster.

Mengaktifkan VM Runtime di GDC

VM Runtime 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 VM Runtime 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, jalur ini adalah bmctl-workspace/CLUSTER_NAME/CLUSTER_NAME-kubeconfig.

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

Resource kustom

Google Distributed Cloud versi 1.10 atau yang lebih baru dapat menggunakan definisi resource kustom untuk mengaktifkan VM Runtime 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: disetel ke benar (true) untuk mengaktifkan VM Runtime di GDC
   • useEmulation: Jika node Anda tidak mendukung virtualisasi hardware, atau Anda tidak yakin, tetapkan nilai ke benar (true). Jika tersedia, virtualisasi hardware memberikan performa yang lebih baik daripada emulasi software. Kolom useEmulation secara default ditetapkan ke false, jika tidak ditentukan.
   • vmImageFormat: Mendukung dua nilai format image disk: raw dan qcow2. Jika Anda tidak menyetel vmImageFormat, VM Runtime di GDC akan menggunakan format image disk raw untuk membuat VM. Format raw dapat memberikan peningkatan performa dibandingkan qcow2, format salin saat menulis, tetapi dapat menggunakan lebih banyak disk. Untuk mengetahui informasi selengkapnya tentang format gambar 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.

Instal 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 ini memungkinkan Anda mengautentikasi dan mendownload alat klien virtctl, lalu menginstalnya ke /usr/bin/kubectl-virt di komputer lokal Anda.

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 mengetahui petunjuk tentang cara membuat VM dari file manifes YAML VirtualMachine, lihat Tutorial: Membuat dan mengelola VM Linux di VM Runtime 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 akan 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 berada di 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 mengetahui aturan nama pengguna dan sandi, lihat dokumentasi untuk sistem operasi (OS) tamu. Jika ada sesuatu yang tidak berfungsi seperti yang diharapkan, periksa Masalah umum VM Runtime 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 VM Runtime di GDC.

2. Pembuatan VM dapat memakan waktu beberapa menit. 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 Anda 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 Anda berhasil terhubung ke konsol VM, keluar dari sesi dan konsol VM:

   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 berikutnya

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