Uppgradera ett kluster med hanterade identiteter aktiverade (förhandsversion)

Den här artikeln visar hur du uppgraderar ett Azure Red Hat OpenShift-kluster med hanterade identiteter aktiverade med hjälp av OpenShift-webbkonsolen eller MUO (managed-upgrade-operator).

Som en del av Azure Red Hat OpenShift-klusterlivscykeln måste du utföra regelbundna uppgraderingar till den senaste versionen av OpenShift-plattformen. Genom att uppgradera dina Azure Red Hat OpenShift-kluster kan du hämta de senaste funktionerna och tillämpa de senaste säkerhetsversionerna.

Förutsättningar

Innan du börjar kontrollerar du att du uppfyller följande krav för att kunna uppgradera ett kluster.

• Du kör Azure CLI version 2.67.0 eller senare. Kör az --version för att hitta din nuvarande version. Om du behöver installera eller uppgradera Azure CLI kan du läsa Installera Azure CLI.
• Du har åtkomst till ett befintligt Azure Red Hat OpenShift-kluster som användare med administratörsbehörighet.
• Du har uppdaterat din Azure Red Hat OpenShift-pullhemlighet för ett befintligt Azure Red Hat OpenShift 4.x-kluster, inklusive posten cloud.openshift.com från pull-hemligheten gör att klustret kan börja skicka telemetridata till Red Hat.
  Mer information finns i Lägga till eller uppdatera din Red Hat-pullhemlighet i ett Azure Red Hat OpenShift 4-kluster.
• Kontrollera att de federerade identitetsautentiseringsuppgifterna som används av klustrets hanterade identiteter är giltiga/uppdaterade innan du påbörjar uppgraderingen. Mer information finns i Stämma av federerade identitetsuppgifter för ditt Azure Red Hat OpenShift-kluster med hanterade identiteter aktiverade (förhandsversion).

Ladda ned Fil för Azure Red Hat OpenShift-tilläggshjul (endast förhandsversion)

Om du vill köra kommandona i den här artikeln måste du ladda ned hjulfilen från https://aka.ms/az-aroext-latest. Kör följande kommando för att installera tillägget:

az extension add -s <path to downloaded whl file>

Ange annotationen 'upgradeable-to' på Azure Red Hat OpenShift-klustrets CloudCredential-resurs

Innan du kan uppgradera ett Azure Red Hat OpenShift-kluster med hanterad identitet aktiverad anger du anteckningen upgradeable-to på klustrets CloudCredential resurs med kommandot az aro update :

az aro update --name <CLUSTER_NAME> --resource-group <RESOURCE_GROUP> --upgradeable-to <VERSION>

Var:

• --name är namnet på klustret
• --resource-group är namnet på nätverksresursgruppen. Du kan konfigurera standardgruppen med hjälp av az-config --defaults group=<name>.
• --upgradeable-to är det OpenShift-versionsnummer som du tänker uppgradera till, som anges i formatet x.y.z

För mer information om anteckningen om uppgraderingsbarhet, se Förbereda uppdatering av ett kluster.

Sök efter Azure Red Hat OpenShift-klusteruppgraderingar med hjälp av webbkonsolen

1. I den vänstra navigeringsmenyn i OpenShift-webbkonsolen (standardinställningen när du loggar in som kubeadmin) väljer du fliken Administration .
2. Välj Klusterinställningar och öppna fliken Information . Du bör se version, uppdateringsstatus och kanal. Kanalen är inte konfigurerad som standard.
3. Välj länken Kanal och ange önskad uppdateringskanal i kommandotolken, till exempel stable-4.16. När den önskade kanalen har valts visas ett diagram som visar tillgängliga versioner och kanaler. Om uppdateringsstatusen för klustret visar Tillgängliga uppdateringar kan du uppdatera klustret.

Uppgradera ditt Azure Red Hat OpenShift-kluster med OpenShift-webbkonsolen

Från OpenShift-webbkonsolen i föregående steg anger du kanalen enligt den version som du vill uppdatera till, till exempel stable-4.16. Mer information finns i Uppdatera kanaler.

Välj en version att uppdatera till och välj Uppdatera. Du ser att uppdateringsstatusen ändras till:
Update to <product-version> in progress. Du kan granska förloppet för klusteruppdateringen genom att titta på förloppsstaplarna för operatorerna och noderna.

Schemalägg enskilda uppgraderingar genom operatorn managed-upgrade-operator

Använd den hanterade uppgraderingsoperatorn (MUO) för att uppgradera ditt Azure Red Hat OpenShift-kluster.

MUO hanterar automatiserade klusteruppgraderingar. MUO startar klusteruppgraderingen, men den utför inte några aktiviteter i själva klusteruppgraderingsprocessen. OpenShift Container Platform (OCP) ansvarar för att uppgradera klustren. Målet med MUO är att uppfylla de driftförhållanden som ett hanterat kluster måste innehålla, både före och efter att klusteruppgradering har påbörjats.

1. Förbered konfigurationsfilen, som du ser i följande exempel för uppgradering till OpenShift 4.16.

   apiVersion: upgrade.managed.openshift.io/v1alpha1
   kind: UpgradeConfig
   metadata:
     name: managed-upgrade-config
     namespace: openshift-managed-upgrade-operator
   spec:
     type: "ARO"
     upgradeAt: "2025-04-08T03:20:00Z"
     PDBForceDrainTimeout: 60
     desired:
       channel: "stable-4.16"
       version: "4.16.37"
   

   Var:

   • channel är den kanal som konfigurationsfilen hämtar från, enligt livscykelpolicyn.
   • version är den version som du vill uppgradera till, till exempel 4.16.37.
   • upgradeAT är den tid då uppgraderingen äger rum.

2. Använd konfigurationsfilen:

   $ oc create -f <file_name>.yaml
   

Nästa steg

• Lär dig hur du uppgraderar ett Azure Red Hat OpenShift-kluster med hjälp av OC CLI.
• Du hittar information om tillgängliga OpenShift Container Platform-rekommendationer och uppdateringar i avsnittet errata i kundportalen.