VM Runtime on GDC aktivieren oder deaktivieren

In diesem Dokument erfahren Sie, wie Sie die VM-Laufzeit in Google Distributed Cloud aktivieren oder deaktivieren, indem Sie entweder die benutzerdefinierte Ressource VMRuntime aktualisieren oder Befehle vom Typ bmctl ausführen.

Hinweise

Zum Aktivieren oder Deaktivieren der VM Runtime on GDC benötigen Sie Zugriff auf die folgenden Ressourcen und Tools:

• Zugriff auf einen Google Distributed Cloud-Cluster der Version 1.12.0 (anthosBareMetalVersion: 1.12.0) oder höher. Sie können einen beliebigen Clustertyp verwenden, der Arbeitslasten ausführen kann. Bei Bedarf können Sie Google Distributed Cloud on Compute Engine ausprobieren oder die Übersicht zur Clustererstellung aufrufen.
• bmctl-Befehlszeilentool Weitere Informationen finden Sie unter bmctl-Tool herunterladen und installieren.

Aktivieren Sie die VM Runtime auf GDC

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

bmctl

• 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. Google Distributed Cloud 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 Runtime on GDC bereits aktiviert ist, gibt der Befehl einen Fehler zurück.

Zusätzliche Einstellungen, z. B. für die Emulation oder das Image-format, können durch Bearbeiten der benutzerdefinierten Ressource VMRuntime konfiguriert werden.

Benutzerdefinierte Ressource

Zum Aktivieren der Laufzeit aktualisieren Sie die benutzerdefinierte Ressource VMRuntime: Diese benutzerdefinierte Ressource wird standardmäßig installiert.

1. Bearbeiten Sie die benutzerdefinierte VMRuntime-Ressource:

   kubectl edit vmruntime
   

2. 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 „wahr“ gesetzt, um die VM-Laufzeit auf GDC 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 auf GDC das Laufwerk-Image-Format raw, um VMs zu erstellen. 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.

3. Speichern Sie die benutzerdefinierte Ressource in Ihrem Editor.

4. 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 Runtime on GDC ist aktiviert und funktioniert, wenn für VMRuntime.Status.Ready der Wert true angezeigt wird.

VM Runtime on GDC deaktivieren

Wenn Sie VM Runtime on GDC nicht mehr verwenden müssen, können Sie diese Funktion deaktivieren.

bmctl

• Verwenden Sie das Tool bmctl, um die Laufzeit zu aktivieren:

  bmctl disable vmruntime --kubeconfig KUBECONFIG_PATH \
    --force=true
  

  Geben Sie den Pfad zur kubeconfig-Datei für Ihren Cluster und die Werte für die folgenden Konfigurationsoptionen an:

  • --force: Gesetzt auf true, um zu bestätigen, dass Sie vorhandene VM-Ressourcen löschen möchten. Der Standardwert ist false.

Benutzerdefinierte Ressource

Zum Deaktivieren der Laufzeit aktualisieren Sie die benutzerdefinierte Ressource VMRuntime:

1. Bearbeiten Sie die benutzerdefinierte VMRuntime-Ressource:

   kubectl edit vmruntime
   

