Warum wird eine Cannot complete cluster master upgrade-Nachricht angezeigt?

Beheben Sie Fehler, die beim Aktualisieren oder Upgraden Ihres Cluster-Masters auftreten.

Virtual Private Cloud Klassische Infrastruktur Satellite

Wenn Sie ein Upgrade für einen Cluster-Master durchführen, erhalten Sie eine Cannot complete cluster master upgrade-Fehlernachricht ähnlich der im folgenden Beispiel.

Cannot complete cluster master upgrade because the Upgradeable status condition is set to False.

Es gibt verschiedene Gründe, warum der Clusterversionsoperator den Upgradeable-Status False zurückmeldet. Wenn Sie beispielsweise ein Upgrade von Red Hat OpenShift 4.15 auf 4.16 durchführen und diese Fehlermeldung erhalten, haben Ihre Cluster-Administratoren wahrscheinlich noch nicht bestätigt, dass sie die veralteten APIs in der entsprechenden Version von Kubernetes geprüft und entfernt haben. Weitere Informationen finden Sie unter Vorbereitung auf das Update auf OpenShift Container Platform 4.16.

Führen Sie den folgenden Befehl aus, um die Ursache (en) zu überprüfen, dass sich Ihr Cluster nicht in einem aktualisierbaren Status befindet.

oc get clusterversion version -o json | jq '.status.conditions[] | select(.type == "Upgradeable")'

  1. Überprüfen Sie die Versionsinformationen und Aktualisierungsaktionen für die Version, auf die Sie aktualisieren möchten. Bewerten Sie Ihren Cluster auf APIs, die in der neuen Version entfernt wurden.

  2. Überprüfen Sie die Felder reason und message aus dem JSON-Objekt auf den aktualisierbaren False-Status. Wenn Sie versuchen, ein Upgrade von Red Hat OpenShift 4.15 auf Red Hat OpenShift 4.16 und es liegt keine Bestätigung des Administrators vor, enthält die Meldung * Kubernetes 1.29 and therefore OpenShift 4.16 remove several APIs which require admin consideration. Please see https://access.redhat.com/articles/6958395 for details and instructions.. Wenn Sie keinen Zugriff auf ein Red Hat-Konto haben, um die Lösung anzuzeigen, können Sie die folgenden Schritte ausführen, um das Problem als Clusteradministrator zu beheben.

  3. Migrieren Sie alle betroffenen Komponenten, um die entsprechende neue API-Version zu verwenden, einschließlich Tools, Workloads oder anderer Komponenten, die ausgeführt werden oder mit dem Cluster interagieren. Zum Beispiel verwenden Red Hat OpenShift 4.16 Cluster Kubernetes 1.29 und sind mit den gleichen Abwertungen konfrontiert.

  4. Nachdem Sie die entfernten APIs erfolgreich migriert haben, können Sie bestätigen, dass Ihr Cluster für ein Upgrade auf die nächste Version von Red Hat OpenShift bereit ist.

    Clusteradministratoren müssen sicherstellen, dass entfernte APIs nicht mehr verwendet werden und die Migration auf unterstützte APIs abgeschlossen ist, bevor diese Administratorbestätigung bereitgestellt wird. IBM Cloud kann bei der Bewertung helfen, kann jedoch nicht alle möglichen Fälle identifizieren, in denen entfernte APIs verwendet werden, insbesondere in externen Tools und in inaktiven Workloads.

  5. Führen Sie die Schritte zum Bereitstellen der Administratorbestätigung aus, die Sie von den entfernten APIs migriert haben.

  6. Führen Sie nach Abschluss der vorherigen Migrationsschritte den folgenden Befehl erneut aus: Beachten Sie, dass die Aktualisierung des Upgradeable-Status einige Minuten dauern kann. Werden keine Daten zurückgegeben, wurde der Status Upgradeable entfernt und Sie können das Cluster-Upgrade wiederholen.

    oc get clusterversion version -o json | jq '.status.conditions[] | select(.type == "Upgradeable")'