In dieser Kurzanleitung erfahren Sie, wie Sie mit Anthos VM Runtime eine virtuelle Maschine (VM) in Anthos-Cluster auf Bare Metal erstellen. Anthos VM Runtime verwendet KubeVirt, um VMs in Clustern zu orchestrieren, und ermöglicht die Arbeit mit Ihren VM-basierten Anwendungen und Arbeitslasten in einer einheitlichen Entwicklungsumgebung.
Hinweis
Wenn Sie diese Kurzanleitung abschließen möchten, benötigen Sie Zugriff auf Anthos-Cluster auf Bare Metal-Version 1.12 (anthosBareMetalVersion: 1.12
) oder höher. Sie können einen beliebigen Clustertyp verwenden, der Arbeitslasten ausführen kann. Bei Bedarf können Sie Anthos-Cluster auf Bare Metal in Compute Engine ausprobieren oder die Übersicht über die Clustererstellung aufrufen.
Anthos VM Runtime aktivieren
Anthos-VM-Laufzeit wird automatisch in Anthos-Clustern auf Bare-Metal-Version 1.10 oder höher installiert, aber ist standardmäßig deaktiviert. Bevor Sie VM-Ressourcen in Ihren Anthos-Clustern auf Bare-Metal ausführen können, müssen Sie die Anthos-VM-Laufzeit aktivieren.
bmctl
Anthos-Cluster auf Bare Metal-Version 1.11 oder höher können das bmctl
-Befehlszeilentool verwenden:
Verwenden Sie das Tool
bmctl
, um die Laufzeit zu aktivieren:bmctl enable vmruntime --kubeconfig KUBECONFIG_PATH
Geben Sie den Pfad zur kubeconfig-Datei für Ihren Cluster an. Anthos-Cluster auf Bare-Metal generiert die kubeconfig-Datei auf der Administrator-Workstation, wenn Sie einen Cluster erstellen. Der Pfad ist standardmäßig
bmctl-workspace/CLUSTER_NAME/CLUSTER_NAME-kubeconfig
.Wenn Anthos VM Runtime bereits aktiviert ist, gibt der Befehl einen Fehler zurück.
Benutzerdefinierte Ressource
Anthos-Cluster auf Bare Metal-Version 1.10 oder höher können eine benutzerdefinierte Ressourcendefinition verwenden, um Anthos VM Runtime zu aktivieren. Diese benutzerdefinierte Ressource wird standardmäßig installiert.
Bearbeiten Sie die benutzerdefinierte
VMRuntime
-Ressource:kubectl edit vmruntime
Legen Sie
enabled:true
in der Spezifikation fest: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
Im vorherigen Abschnitt
spec
können die folgenden Werte festgelegt werden:enabled
: Auf "true" gesetzt, um die Anthos VM-Laufzeit zu aktivierenuseEmulation
: Wenn Ihr Knoten die Hardwarevirtualisierung nicht unterstützt oder Sie sich nicht sicher sind, legen Sie den Wert auf "true" fest. Die Hardwarevirtualisierung bietet eine bessere Leistung als die Softwareemulation. Das FelduseEmulation
ist standardmäßig auffalse
gesetzt, wenn es nicht angegeben ist.vmImageFormat
: Unterstützt zwei Laufwerk-Image-Format-Werte:raw
undqcow2
. Wenn SievmImageFormat
nicht festlegen, verwendet die Anthos VM-Laufzeit das Laufwerk-Image-Formatraw
, um VMs zu erstellen. Das Formatraw
bietet möglicherweise eine bessere Leistung gegenüberqcow2
, eine Kopie des Schreibformats, benötigt aber möglicherweise mehr Platz auf dem Laufwerk. Weitere Informationen zu den Image-Formaten für Ihre VM finden Sie in der QEMU-Dokumentation unter Dateiformate für Laufwerk-Images.
Speichern Sie die benutzerdefinierte Ressource in Ihrem Editor.
Prüfen Sie, ob die benutzerdefinierte Ressource
VMRuntime
aktiviert ist:kubectl describe vmruntime vmruntime
Die Details der benutzerdefinierten Ressource
VMRuntime
enthalten den AbschnittStatus
. Die Anthos VM-Laufzeit ist aktiviert und funktioniert, wenn fürVMRuntime.Status.Ready
der Werttrue
angezeigt wird.
virtctl
-Clienttool installieren
Erstellen und verwalten Sie VMs, indem Sie das virtctl-Clienttool installieren.
Installieren Sie das
virtctl
-CLienttool alskubectl
-Plug-in.export GOOGLE_APPLICATION_CREDENTIALS="PATH_TO_SERVICE_ACCOUNT_KEY/bm-gcr.json" sudo -E bmctl install virtctl
Mit den Anmeldedaten können Sie das
virtctl
-Clienttool authentifizieren und herunterladen und dann unter/usr/bin/kubectl-virt
auf Ihrem lokalen Computer installieren.Überprüfen Sie, ob das Plug-in
virtctl
installiert ist:kubectl plugin list
Wenn
kubectl-virt
in der Antwort aufgeführt ist, wurde das Plug-in erfolgreich installiert.Wenn
kubectl-virt
nicht aufgeführt ist, prüfen Sie die Dateiinstall-virtctl.log
, wie sie in der Ausgabe des vorherigenbmctl install
-Befehls angegeben, z. B.bmctl-workspace/log/install-virtctl-[date]/install-virtctl.log
.
VM erstellen
In dieser Kurzanleitung erstellen Sie mit der kubectl
-Befehlszeile eine VM, die ein öffentliches VM-Image und Standardanmeldedaten verwendet.
Erstellen Sie eine VM in Ihrem Cluster. Das Plug-in
virtctl
wird mit dem Befehlkubectl
verwendet:kubectl virt create vm VM_NAME \ --image ubuntu20.04 \ --configure-initial-password USERNAME:PASSWORD
Dieser Befehl erstellt eine Ubuntu 20.04-VM und Standardeinstellungen von 2 CPU, 4Gi Arbeitsspeicher und ein 20Gi Bootlaufwerk im ReadWriteOnce-Modus und unter Verwendung der Speicherklasse local-shared. Ersetzen Sie die folgenden Werte:
VM_NAME
: der Name Ihrer VM. VM-Namen dürfen nur kleingeschriebene alphanumerische Zeichen oder „-“ enthalten, mit einem alphanumerischen Zeichen beginnen und enden und dürfen höchstens 63 Zeichen enthalten. Weitere Informationen finden Sie in der Kubernetes-Dokumentation unter RFC 1123-Labelnamen.USERNAME
: Nutzername für das Konto, das auf der VM erstellt werden soll.PASSWORD
: das Passwort für das Nutzerkonto.
Wenn ein Fehler zu Befehlszeilenparametern zurückgegeben wird, prüfen Sie, ob Ihr Cluster die Version
1.11.1
oder höher hat und ob Sie die neueste Version des Clienttoolsvirtctl
haben. Weitere Informationen finden Sie unter Bekannte Probleme mit Anthos VM-Runtime.Es kann einige Minuten dauern, bis die VM erstellt ist. Prüfen Sie den Status der VM mit dem Befehl
kubectl
:kubectl get gvm
Das folgende Ausgabebeispiel zeigt die VM im Status
Running
:NAME STATUS AGE IP vm-sample1 Running 64s 192.168.2.124
Mit VM verbinden.
Wenn Ihre VM ausgeführt wird, stellen Sie eine Verbindung zur Konsole der VM her.
Verwenden Sie
kubectl
, um über die Konsole auf eine VM zuzugreifen:kubectl virt console VM_NAME
Geben Sie bei entsprechender Aufforderung die Nutzeranmeldedaten ein, die Sie zum Erstellen der VM verwendet haben.
Nachdem Sie erfolgreich eine Verbindung zur Konsole der VM hergestellt haben, beenden Sie die VM-Sitzung und die Konsole:
Ctrl + ]
Bereinigen
So bereinigen Sie die in dieser Kurzanleitung erstellten Ressourcen:
Verwenden Sie
kubectl
zum Löschen der VM und des zugehörigen DataVolumes:kubectl virt delete vm VM_NAME --all
Nächste Schritte
- Leistungsstatus einer VM in Anthos-Cluster auf Bare Metal verwalten
- VM in Anthos-Cluster auf Bare-Metal bearbeiten
- VM-Konsolenlogs in Anthos-Cluster auf Bare-Metal ansehen