Verwaltung des Virtualisierungs-Add-ons für „ OpenShift “

Virtuelle Private Cloud 4.21 und später Nur Bare-Metal-Arbeitsknoten Nur RHCOS

Das Add-on „ openshift-virtualization “ ermöglicht die Einrichtung der Virtualisierungsplattform auf Clustern des „ OpenShift Virtualization Service“ mit nur einem Klick. Dieses Add-on ist standardmäßig auf allen Virtualization Service-Clustern automatisch aktiviert.

Das Virtualisierungs-Add-on für „ OpenShift “ verstehen

Das Virtualisierungs-Add-on „ OpenShift “ koordiniert die Bereitstellung und Verwaltung der folgenden Operatoren, um Funktionen für virtuelle Maschinen in Ihrem Virtualization Service-Cluster zu ermöglichen:

OpenShift Virtualisierungsspezialist (hyperkonvergente Lösungen)
Bietet die grundlegenden Virtualisierungsfunktionen für die Ausführung und Verwaltung virtueller Maschinen. Weitere Informationen finden Sie unter „ OpenShift-Virtualisierung installieren “.
NMState-Betreiber
Verwaltet die Netzwerkkonfiguration für virtuelle Maschinen und Knoten. Weitere Informationen finden Sie unter „Über den NMState-Operator der „ Kubernetes “.
Node Wartungstechniker
Übernimmt die Wartungsaufgaben für Knoten bei Workloads virtueller Maschinen. Weitere Informationen finden Sie unter „ Node-Wartungsoperator “.

Die Installation dieser Operatoren von Red Hat OperatorHub ist auf Virtualization Service-Clustern gesperrt. Das Add-on verwaltet alle Installationen und Updates des Betreibers.

Zusatzmerkmale

Das Virtualisierungs-Add-on für „ OpenShift “ weist folgende Merkmale auf:

Automatische Aktivierung
Das Add-on wird automatisch aktiviert, wenn Sie einen Virtualization Service-Cluster erstellen. Sie können das Add-on nicht manuell über die CLI oder die Konsole aktivieren.
Kann nicht deaktiviert werden
Das Deaktivieren des Add-ons wird nicht unterstützt. Die Option ist in der Konsole nicht verfügbar, und der Versuch, sie über die Befehlszeilenschnittstelle zu deaktivieren, führt zu einer Fehlermeldung.
Keine Konfigurationsoptionen
Das Add-on verfügt über keine vom Benutzer konfigurierbaren Parameter.
Versionsbindung
Die Add-on-Version ist an die Version des Virtualization Service-Clusters gebunden (beispielsweise 4.21 ). Das Add-on unterstützt die aktuelle Nebenversion und die nächste Nebenversion ( n+1 ). Beispielsweise kann die Add-on-Version 4.21 mit den Virtualization Service-Versionen 4.21 und 4.22 verwendet werden.
Automatische Patch-Updates
Patch-Updates werden mithilfe der Strategie „ Automatische Genehmigung “ automatisch auf Ihren Cluster angewendet. IBM informiert Sie mindestens eine Woche vor Produktionsstart über die Änderungen. Alle abhängigen Operatoren werden automatisch aktualisiert, wenn im gespiegelten Operator-Katalog neue Versionen vorhanden sind. Das Add-on nutzt den Kanal „ stable “ für alle Betreiber-Updates.
Manuelle Versions-Upgrades
Um das Add-on auf eine neuere Version zu aktualisieren (beispielsweise von 4.20 auf 4.21 ), müssen Sie zunächst Ihren Virtualization Service-Cluster auf die Zielversion aktualisieren und anschließend die Add-on-Version manuell mithilfe des CLI-Befehls „ ibmcloud ks cluster addon update openshift-virtualization --cluster CLUSTER_NAME_OR_ID --version VERSION “ aktualisieren.
Kanal aktualisieren
Das Add-on nutzt für Updates den Kanal „ stable “, der Z-Stream-Updates für Fehlerbehebungen und Sicherheitsprobleme bereitstellt.
Versionskompatibilität
Jede Add-on-Version unterstützt die aktuelle Version des Virtualization Service (n) sowie die nächste Nebenversion ( n+1 ). Beispielsweise unterstützt die Add-on-Version 4.20 die Virtualization Service-Versionen 4.20 und 4.21.
Benutzerdefinierter Katalog
Bei der Aktivierung des Add-ons wird automatisch ein benutzerdefinierter Katalog mit gespiegelten abhängigen Operatoren eingerichtet und im Namespace „ openshift-marketplace “ abgelegt.

