Panduan memulai: Membuat VM di cluster Google Distributed Cloud

Runtime VM di GDC memungkinkan Anda menjalankan dan mengorkestrasi virtual machine (VM) dalam lingkungan pengembangan yang seragam di Google Distributed Cloud menggunakan KubeVirt. Dalam panduan memulai ini, Anda akan menggunakan Runtime VM di GDC untuk membuat VM di cluster Anda.

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 perlu, coba Google Distributed Cloud di Compute Engine atau lihat ringkasan pembuatan cluster.

Mengaktifkan Runtime VM di GDC

Runtime VM di GDC otomatis diinstal di Google Distributed Cloud versi 1.10 atau yang lebih baru, tetapi dinonaktifkan secara default. Sebelum dapat menjalankan resource VM di Google Distributed Cloud, Anda harus mengaktifkan VM Runtime on 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 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: ditetapkan ke true untuk mengaktifkan VM Runtime di GDC
    • useEmulation: Jika node Anda tidak mendukung virtualisasi hardware, atau Anda tidak yakin, tetapkan nilainya ke true. 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 disk image: raw dan qcow2. Jika Anda tidak menetapkan vmImageFormat, VM Runtime di GDC akan menggunakan format gambar disk raw untuk membuat VM. Format raw dapat memberikan peningkatan performa dibandingkan qcow2, format copy on write, tetapi dapat menggunakan lebih banyak disk. Untuk mengetahui informasi selengkapnya tentang format image untuk VM Anda, lihat Format file disk image 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 ini memungkinkan Anda mengautentikasi dan mendownload alat klien virtctl, lalu menginstal 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 disebutkan 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 kubectl CLI untuk membuat VM yang menggunakan image VM publik dan kredensial default.

  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 default CPU 2, memori 4Gi, dan boot disk 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 mengetahui 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.

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