Version 1.14. This version is no longer supported. For information about how to upgrade to version 1.15, see Upgrading Anthos on bare metal in the 1.15 documentation. For more information about supported and unsupported versions, see the Version history page in the latest documentation.

Kurzanleitung: VM in GKE on Bare Metal erstellen

In dieser Kurzanleitung erfahren Sie, wie Sie mit der VM-Laufzeit in Google Distributed Cloud eine virtuelle Maschine (VM) in GKE on Bare Metal erstellen. Die VM-Laufzeit in Google Distributed Cloud nutzt KubeVirt, um VMs auf Clustern zu orchestrieren. So können Sie mit Ihren VM-basierten Anwendungen und Arbeitslasten in einer einheitlichen Entwicklungsumgebung arbeiten.

Hinweise

Für diese Kurzanleitung benötigen Sie Zugriff auf den Cluster von GKE on Bare Metal ab Version 1.12 (anthosBareMetalVersion: 1.12). Sie können einen beliebigen Clustertyp verwenden, der Arbeitslasten ausführen kann. Testen Sie bei Bedarf GKE on Bare Metal in Compute Engine oder sehen Sie sich die Übersicht über die Clustererstellung an.

VM-Laufzeit in Google Distributed Cloud aktivieren

Die VM-Laufzeit in Google Distributed Cloud wird automatisch in GKE on Bare Metal-Version 1.10 oder höher installiert, ist aber standardmäßig deaktiviert. Bevor Sie VM-Ressourcen in GKE on Bare Metal ausführen können, müssen Sie die VM-Laufzeit in Google Distributed Cloud aktivieren.

bmctl

GKE on Bare Metal ab Version 1.11 kann 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. GKE on 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 die VM-Laufzeit in Google Distributed Cloud bereits aktiviert ist, gibt der Befehl einen Fehler zurück.

Benutzerdefinierte Ressource

GKE on Bare Metal-Version 1.10 oder höher kann eine benutzerdefinierte Ressourcendefinition verwenden, um die VM-Laufzeit in Google Distributed Cloud 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“ setzen, um die VM-Laufzeit in Google Distributed Cloud zu aktivieren
- useEmulation: 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 Feld useEmulation ist standardmäßig auf false gesetzt, wenn es nicht angegeben ist.
- vmImageFormat: Unterstützt zwei Laufwerk-Image-Format-Werte: raw und qcow2. Wenn Sie vmImageFormat nicht festlegen, verwendet die VM-Laufzeit in Google Distributed Cloud das Laufwerk-Image-Format raw zum Erstellen von VMs. Das Format raw bietet möglicherweise eine bessere Leistung gegenüber qcow2, 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 Abschnitt Status. VM-Laufzeit in Google Distributed Cloud ist aktiviert und funktioniert, wenn VMRuntime.Status.Ready als true angezeigt wird.

`virtctl`-Clienttool installieren

Erstellen und verwalten Sie VMs, indem Sie das virtctl-Clienttool installieren.

Installieren Sie das virtctl-CLienttool als kubectl-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 Datei install-virtctl.log, wie sie in der Ausgabe des vorherigen bmctl install-Befehls angegeben, z. B. bmctl-workspace/log/install-virtctl-[date]/install-virtctl.log.

VM erstellen

In dieser Kurzanleitung verwenden Sie die kubectl-Befehlszeile, um eine VM zu erstellen, die ein öffentliches VM-Image und Standardanmeldedaten verwendet.

Erstellen Sie eine VM in Ihrem Cluster. Das Plug-in virtctl wird mit dem Befehl kubectl 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 höchstens 63 Zeichen enthalten. Weitere Informationen finden Sie in der Kubernetes-Dokumentation unter RFC 1123-Labelnamen.
- USERNAME ist der 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 Clienttools virtctl haben. Weitere Informationen zu CLI-Fehlern finden Sie im Konsolenlog. Informationen zu Nutzernamen- und Passwortregeln finden Sie in der Dokumentation des Gastbetriebssystems. Wenn etwas nicht wie erwartet funktioniert, suchen Sie nach bekannten Problemen mit der VM-Laufzeit in Google Distributed Cloud.

Hinweis: Mit dem vorherigen Befehl wird eine YAML-Datei wie vm-sample1.yaml im Verzeichnis ~/google-virtctl erstellt. Sie können den Inhalt dieser Datei aufrufen, um die Definition der Kubernetes-Ressourcen zu sehen, die von VM Runtime in Google Distributed Cloud erstellt wurden.
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 Console 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 Console:
```
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
```