Installierte Ressourcen

Wenn das Add-on aktiviert ist, werden die folgenden Ressourcen erstellt:

Übergeordneter Operator-Namensraum
Der Namespace „ ibm-openshift-virt-operator “ enthält alle Ressourcen, die sich auf den übergeordneten Operator beziehen, einschließlich einer benutzerdefinierten Ressource vom Typ „ ibmopenshiftvirtualizations.openshiftvirt.ibm.io “.
Benutzerdefinierter Katalog
Der benutzerdefinierte Katalog wird im Namensraum „ openshift-marketplace “ abgelegt.
Abhängige Betreiber
Der übergeordnete Operator fungiert als Metaoperator und fügt während der Abgleichung die folgenden abhängigen Operatoren ein:
  • OpenShift Virtualisierung (im Namensraum „ openshift-cnv “)
  • NMState (im Namensraum „ openshift-nmstate “)
  • Node Wartungsoperator (im Namensraum „ openshift-operators “)

Informationen zum Add-on anzeigen

Sofern das Feature-Flag für Ihr Konto aktiviert ist, können Sie über die CLI Informationen zum Add-on „ OpenShift-Virtualisierung“ abrufen. Wenn das Feature-Flag nicht aktiviert ist, überprüfen Sie den Status des Add-ons stattdessen anhand der Konsolen- und Clusterdetails.

Liste der installierten Add-ons

Listen Sie alle Add-ons auf, die in Ihrem Virtualization Service-Cluster installiert sind.

ibmcloud ks cluster addon ls --cluster CLUSTER_NAME_OR_ID

Beispielausgabe:

Name                       Version   Health State   Health Status
ibm-storage-operator       1.0       normal         Addon Ready. For more info: http://ibm.biz/addon-state (H1500)
openshift-virtualization   4.21      normal         Addon Ready. For more info: http://ibm.biz/addon-state (H1500)

Details zum Add-on abrufen

Wenn das Feature-Flag für Ihr Konto aktiviert ist, erhalten Sie detaillierte Informationen zum Add-on „ OpenShift-Virtualisierung“.

ibmcloud ks cluster addon get --addon openshift-virtualization --cluster CLUSTER_NAME_OR_ID

Beispielausgabe:

name:            openshift-virtualization
Version:         4.21
Health State:    normal
Health Status:   Addon Ready. For more info: http://ibm.biz/addon-state (H1500)

Verfügbare Add-on-Versionen auflisten

Wenn das Feature-Flag für Ihr Konto aktiviert ist, werden die verfügbaren Versionen des Add-ons „ OpenShift-Virtualisierung“ aufgelistet.

ibmcloud ks cluster addon versions --addon openshift-virtualization

Beispielausgabe:

Name                       Version   Supported Kubernetes Range   Supported OpenShift Range   Kubernetes Default   OpenShift Default
openshift-virtualization   4.19      unsupported                  >=4.19.0 <4.21.0            -                    >=4.19.0 <4.21.0
openshift-virtualization   4.21      unsupported                  >=4.21.0 <4.23.0            -                    >=4.21.0 <4.23.0

Diese Ausgabe zeigt, welche Versionen des Virtualisierungsdienstes von den einzelnen Add-on-Versionen unterstützt werden.

Konfigurationsoptionen prüfen

Sofern das Feature-Flag für Ihr Konto aktiviert ist, können Sie feststellen, dass das Add-on „ OpenShift-Virtualisierung“ keine Konfigurationsoptionen unterstützt.

ibmcloud ks cluster addon options --addon openshift-virtualization

Beispielausgabe:

FAILED
No addon installation options are available for openshift-virtualization.

Add-on aktualisieren

Das Virtualisierungs-Add-on für „ OpenShift “ unterstützt zwei Arten von Updates:

Automatische Patch-Updates

Patch-Updates (z. B. von 4.21.1 auf 4.21.2 ) werden automatisch auf alle Cluster angewendet. Diese Updates umfassen Fehlerbehebungen und Sicherheitspatches. IBM informiert mindestens eine Woche im Voraus, bevor Patch-Updates in der Produktion bereitgestellt werden.

Der automatische Patch-Aktualisierungsprozess führt Folgendes aus:

  1. Startet den übergeordneten Operator neu
  2. Stimmt die Katalogquelle ab
  3. Aktualisiert alle untergeordneten Operatoren auf Grundlage des Abonnements für den Kanal „ stable

Manuelle Versions-Upgrades

