Clusterruntime upgraden vanuit Azure CLI

In dit artikel wordt uitgelegd hoe u een runtime-upgrade uitvoert voor een Operator Nexus-cluster.

Vereiste voorwaarden

  1. Installeer de nieuwste versie van de juiste CLI-extensies.
  2. Abonnementstoegang om de CLI-extensieopdrachten voor Azure Operator Nexus netwerkfabric (NF) en netwerkcloud (NC) uit te voeren.
  3. Verzamel de volgende informatie:
    • Abonnement-ID (SUBSCRIPTION)
    • Clusternaam (CLUSTER)
    • Resourcegroep (CLUSTER_RG)
  4. De gedetailleerde status van het cluster moet zijn Running.
  5. De connectiviteit van Cluster-to-Cluster Manager moet Connected zijn.
  6. Azure vereisten (Log Analytics-werkruimte, Storage-account, Key Vault) moeten worden gevalideerd. Deze resources worden gecontroleerd voordat de upgrade begint. Zie Door de cluster beheerde identiteit en door de gebruiker verstrekte resources.
  7. Onder cluster-werkbelastingen rekenservers >>
    • Statusvereisten voor besturingsvlakknooppunten vóór de upgrade zijn:
      • Als er geen reserveknooppunt voor het besturingsvlak bestaat, moeten alle besturingsvlakknooppunten in orde zijn: Energiestatus On, Cordon-status Uncordoned, Status gereed Yesen Gedegradeerd No.
      • Als er een reserve-control-plane-knooppunt bestaat, kan alleen het reserveknooppunt de energiestatus Off, de status Gereed No en Gedegradeerd No hebben. Elk ander knooppunt van het besturingsvlak moet in orde zijn: Energiestatus On, Cordon-status Uncordoned, Status Gereed Yesen Gedegradeerd No.

      Opmerking

      Als de reservebesturingsvlakmachine eerder een inrichtingsproces heeft doorlopen, wordt verwacht dat deze de cordon-status Cordonedheeft. Als dat niet het geval is, moet deze de Cordon-status Uncordonedhebben.

    • De servers van het beheervlak worden onderverdeeld in twee groepen op oneven en even genummerde rekken. In elke groep moeten ten minste 50% van de servers in orde zijn: Energiestatus On, Cordon-status Uncordoned, Status Gereed Yesen Gedegradeerd No.
      • In beide beheervlakgroepen moeten ten minste 75% van de beheermachines in orde zijn.
    • De servernummers van het rekenvlak variëren op basis van de drempelwaarde-instellingen voor afzonderlijke clusterruntime. Klanten moeten hun minimumaantal bepalen op basis van hun instellingen, op zoek naar Energiestatus On, Cordon-status Uncordoned, Status Gereed Yesen Gedegradeerd No.
  8. Selecteer in de Cluster Beheerde Resourcegroep > de naam van de groep om naar de pagina van de Resourcegroep te gaan.
    • Zoek in de resourcegroep naar Kubernetes - Azure Arc om de Azure Arc gegevens te identificeren en selecteer deze. De status moet zijn Connected.
      • Selecteer op de pagina Azure Arc Instellingen > Extensies.
        • nc-platform-extension moet de status Succeededhebben.
        • nc-platform-runtime-extension moet de status Succeededhebben.

Opmerking

Dezelfde controles moeten ook worden uitgevoerd na de upgrade om ervoor te zorgen dat het cluster in orde is.

Huidige runtimeversie controleren

Controleer de huidige versie van de clusterruntime vóór de upgrade: Zie Hoe u de huidige versie van de clusterruntime controleert.

Beschikbare runtimeversies zoeken

Via de Azure-portal

Als u beschikbare upgradebare runtimeversies wilt vinden, gaat u naar het doelcluster in de Azure portal. Navigeer in het overzichtsvenster van het cluster naar het tabblad Beschikbare upgradeversies .

Schermafbeelding van Azure portal met het juiste tabblad om beschikbare clusterupgrades te identificeren.

Op het tabblad Beschikbare upgradeversies ziet u de verschillende clusterversies die beschikbaar zijn om te upgraden. Selecteer de doelruntimeversie in de lijst en ga vervolgens verder met het upgraden van het cluster.

Schermafbeelding van Azure portal met beschikbare clusterupgrades.

Via Azure CLI

Beschikbare upgrades kunnen worden opgehaald via de Azure CLI:

