Aktualisieren eines Azure Red Hat OpenShift-Clusters

Im Rahmen des Microsoft Azure Red Hat OpenShift-Clusterlebenszyklus müssen Sie regelmäßige Updates für die neueste Version der OpenShift-Plattform durchführen. Durch das Aktualisieren Ihrer Azure Red Hat OpenShift-Cluster können Sie auf die neuesten Features und Funktionen aktualisieren und die neuesten Sicherheitsversionen anwenden.

In diesem Artikel erfahren Sie, wie Sie alle Komponenten in einem OpenShift-Cluster mithilfe der OpenShift-Webkonsole, der CLI oder des Managed-Upgrade-Operators (MUO) aktualisieren. Weitere Informationen zu OpenShift-Updates finden Sie unter Grundlegendes zu OpenShift-Updates.

Von Bedeutung

Das Ausführen eines Nur-Kontrollbereich-Updates wird für Azure Red Hat OpenShift nicht unterstützt und kann zu einer Instabilität des Clusters führen.

Note

Weitere Informationen zum Aktualisieren von 4.20 auf 4.21 finden Sie unter Aktualisieren von 4.20 auf 4.21.

Voraussetzungen

  • In diesem Artikel wird davon ausgegangen, dass Sie Zugriff auf einen Azure Red Hat OpenShift-Cluster mit admin-Berechtigungen haben.

  • Stellen Sie sicher, dass die Anmeldeinformationen für den Dienstprinzipal, der für den Cluster verwendet wird, gültig/aktualisiert sind, bevor Sie die Aktualisierung starten. Weitere Informationen finden Sie unter Rotate service principal credentials for your Azure Red Hat OpenShift cluster.

Suchen nach verfügbaren Clusterupdates mithilfe der Webkonsole

  1. Stellen Sie im linken Menü der OpenShift-Webkonsole sicher, dass Sie sich in der Perspektive "Administrator " befinden. Dies ist die Standardeinstellung, wenn Sie sich als Kubeadmin anmelden.

  2. Wählen Sie die Registerkarte Verwaltung aus.

  3. Wählen Sie "Clustereinstellungen" aus, und öffnen Sie die Registerkarte "Details ". Die Version, der Updatestatus und der Kanal werden angezeigt. Der Kanal ist standardmäßig nicht konfiguriert.

  4. Wählen Sie den Channel-Link aus, und geben Sie an der Eingabeaufforderung den gewünschten Updatekanal ein, z. B. stable-4.19. Sobald der gewünschte Kanal ausgewählt ist, wird ein Diagramm mit verfügbaren Releases und Kanälen angezeigt. Wenn als Updatestatus für Ihren Cluster Updates verfügbar angezeigt wird, können Sie den Cluster aktualisieren.

Aktualisieren Des Clusters mit der OpenShift-Webkonsole

Legen Sie in der OpenShift-Webkonsole im vorherigen Schritt den Kanal für die Version fest, auf die Sie aktualisieren möchten, wie zum Beispiel stable-4.19.

Wählen Sie eine Version für die Aktualisierung aus und wählen Sie Update aus. Sie sehen die Änderung des Aktualisierungsstatus in: Update to <product-version> in progress. Sie können den Fortschritt der Clusteraktualisierung überprüfen, indem Sie die Fortschrittsleisten für die Operatoren und Knoten überwachen.

Einzelne Updates mithilfe des Managed-Upgrade-Operators planen

Verwenden Sie den Managed-Upgrade-Operator (MUO), um Ihren Azure Red Hat OpenShift-Cluster zu aktualisieren.

Der Managed-Upgrade-Operator verwaltet automatisierte Clusterupdates. Der Operator für verwaltete Upgrades startet das Clusterupdate, führt jedoch keine Aktivitäten des Clusteraktualisierungsprozesses selbst durch. Die OpenShift Container Platform (OCP) ist für die Aktualisierung der Cluster verantwortlich. Das Ziel des Operators für verwaltete Upgrades besteht darin, die Betriebsbedingungen zu erfüllen, die ein verwalteter Cluster vor und nach dem Starten des Clusterupdates enthalten muss.

  1. Bereiten Sie die Konfigurationsdatei vor, wie im folgenden Beispiel zum Aktualisieren auf OpenShift 4.19 gezeigt.
apiVersion: upgrade.managed.openshift.io/v1alpha1
kind: UpgradeConfig
metadata:
  name: managed-upgrade-config
  namespace: openshift-managed-upgrade-operator
spec:
  type: "ARO"
  upgradeAt: "2025-09-08T03:20:00Z"
  PDBForceDrainTimeout: 60
  desired:
    channel: "stable-4.19"
    version: "4.19.15"
  • upgradeAT ist der Zeitpunkt, zu dem das Update auftritt.
  • channel ist der Kanal, aus dem die Konfigurationsdatei gemäß der Lifecycle-Richtlinie abgerufen wird. Der verwendete Kanal sollte sein stable-<version> oder eus-<version>.
  • version ist die Version, auf die Sie aktualisieren möchten, z. B. 4.19.15.
  1. Wenden Sie die Konfigurationsdatei an. Ersetzen Sie <file_name> durch den Namen Ihrer Datei.
oc create -f <file_name>.yaml

Aktualisieren Ihres Clusters mithilfe der CLI

Weitere Informationen finden Sie unter Aktualisieren eines Clusters mithilfe der CLI.

Extended Update Support Erweiterung (EUS) Term 1 updates

Beim Aktualisieren Ihres Clusters von einer EUS-Version auf eine andere EUS-Version (z. B. 4.16 auf 4.18) müssen Sie auf die Zwischenversion und dann auf die Ziel-EUS-Version aktualisieren. Um beispielsweise von 4.16 auf 4.18 zu aktualisieren, müssen Sie auf 4.17 und dann auf 4.18 aktualisieren. Updates nur für die Steuerungsebene werden nicht unterstützt. Sie müssen auch den relevanten Updatekanal für Ihre Zielversion auswählen, z. B. eus-4.18.

Update von 4.20 auf 4.21

Die openshift Clusterbildrichtlinie ist ab Version 4.21 allgemein verfügbar. Daher sind Sigstore-Signaturen für die quay.io/openshift-release-dev/ocp-release Images nun für die Release-Verifizierung erforderlich. Wenn Sie versuchen, auf Version 4.21 zu aktualisieren, ist ein "Dieser Cluster hat Spiegel konfiguriert. 4.21 erfordert Sigstore Signaturen..." Meldung blockiert das Update. Für Azure Red Hat OpenShift Cluster ist keine weitere Aktion erforderlich, da der Dienst bereits die erforderlichen Sigstore-Signaturimages bereitstellt.

Um mit dem Update fortzufahren, geben Sie der Administratorbestätigung an. Führen Sie den folgenden Befehl aus, bevor Sie fortfahren:

oc -n openshift-config patch configmap admin-acks --patch '{"data":{"ack-4.20-sigstore-in-4.21":"true"}}' --type=merge

Nächste Schritte

  • Informationen zu den verfügbaren OpenShift Container Platform-Empfehlungen und -Updates finden Sie im Abschnitt errata des Red Hat-Kundenportals.