2. Legen Sie enabled:false in der Spezifikation fest:

   apiVersion: vm.cluster.gke.io/v1`
   kind: VMRuntime
   metadata:
     name: vmruntime
   spec:
     enabled: false
     useEmulation: true
     vmImageFormat: qcow2
   

3. Speichern Sie die aktualisierte benutzerdefinierte Ressourcenspezifikation in Ihrem Editor.

4. Wenn Sie prüfen möchten, ob die benutzerdefinierte Ressource VMRuntime deaktiviert ist, rufen Sie die Pods auf, die im Namespace vm-system ausgeführt werden:

   kubectl get pods --namespace vm-system
   

   VM Runtime on GDC ist deaktiviert, wenn nur die Pods, die zur Bereitstellung vmruntime-controller-manager gehören, im Namespace ausgeführt werden.

Informationen zum Verhalten laufender VMs

Die Annotation baremetal.cluster.gke.io/vmrumtime-force-disable kann für die VM Runtime on GDC-Ressource verwendet werden, um das Verhalten zu definieren, wenn die Laufzeit deaktiviert wird, während VMs im Cluster ausgeführt werden.

Das folgende Beispiel zeigt, dass der Wert dieser Annotation standardmäßig auf false gesetzt ist:

// VM runtime yaml file
apiVersion: vm.cluster.gke.io/v1
kind: VMRuntime
metadata:
  annotations:
    baremetal.cluster.gke.io/vmrumtime-force-disable: "false"
  name: vmruntime
[...]

Wenn diese Anmerkung auf false gesetzt ist, versucht die VM Runtime on GDC, laufende VMs zu schützen. Löschen Sie alle ausgeführten VMs, bevor die VM Runtime on GDC deaktiviert wird, oder geben Sie den Parameter --force=true mit dem Befehl bmctl disable vmruntime an, wie im vorherigen Abschnitt gezeigt.

In der folgenden Tabelle wird erläutert, was mit aktiven VMs geschieht, wenn diese Annotation auf true oder false gesetzt ist und wenn Sie den Parameter --force=true angeben oder nicht:

Cluster Status	--force parameter	vmrumtime-force-disable Annotation	Verhalten
Keine VMs	–	–	Deaktivieren Sie VM Runtime on GDC.
Vorhandene VMs	Wahr	True	Alle laufenden VMs und die zugehörigen Ressourcen löschen. Deaktivieren Sie die VM Runtime on GDC.
	True	Falsch	Alle laufenden VMs und die zugehörigen Ressourcen löschen. Deaktivieren Sie die VM Runtime on GDC.
	Falsch	True	Aufforderung zum Löschen laufender VMs und zugehöriger Ressourcen. Wenn alle laufenden VMs gelöscht wurden, deaktivieren Sie die VM Runtime on GDC.
	Falsch	Falsch	Keine vorhandenen laufenden VMs löschen. Deaktivieren Sie die VM Runtime on GDC nicht. Der bmctl-Befehl gibt einen Fehler zurück.

Preflight-Prüfung für VM Runtime on GDC

Bei der Preflight-Prüfung der VM Runtime on GDC werden eine Reihe von Voraussetzungen in der Umgebung des Computers geprüft, bevor die VM Runtime on GDC und VMs verwendet werden. Die VM-Erstellung wird blockiert, wenn die Preflight-Prüfung der VM Runtime on GDC fehlgeschlagen ist. Die Preflight-Prüfung für VM Runtime on GDC wird automatisch ausgeführt, wenn spec.enabled auf „wahr“ gesetzt ist.

Hinweis :Sie können die Preflight-Prüfung für die VM Runtime on GDC auf ausgewählten Knoten überspringen, bevor Sie die Preflight-Prüfung auslösen. Wenn Sie beispielsweise die Preflight-Prüfung für Knoten überspringen möchten, können Sie den Knoten wie unten beschrieben mit kubevm.io/VM-SkipSchedule labeln:

kubectl label nodes NODE_NAME "kubevm.io/VM-SkipSchedule"= --kubeconfig KUBECONFIG_PATH

Die Preflight-Prüfung für VM Runtime on GDC wird ausgeführt, wenn Sie einen der folgenden Vorgänge ausführen:

1. Aktivieren Sie die VM Runtime auf GDC

2. VM Runtime on GDC-Funktionen wie „useEmulation“ aktivieren

3. Cluster aktualisieren

4. Label „kubevm.io/VM-SkipSchedule“ an Knoten entfernen

5. Sie können ein Preflight-Prüfobjekt für VM Runtime on GDC unabhängig erstellen, indem Sie den Befehl bmctl check vmruntimepfc --kubeconfig KUBECONFIG_PATH ausführen oder ein VMRuntimePreflightCheck-YAML-Manifest anwenden.

Sie können VMs starten, wenn die letzte Preflight-Prüfung der VM Runtime on GDC erfolgreich war. Wenn die Preflight-Prüfung fehlschlägt, wird die VM-Erstellung blockiert und Sie erhalten Preflight-Prüfungsfehler.

Erfolg der Preflight-Prüfung prüfen

Führen Sie die folgenden Befehle aus, um zu prüfen, ob die Preflight-Prüfungen erfolgreich waren:

1. So rufen Sie die letzten Preflight-Prüfungen auf:

   kubectl get vmruntimepfc -n vm-system --kubeconfig KUBECONFIG_PATH
   

   Die Ausgabe sollte wie folgt aussehen:

   NAME                                                             PASS    AGE
   vmruntime-preflight-check-6ee61513-ea5d-4340-9374-90396cac129e   false   42s
   vmruntime-preflight-check-f8d71751-a01c-471e-bab5-3370fc2addd5   true    21s
   

2. Führen Sie den folgenden Befehl aus, um den Status einer Preflight-Prüfung zu ermitteln:

   kubectl get vmruntime vmruntime -o yaml --kubeconfig KUBECONFIG_PATH
   

   ...
     preflightCheckSummary:
     preflightCheckSummary:
       featureStatuses:
         CPU:
           passed: true
         KVM:
           passed: true
       preflightCheckName: vmruntime-preflight-check-f8d71751-a01c-471e-bab5-3370fc2addd5
       preflightCheckPassed: true
   ...
   

Preflight-Prüfung für die Fehlerbehebung schlägt fehl

Wenn die Preflight-Prüfung fehlschlägt, führen Sie die folgenden Schritte aus, um sie zu beheben:

1. Letzte durchgeführten Preflight-Prüfungen ansehen

   kubectl get vmruntimepfc -n vm-system
   

2. Weitere Informationen finden Sie im Status dieser Preflight-Prüfung.

   kubectl get vmruntimepfc -n vm-system \
       vmruntime-preflight-check-6ee61513-ea5d-4340-9374-90396cac129e -o yaml \
       --kubeconfig KUBECONFIG_PATH
   

   ...
   status:
   checks:
     worker-0--52229ee15841099-22c41577139a7b8c.lab.anthos:
       passed: false
       results:
       - checkName: CPU
         passed: true
       - checkName: KVM
         message: |
           command terminated with exit code 1
           ls: /mnt/dev/kvm: No such file or directory
         passed: false
   ...
   

3. Beheben Sie das Problem und führen Sie die Preflight-Prüfung für VM Runtime on GDC noch einmal aus. Im Folgenden sehen Sie ein Beispiel für ein YAML-Manifest für VMRuntimePreflightCheck:

   apiVersion: vm.cluster.gke.io/v1
   kind: VMRuntimePreflightCheck
   metadata:
     name: vmruntime-preflight-check-manual
     namespace: vm-system
   

Nächste Schritte

• VM in Google Distributed Cloud erstellen.