az networkcloud cluster show --name "<CLUSTER>" \
--resource-group "<CLUSTER_RG>" \
--subscription "<SUBSCRIPTION>" | grep -A8 availableUpgradeVersions

In de uitvoer vindt u de availableUpgradeVersions eigenschap en kijkt u naar het targetClusterVersion veld:

  "availableUpgradeVersions": [
    {
      "controlImpact": "True",
      "expectedDuration": "Upgrades may take up to 4 hours + 2 hours per rack",
      "impactDescription": "Workloads will be disrupted during rack-by-rack upgrade",
      "supportExpiryDate": "2023-07-31",
      "targetClusterVersion": "3.3.0",
      "workloadImpact": "True"
    }
  ],

Als er geen clusterupgrades beschikbaar zijn, is de lijst leeg.

Parameters voor de berekeningsdrempel configureren voor runtime-upgrade met behulp van cluster updateStrategy

De volgende Azure CLI opdracht wordt gebruikt voor het configureren van de parameters voor de berekeningsdrempel voor een runtime-upgrade:

az networkcloud cluster update \
--name "<CLUSTER>" \
--resource-group "<CLUSTER_RG>" \
--subscription "<SUBSCRIPTION>" \
--update-strategy strategy-type="<strategyType>" threshold-type="<thresholdType>" \
threshold-value="<thresholdValue>" max-unavailable="<maxNodesOffline>" \
wait-time-minutes="<waitTimeBetweenRacks>"

Vereiste parameters:

  • strategietype: Definieert de updatestrategie. De gebruikte instellingen zijn Rack (Rack-by-Rack) OF PauseAfterRack (Onderbreken voor gebruiker voordat elk rack wordt gestart). De standaardwaarde is Rack. Als u een upgrade van de clusterruntime wilt uitvoeren met behulp van de PauseAfterRack strategie, volgt u de stappen die worden beschreven in Upgrade Cluster Runtime met PauseAfterRack-strategie.
  • drempeltype: bepaalt hoe de drempelwaarde moet worden geëvalueerd, toegepast in de eenheden die door de strategie zijn gedefinieerd. De gebruikte instellingen zijn PercentSuccess OF CountSuccess. De standaardwaarde is PercentSuccess.
  • drempelwaarde: de numerieke drempelwaarde die wordt gebruikt om een update te evalueren. De standaardwaarde is 80.

Optionele parameters:

  • maximaal niet beschikbaar: het maximum aantal werkknooppunten dat offline kan zijn, oftewel, een rek dat wordt geüpgraded tegelijk. De standaardwaarde is 32767.
  • wachttijd-minuten: de vertraging of wachttijd voordat een rek wordt bijgewerkt. De standaardwaarde is 15.

Upgradegedrag op basis van het drempelwaardetype PercentSuccess

Het volgende voorbeeld is voor een klant die rack-by-rack-strategie gebruikt met een percentage succes van 60% en een pauze van 1 minuut.

az networkcloud cluster update --name "<CLUSTER>" \
--resource-group "<CLUSTER_RG>" \
--update-strategy strategy-type="Rack" threshold-type="PercentSuccess" \
threshold-value=60 wait-time-minutes=1 \
--subscription "<SUBSCRIPTION>"

Update controleren:

