Upravit

Sdílet prostřednictvím

Upgrading Cluster runtime with PauseAfterRack strategy

  • Článek

Executing Cluster runtime upgrade with PauseAfterRack strategy will pause to wait for user confirmation before upgrading the next rack of worker nodes. The complete list of Cluster upgrade settings are discussed in Upgrading Cluster runtime from Azure CLI.

Prerequisites

Note

Upgrade with the PauseAfterRack strategy is available starting API version 2024-07-01.

  1. Install the latest version of the appropriate CLI extensions.
  2. The latest networkcloud CLI extension is required. It can be installed following the steps listed here.
  3. Subscription access to run the Azure Operator Nexus network fabric (NF) and network cloud (NC) CLI extension commands.
  4. Collect the following information:
    • Subscription ID (SUBSCRIPTION)
    • Cluster name (CLUSTER)
    • Resource group (CLUSTER_RG)
  5. Target Cluster must be healthy in a running state, with all control plane nodes healthy.

Procedure

  1. Enable PauseAfterRack upgrade strategy on a Nexus Cluster

    az networkcloud cluster update --name "<CLUSTER>" \
--resource-group "<CLUSTER_RG>" \
--update-strategy strategy-type="PauseAfterRack" wait-time-minutes=0 \
--subscription "<SUBSCRIPTION>"

  2. Confirm that the Cluster resource JSON in the JSON View reflects the PauseAfterRack upgrade strategy.

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

 "updateStrategy": {
   "maxUnavailable": 32767,
   "strategyType": "PauseAfterRack",
   "thresholdType": "PercentSuccess",
   "thresholdValue": 70,
   "waitTimeMinutes": 15,

  3. Trigger runtime bundle upgrade as usual from Azure portal or CLI. See Upgrading Cluster runtime from Azure CLI.

  4. Once the control plane and management plane upgrades complete, the runtime upgrade is paused, awaiting user action to start the upgrade for Rack 1.

Screenshot showing Paused Runtime Upgrade.

Note

This message is available in logs for programmatic access. For more details, follow List of logs available for streaming in Azure Operator Nexus

  1. To resume the runtime upgrade, execute the following az networkcloud cli command.

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

  2. Repeat step 5 for each rack until all racks are upgraded to the latest runtime bundle.

Related content