Um das Virtualisierungs-Add-on für „ OpenShift “ auf eine neuere Nebenversion zu aktualisieren (z. B. von „ 4.20 “ auf „ 4.21 “), müssen Sie zunächst Ihren Virtualization Service-Cluster auf die Zielversion aktualisieren. Falls das Feature-Flag für Ihr Konto nicht aktiviert ist, wenden Sie sich bitte an den IBM-Support, bevor Sie die Aktualisierung über die Befehlszeile durchführen.

  1. Aktualisieren Sie Ihren Virtualization Service-Cluster auf die Zielversion. Weitere Informationen finden Sie unter „ Cluster aktualisieren “.

  2. Nachdem das Cluster-Upgrade abgeschlossen ist, aktualisieren Sie das Add-on auf die entsprechende Version.

    ibmcloud ks cluster addon update openshift-virtualization --cluster CLUSTER_NAME_OR_ID --version VERSION
    

    Um beispielsweise auf die Version 4.21:

    ibmcloud ks cluster addon update openshift-virtualization --cluster my-rovs-cluster --version 4.21
    

Es wird dringend empfohlen, die Add-on-Version an die Version Ihres Clusters anzupassen, um optimale Kompatibilität und Support zu gewährleisten.

Das Add-on deaktivieren

Die Deaktivierung des Virtualisierungs-Add-ons „ OpenShift “ wird auf Virtualization Service-Clustern (Phase 1) nicht unterstützt. Das Add-on ist eine Kernkomponente des Virtualisierungsdienstes und kann nicht entfernt werden. Wenn das Feature-Flag für Ihr Konto aktiviert ist und Sie den CLI-Befehl ausführen, führt dies zu einem Fehler.

ibmcloud ks cluster addon disable openshift-virtualization --cluster CLUSTER_NAME_OR_ID

Die Unterstützung für die Deinstallation von Add-ons ist für Standard-ROKS-Cluster in Phase 2 geplant.

Fehlerbehebung beim Add-on

Sollten bei Ihnen Probleme mit dem Virtualisierungs-Add-on für „ OpenShift “ auftreten, sammeln Sie bitte die folgenden Informationen, bevor Sie einen Support-Fall eröffnen.

Zusätzliche Informationen sammeln

Führen Sie die folgenden Befehle aus, um Informationen zum Virtualisierungs-Add-on von „ OpenShift “ und den damit verbundenen Operatoren abzurufen.

  1. Laden Sie die benutzerdefinierte Ressource „ IBM “ für die Virtualisierung unter OpenShift herunter.

    oc get ibmopenshiftvirtualizations.openshiftvirt.ibm.io -n ibm-openshift-virt-operator -o yaml
    
  2. Alle Ressourcen im übergeordneten Operator-Namensraum auflisten.

    oc get all -n ibm-openshift-virt-operator
    
  3. Überprüfen Sie den Status des Virtualisierungsoperators von „ OpenShift “.

    oc get csv -n openshift-cnv
    
  4. Hier finden Sie weitere Informationen zu „ HyperConverged “.

    oc get hco -n openshift-cnv kubevirt-hyperconverged -o yaml
    
  5. Alle Ressourcen im Namespace „ OpenShift-Virtualisierung“ auflisten.

    oc get all -n openshift-cnv
    
  6. Überprüfen Sie den Status des NMState-Betreibers.

    oc get csv -n openshift-nmstate
    
  7. Alle Ressourcen im Namensraum „NMState“ auflisten.

    oc get all -n openshift-nmstate
    
  8. Rufen Sie die Details zur NMState-Ressource ab.

    oc get nmstate nmstate -o yaml
    
  9. NodeNetworkConfigurationPolicy-Ressourcen auflisten.

    oc get nncp
    
  10. Überprüfen Sie den Status des Wartungsoperators für den „ Node “.

    oc get csv -n openshift-operators
    
  11. Alle Ressourcen im Namespace „operators“ auflisten.

    oc get all -n openshift-operators
    
  12. Überprüfen Sie die Quelle des benutzerdefinierten Katalogs.

    oc get catalogsource custom-redhat-operators-openshiftvirt -n openshift-marketplace
    
  13. Liste der Paketmanifeste aus dem benutzerdefinierten Katalog.

    oc get packagemanifests -n openshift-marketplace | grep "Custom Redhat Operators for Openshift Virtualization"
    

Supportfall öffnen

Sollte Ihr Problem weiterhin bestehen, erstellen Sie bitte einen Support-Fall und fügen Sie die Ausgabe der Befehle zur Fehlerbehebung bei. Weitere Informationen finden Sie unter Support anfordern.

Nächste Schritte