az networkcloud cluster show --name "<CLUSTER>" \
--resource-group "<CLUSTER_RG>" \
--subscription "<SUBSCRIPTION>" | grep -A5 updateStrategy

  "updateStrategy": {
    "maxUnavailable": 32767,
      "strategyType": "Rack",
      "thresholdType": "PercentSuccess",
      "thresholdValue": 60,
      "waitTimeMinutes": 1

In dit voorbeeld, zodra 60% van de machines in een rek met succes zijn geüpgraded, beschouwt het systeem de drempel als bereikt en gaat verder met het upgraden van het volgende rek, terwijl de resterende machines in het huidige rek blijven worden ingericht. Als niet aan de drempelwaarde wordt voldaan, wat betekent dat minder dan 60% van de machines in het rek een upgrade konden uitvoeren en in plaats daarvan is mislukt, wordt de clusterupgrade onderbroken. Wanneer een upgrade is onderbroken, geeft het systeem een gedetailleerd statusbericht op het cluster waarin de reden wordt uitgelegd. Op dat moment moeten de probleemmachines in het rek worden gerepareerd en moet een continue-update-versie operatie van het cluster worden uitgevoerd om de upgrade te hervatten en te voltooien.

Als u de upgradestatus wilt weergeven via de Azure portal, gaat u naar de doelclusterresource. In het scherm Overzicht van het cluster wordt de gedetailleerde status weergegeven, samen met een gedetailleerd statusbericht.

De clusterupgrade wordt uitgevoerd wanneer detailedStatus is ingesteld op Updating en detailedStatusMessage geeft de voortgang van de upgrade weer. Enkele voorbeelden van de voortgang van de upgrade die wordt weergegeven in detailedStatusMessage zijn Waiting for control plane upgrade to complete..., Waiting for nodepool "<rack-id>" to finish upgrading...enzovoort.

De clusterupgrade is voltooid wanneer detailedStatus is ingesteld op Running en detailedStatusMessage bericht weergeeft Cluster is up and running

Als in het gedetailleerde statusbericht wordt aangegeven dat de upgrade is onderbroken, ziet het bericht er als volgt uit: Cluster is deployed but the upgrade has been paused. Machines in rack "<rack-id>" are unhealthy. Fix the machines and perform cluster continue-update-version action to finish the upgrade

Schermopname van Azure portal met de clusterupgrade onderbroken.

Als u de runtime-upgrade wilt hervatten, voert u de volgende az networkcloud cli-opdracht uit.

az networkcloud cluster continue-update-version --cluster-name "<CLUSTER>" \
--resource-group="<CLUSTER_RG>" \
--subscription="<SUBSCRIPTION>" \
--safeguard-mode <SAFEGUARD_MODE>

Optionele parameters:

  • --safeguard-mode: Hiermee geeft u op hoe beveiligingen worden toegepast tijdens de bewerking continue update-versie. Gebruik All om alle validatiecontroles vóór de bewerking uit te voeren. Gebruik None dit om beveiligingen te omzeilen die de upgrade blokkeren wanneer ze problemen detecteren. De standaardwaarde is All.

Belangrijk

De standaardbeveiligingsmodus All blokkeert dat de upgrade wordt hervat als validaties bepalen dat de upgrade niet kan worden voltooid zonder de gedetecteerde problemen op te lossen. Zie Preflight-validaties voor clusterruntime-upgrades voor meer informatie.

Upgradengedrag op basis van het drempelwaardetype CountSuccess

Het volgende voorbeeld is voor een klant die rack-by-rack-strategie gebruikt met een drempelwaarde van CountSuccess 10 knooppunten per rek en een pauze van 1 minuut.

az networkcloud cluster update --name "<CLUSTER>" \
--resource-group "<CLUSTER_RG>" \
--update-strategy strategy-type="Rack" threshold-type="CountSuccess" \
threshold-value=10 wait-time-minutes=1 \
--subscription "<SUBSCRIPTION>"

Update controleren:

az networkcloud cluster show --name "<CLUSTER>" \
--resource-group "<CLUSTER_RG>" \
--subscription "<SUBSCRIPTION>" | grep -A5 updateStrategy

  "updateStrategy": {
    "maxUnavailable": 32767,
      "strategyType": "Rack",
      "thresholdType": "CountSuccess",
      "thresholdValue": 10,
      "waitTimeMinutes": 1

Wanneer in dit voorbeeld ten minste 10 knooppunten zijn bijgewerkt, gaat de upgrade verder naar het volgende rek, terwijl eventuele resterende machines in het huidige rek worden ingericht. Als ten minste 10 machines in het rek niet kunnen worden bijgewerkt, wordt de upgrade van het cluster onderbroken. Wanneer dit gebeurt, moet de vereiste hardware worden hersteld voordat de actie voor de continue updateversie wordt uitgevoerd om de upgrade te hervatten en te voltooien.

Raadpleeg Troubleshoot Azure Operator Nexus serverproblemen voor het oplossen van problemen met bare-metalcomputers.

Opmerking

U kunt deze niet wijzigen update-strategy nadat de upgrade van de clusterruntime is gestart.

Validaties die de upgrade van de clusterruntime kunnen blokkeren

Wanneer u een upgrade van de clusterruntime activeert, wordt tijdens het proces een reeks preupgrade-validaties uitgevoerd voordat de runtime-upgrade op de bare-metalcomputers van het cluster wordt gestart. Deze validaties bevestigen dat de runtime-upgrade kan slagen op basis van de huidige status van het cluster. Zie Preflight-validaties voor clusterruntime-upgrades voor meer informatie.

Clusterruntime upgraden met CLI

Gebruik de volgende Azure CLI opdracht om de runtimeversie van het cluster bij te werken:

az networkcloud cluster update-version\
--cluster-name "<CLUSTER>" \
--resource-group "<CLUSTER_RG>" \
--subscription "<SUBSCRIPTION>" \
--target-cluster-version "<versionNumber>" \
--safeguard-mode "<SAFEGUARD_MODE>"

Vereiste parameters:

  • --target-cluster-version: De versie die moet worden toegepast op het cluster tijdens de update.

Optionele parameters:

  • --safeguard-mode: Hiermee geeft u op hoe beveiligingen worden toegepast tijdens de updateversiebewerking. Gebruik All om alle validatiecontroles vóór de bewerking uit te voeren. Gebruik None dit om beveiligingen te omzeilen die de upgrade blokkeren wanneer ze problemen detecteren. De standaardwaarde is All.

Belangrijk

De standaardbeveiligingsmodus All blokkeert het starten van de upgrade van het besturingssysteem en extensies als de validaties bepalen dat de upgrade niet kan worden voltooid zonder de gedetecteerde problemen op te lossen. Zie Preflight-validaties voor clusterruntime-upgrades voor meer informatie.

Met deze opdracht wordt het runtime-upgradeproces voor het opgegeven cluster gestart. De opdracht zelf wordt doorgaans binnen ongeveer vijf minuten voltooid, maar het upgradeproces wordt pas gestart zodra de validaties zijn geslaagd. De werkelijke runtime-upgrade wordt nog steeds op de achtergrond uitgevoerd en kan enkele uren duren, omdat het knooppuntenrek per rek upgradet en de nieuwe versie van het besturingssysteem installeert.

Gedetailleerde status- en diagnostische informatie voor de startstap is beschikbaar in Azure portal in de JSON View van de clusterresource (Operator Nexus). De volgende informatie wordt opgenomen in de updateVersion vermelding van het properties.actionStates veld wanneer u API-versie 2025-07-01-preview of hoger gebruikt.

  • Begin- en eindtijd van de actie.
  • Huidige status (Succeeded, Failed, of InProgress).
  • Eventuele extra context of foutberichten die zijn gekoppeld aan de huidige status.
  • De correlatie-id voor de oorspronkelijke bewerking cluster update-version, zoals ook wordt weergegeven in het Azure activiteitenlogboek.
  • Een geordende lijst met afzonderlijke stappen en hun status, bijvoorbeeld Validate Cluster conditions and upgrade versions, en Initiate Platform Runtime Extension update.

Belangrijk

De properties.actionStates vermelding voor updateVersion geeft alleen de korte startfase weer (validatie en aanvraaginitiatie die doorgaans in ongeveer 5 minuten is voltooid). De voortgang van de hoofdupgrade per rack wordt niet bijgehouden. Als u de volledige upgrade wilt bewaken, gebruikt u de gedetailleerde status en het gedetailleerde statusbericht van het cluster in het resourceoverzicht of voert u een query uit via az networkcloud cluster show.

Voorbeelduitvoer JSON View voor de clusterresource (Operator Nexus):

{
  "properties": {
    "actionStates": [
      {
        "correlationId": "aaaa0000-bb11-2222-33cc-444444dddddd",
        "status": "Completed",
        "actionType": "Microsoft.NetworkCloud/clusters/updateVersion",
        "endTime": "2025-08-01T03:46:13Z",
        "message": "Cluster upgrade to 4.6.0 successfully initiated - monitor progress via cluster detailed status",
        "startTime": "2025-08-01T03:42:08Z",
        "stepStates": [
          {
            "status": "Completed",
            "endTime": "2025-08-01T03:42:08Z",
            "message": "Cluster validation and version checks passed",
            "startTime": "2025-08-01T03:42:08Z",
            "stepName": "Validate Cluster conditions and upgrade versions"
          },
          {
            "status": "Completed",
            "endTime": "2025-08-01T03:46:11Z",
            "message": "Platform Runtime Extension deployment initiated",
            "startTime": "2025-08-01T03:42:39Z",
            "stepName": "Initiate Platform Runtime Extension update"
          },
          {
            "status": "Completed",
            "endTime": "2025-08-01T03:46:11Z",
            "message": "Platform Runtime Extension installation completed",
            "startTime": "2025-08-01T03:46:11Z",
            "stepName": "Monitor Platform Runtime Extension readiness"
          },
          {
            "status": "Completed",
            "endTime": "2025-08-01T03:46:13Z",
            "message": "Platform Cluster version updated successfully",
            "startTime": "2025-08-01T03:46:13Z",
            "stepName": "Update Platform Cluster version specification"
          }
        ]
      }
    ]
  }
}

Wanneer deze opdracht is voltooid, wordt het volledige runtime-upgradeproces gestart. Dit proces kan enkele uren duren, afhankelijk van het aantal rekken in het cluster en het aantal werkknooppunten in elk rek.

  • Met de upgrade worden eerst de besturingsvlakknooppunten bijgewerkt, vervolgens beheerknooppunten en vervolgens sequentieel rek per rek voor de werkknooppunten.
  • De beheerservers worden gescheiden in twee groepen, die afzonderlijk worden bijgewerkt. Met deze aanpak kunnen onderdelen die op de beheerservers worden uitgevoerd, tolerantie garanderen tijdens de runtime-upgrade door affiniteitsregels toe te passen.
  • De cloudservicenetwerken (CSN's) gebruiken deze functionaliteit ook door één exemplaar in elke beheergroep te plaatsen.
  • Er is geen klantinteractie met deze functionaliteit. Er zijn echter mogelijk andere labels op beheerknooppunten om de groepen te identificeren.

De upgrade wordt beschouwd als voltooid wanneer aan de drempelwaarden voor werkknooppuntrekken van het cluster updateStrategy wordt voldaan en ten minste 50% beheerknooppunten in elke groep worden bijgewerkt. Werkbelastingen kunnen worden beïnvloed terwijl de werkknooppunten in een rek worden bijgewerkt, maar workloads in alle andere rekken worden niet beïnvloed. Het wordt aangemoedigd om rekening te houden met de plaatsing van workloads met het oog op dit implementatieontwerp.

Bewaak de voortgang met behulp van de gedetailleerde status van het cluster, beschikbaar via de Azure-portal of Azure CLI.

Gebruik az networkcloud cluster show om de upgradestatus via de Azure CLI weer te geven.

az networkcloud cluster show --cluster-name "<CLUSTER>" \
--resource-group "<CLUSTER_RG>" \
--subscription "<SUBSCRIPTION>"

De uitvoer bevat de informatie van het doelcluster, samen met de gedetailleerde status en het gedetailleerde statusbericht. Voor gedetailleerdere inzichten over de voortgang van de upgrade kunnen de afzonderlijke knooppunten in elk rek worden gecontroleerd op status. Een voorbeeld vindt u in de naslagsectie onder BareMetal Machine-rollen.

Als u de upgradestatus wilt weergeven via de Azure-portal, gaat u naar de doelclusterresource. In het scherm Overzicht van het cluster kunt u de gedetailleerde status weergeven, samen met een gedetailleerd statusbericht.

De upgrade van het cluster is bezig wanneer detailedStatus is ingesteld op Updating en detailedStatusMessage de voortgang van de upgrade toont. Enkele voorbeelden van de upgradevoortgang die wordt weergegeven in detailedStatusMessage, zijn Waiting for control plane upgrade to complete... en Waiting for nodepool "<rack-id>" to finish upgrading....

De clusterupgrade is voltooid wanneer detailedStatus is ingesteld op Running en detailedStatusMessage wordt weergegeven als Cluster is up and running.

Schermafbeelding van de Azure portal waarop een clusterupgrade bezig is.

De upgrade van het cluster wordt gepauzeerd wanneer detailedStatus is ingesteld op Updating en detailedStatusMessage de reden of het onderdeel weergeeft waardoor de upgrade is gepauzeerd.

Gepauzeerde upgrade van cluster-runtime

De upgrade wordt onderbroken wanneer een van de volgende handelingen plaatsvindt:

  1. Alle machines in het control plane kunnen niet met succes worden bijgewerkt en zijn niet ingericht en gereed.
  2. Meer dan 50% van de machines in een groep in het beheervlak kunnen niet worden geüpgraded en zijn niet geprovisioneerd en gereed. De servers van het beheervlak worden onderverdeeld in twee groepen op oneven en even genummerde rekken.
  3. Machines voor reken- of werkknooppunten die zijn geconfigureerd per drempelwaarde, kunnen niet worden bijgewerkt en zijn niet ingericht en gereed.

Opmerking

Als er een reserve-control plane aanwezig is, is het normaal dat de reserve-control plane de voedingsstatus off, de gereedstatus No, de gedegradeerde status No en de status Gedetailleerde status Available heeft. De clusterupgrade wordt alleen onderbroken wanneer het upgradeproces bepaalt dat niet aan de bovenstaande voorwaarden kan worden voldaan. Een reserve-control plane die de status Beschikbaar heeft (niet Gereed), zorgt er op zichzelf niet voor dat de upgrade wordt gepauzeerd.

Bekijk het gedetailleerde statusbericht van het cluster om te bepalen welk onderdeel ervoor heeft gezorgd dat de upgrade in een gepauzeerde status terechtkwam. In de onderstaande voorbeelden ziet u gedetailleerde statusberichten voor elk onderdeel.

Gedetailleerd statusbericht van een storing in het besturingsvlak (KCP)

  • Cluster is uitgerold, maar de upgrade is gepauzeerd. De upgrade van het besturingsvlak is mislukt omdat capiCluster <clusterName> ongezond is. MachineHealthCheck wisselt mogelijk beschadigde KCP-machines met Management Plane-machines om quorum te herstellen. Wacht tot het herstel is voltooid en voer vervolgens de actie continue updateversie uit om de upgrade te voltooien.

Gedetailleerd statusbericht voor fout in reken- of beheervlakgroep

  • Cluster is uitgerold, maar de upgrade is gepauzeerd. Machines in rack "<rack-id>" zijn ongezond. Corrigeer de machines en voer de actie continue updateversie van het cluster uit om de upgrade te voltooien.

Opmerking

Wanneer een control plane-machine niet kan worden geprovisioneerd en de upgrade wordt gepauzeerd, kunnen de machines op de achtergrond automatisch worden hersteld. Controleer de actionStates bare-metalcomputers van het betrokken besturingsvlak om te zien of automatisch herstel het probleem heeft opgelost en de machines in een ingerichte status hebben gebracht.

Zodra het betrokken onderdeel (besturingsvlak, beheer of berekening) is geïdentificeerd, gaat u als volgt te werk:

Stap 1: Controleer de status van afzonderlijke bare-metalmachines voor het betreffende onderdeel.

Een voorbeeld vindt u in de naslagsectie onder BareMetal Machine-rollen.

Nadat u de bare-metalmachines voor het betreffende onderdeel hebt geïdentificeerd, controleert u de status van elke machine en voert u de volgende acties uit op basis van de status.

Gedetailleerde status van de bare-metalmachine Knooppunt gereed Details en beperkende maatregelen
Deprovisioning No Bekijk TSR-logboeken. En volg de volgende stappen om de actielogboeken voor de BMM te controleren
Available No Als de BMM een reservebesturingsvlakmachine is, Available is de verwachte status. Controleer anders de logboeken van de actiestatus.
Provisioning No Bekijk TSR-logboeken. En volg de volgende stappen om de actielogboeken voor de BMM te controleren
Provisioned No Controleer cloud-init-logboeken in Shoebox.
Provisioned Yes Dit is de verwachte gezonde status. Ga door met het hervatten van de upgrade met behulp van de actie 'cluster continue-update-version'

Stap 2: Controleer de actiestatuslogboeken voor de BMM.

Als u de actiestatuslogboeken voor een BMM wilt controleren, gaat u naar het> van de BMM-resourcebewerkingen>.

Details van actielogboek Mitigation
Er bestaat geen actielogboek Los problemen op met behulp van de gids voor probleemoplossing voor Bare Metal-machines .
machineHealthCheckRemediation actie wordt uitgevoerd Wacht totdat het herstel is voltooid. Als dit mislukt, lost u problemen op met behulp van de gids voor probleemoplossing van Bare Metal-machines.
machineHealthCheckRemediation voltooide actie Als het knooppunt niet gereed is, controleer de cloud-init-logboeken in Shoebox.

Zodra het probleem is opgelost en de Baremetal-machine is ingericht en gereed is, voert u de clusteractie continue-update-version uit om de upgrade te hervatten en te voltooien.

az networkcloud cluster continue-update-version \
-g <CLUSTER_RG> \
-n <CLUSTER_NAME> \
--subscription <CUSTOMER_SUB_ID> \
--safeguard-mode <SAFEGUARD_MODE>

Optionele parameters:

  • --safeguard-mode: Hiermee geeft u op hoe beveiligingen worden toegepast tijdens de bewerking continue update-versie. Gebruik All om alle validatiecontroles vóór de bewerking uit te voeren. Gebruik None dit om beveiligingen te omzeilen die de upgrade blokkeren wanneer ze problemen detecteren. De standaardwaarde is All.

Belangrijk

De standaardbeveiligingsmodus All blokkeert dat de upgrade wordt hervat als validaties bepalen dat de upgrade niet kan worden voltooid zonder de gedetecteerde problemen op te lossen. Zie Preflight-validaties voor clusterruntime-upgrades voor meer informatie.

Belangrijk

Als u continue-update-version uitvoert voordat de drempelwaarde voor werkknooppunten is bereikt (zoals geconfigureerd in het cluster updateStrategy), wordt de upgrade teruggezet naar een onderbroken status. Herstel altijd eerst de betreffende machines en voer vervolgens de continue-update-version actie uit.

Veelgestelde vragen

Identificeren van vastgelopen clusterupgrade

Tijdens een runtime-upgrade voert het cluster een onderbroken status in zodra het upgradeproces bepaalt dat de upgrade niet kan worden voortgezet zonder handmatige tussenkomst. Het upgradeproces kan echter soms vastlopen, terwijl de gedetailleerde status nog steeds aangeeft dat de upgrade nog bezig is. Omdat het lang kan duren voordat de runtime-upgrade is voltooid, is er momenteel geen time-outlengte ingesteld. Controleer regelmatig de gedetailleerde status en logboeken van uw cluster om te bepalen of uw upgrade voor onbepaalde tijd een upgrade probeert uit te voeren.

U kunt een upgrade die voor onbepaalde tijd is vastgelopen identificeren door de logboeken, het gedetailleerde bericht en het gedetailleerde statusbericht van het cluster te bekijken. Als deze situatie zich voordoet, zult u zien dat het cluster dezelfde toestand voortdurend blijft reconciliëren zonder voortgang te boeken. Controleer de clusterlogboeken of geconfigureerd Log Analytics Workspace (LAW) om te zien of er een fout is of een specifieke stap die het gebrek aan voortgang veroorzaakt.

Identificeren van vastgelopen of vastzittende upgrade van bare-metalserver.

Een handleiding voor het identificeren van problemen bij het inrichten van werkknooppunten vindt u in Troubleshooting Bare Metal Machine Provisioning.

Voor hardwarefouten is geen heruitvoering van de upgrade vereist

Als er een hardwarefout optreedt tijdens een upgrade, wordt de runtime-upgrade voortgezet zolang aan de ingestelde drempelwaarden wordt voldaan voor de reken- en beheer-/beheerknooppunten. Zodra de machine is hersteld of vervangen, wordt deze ingericht met het besturingssysteem van de huidige platformruntime, dat de doelversie van de runtime bevat. Als een rek vóór een fout is bijgewerkt, wordt de bijgewerkte runtime-versie gebruikt wanneer de knooppunten opnieuw worden geprovisioneerd. Als de specificatie van het rek vóór de hardwarefout niet is bijgewerkt naar de bijgewerkte runtimeversie, wordt de machine voorzien van de vorige runtimeversie wanneer de hardware wordt hersteld. De machine wordt samen met het rek bijgewerkt wanneer het rek de upgrade start.

Na een runtime-upgrade toont het cluster de provisioningstatus "Mislukt"

Tijdens een runtime-upgrade voert het cluster een status in van Upgrading. Als de runtime-upgrade mislukt, treedt het cluster in een Failed inrichtingsstatus op. Infrastructuuronderdelen (bijvoorbeeld het opslagapparaat) kunnen fouten veroorzaken tijdens de upgrade. In sommige scenario's kan het nodig zijn om de fout te diagnosticeren met Microsoft ondersteuning.

Bare Metal Machine toont 'Degraded' na een runtime-update

Bepaalde situaties kunnen ertoe leiden dat een knooppunt in de toestand Degraded terechtkomt. Deze status treedt op als aan een van de voorwaarden in Problemen met fouten met de gedegradeerde status oplossen is voldaan. Gedegradeerde status betekent dat het knooppunt automatisch wordt vastgezet om te voorkomen dat nieuwe workloads worden gepland op het knooppunt totdat het onderliggende probleem is opgelost.