Zelfstudie: Een AKS-cluster (Azure Kubernetes Service) upgraden

Als u Azure CLI gebruikt, is voor deze zelfstudie Versie 2.34.1 of hoger van Azure CLI vereist. Voer az --version uit om de versie te vinden. Als u Azure CLI wilt installeren of upgraden, raadpleegt u Azure CLI installeren.

Als u Azure PowerShell gebruikt, is voor deze zelfstudie Azure PowerShell versie 5.9.0 of hoger vereist. Voer Get-InstalledModule -Name Az uit om de versie te vinden. Als u PowerShell wilt installeren of upgraden, raadpleegt u De Azure PowerShell installeren.

Beschikbare clusterversies ophalen met behulp van de Azure CLI

Voordat u een upgrade uitvoert, controleert u met behulp van de az aks get-upgrades opdracht welke Kubernetes-releases beschikbaar zijn voor uw cluster.

az aks get-upgrades --resource-group myResourceGroup --name myAKSCluster

In de volgende voorbeelduitvoer ziet u de huidige versie van een cluster en ziet u een lijst met nieuwere versies onder upgrades:

  {
    "agentPoolProfiles": null,
    "controlPlaneProfile": {
      "kubernetesVersion": "1.33.7",
      ...
      "upgrades": [
        {
          "isPreview": null,
          "kubernetesVersion": "1.34.10"
        },
        {
          "isPreview": null,
          "kubernetesVersion": "1.34.9"
        }
      ]
    },
    ...
  }

Beschikbare clusterversies ophalen met behulp van Azure PowerShell

1. Voordat u een upgrade uitvoert, controleert u de huidige Kubernetes-versie en -regio van uw cluster met behulp van de Get-AzAksCluster cmdlet.

   Get-AzAksCluster -ResourceGroupName myResourceGroup -Name myAKSCluster |
     Select-Object -Property Name, CurrentKubernetesVersion, Location
   

   In de volgende voorbeelduitvoer ziet u de huidige versie en locatie van het cluster:

   Name              CurrentKubernetesVersion      Location
   ----              ------------------------      --------
   myAKSCluster      1.33.7                        westus2
   

2. Vermeld de Kubernetes-releases die beschikbaar zijn in de regio waarin uw cluster zich bevindt met behulp van de Get-AzAksVersion cmdlet.

   Get-AzAksVersion -Location westus2 | Where-Object OrchestratorVersion
   

   In de volgende voorbeelduitvoer ziet u de regionale versies onder OrchestratorVersion:

   Default     IsPreview     OrchestratorType     OrchestratorVersion
   -------     ---------     ----------------     -------------------
                             Kubernetes               1.34.10
                             Kubernetes               1.34.9
   True                      Kubernetes               1.33.7
   ...
   

   Als u potentiële upgradedoelen wilt identificeren, vergelijkt u versies hoger dan de huidige versie van uw cluster met de upgraderegels voor Kubernetes-versies. Deze cmdlet vermeldt regionale beschikbaarheid en valideert het upgradepad voor een specifiek cluster niet.

Beschikbare clusterversies ophalen met behulp van de Azure-portal

1. Meld u aan bij het Azure-portaal.

2. Navigeer naar uw AKS-clusterresource.

3. Selecteer Upgrades in het servicemenu onder Instellingen.

4. Bij Kubernetes-versie selecteer Upgradeversie.

   

5. Op de pagina Upgrade Kubernetes-versie selecteert u de vervolgkeuzelijst Kubernetes-versie om beschikbare Kubernetes-versies voor upgrade te bekijken.

   

Als er geen upgrades beschikbaar zijn, bevindt uw cluster zich mogelijk al in de meest recente beschikbare versie of bevindt de clusterversie zich mogelijk buiten het ondersteuningsvenster. Als de versie niet wordt ondersteund en AKS geen herstelupgrade biedt, maakt u een nieuw cluster met een ondersteunde Kubernetes-versie en migreert u uw workloads. Zie AKS-ondersteuningsbeleid voor Kubernetes-versies voor meer informatie.

Cluster handmatig upgraden met behulp van de Azure CLI

Werk uw cluster bij met behulp van de az aks upgrade opdracht. In dit voorbeeld wordt het cluster bijgewerkt naar versie 1.34.10:

az aks upgrade \
    --resource-group myResourceGroup \
    --name myAKSCluster \
    --kubernetes-version 1.34.10

In de volgende voorbeelduitvoer ziet u het resultaat van de upgrade. De kubernetesVersion waarde komt nu overeen met de versie die is opgegeven in de voorbeeldopdracht:

{
  ...
  "agentPoolProfiles": [
    {
      ...
      "count": 3,
      "currentOrchestratorVersion": "1.34.10",
      "maxPods": 110,
      "name": "nodepool1",
      "nodeImageVersion": "AKSUbuntu-2204gen2containerd-202608.26.0",
      "orchestratorVersion": "1.34.10",
      "osType": "Linux",
      "upgradeSettings": {
        "drainTimeoutInMinutes": null,
        "maxSurge": "10%",
        "nodeSoakDurationInMinutes": null,
        "undrainableNodeBehavior": null
      },
      "vmSize": "Standard_DS2_v2",
      ...
    }
  ],
  ...
  "currentKubernetesVersion": "1.34.10",
  "dnsPrefix": "myAKSClust-myResourceGroup-12ab34",
  "enableRbac": false,
  "fqdn": "myaksclust-myresourcegroup-12ab34-cd56e7fg.hcp.westus2.azmk8s.io",
  "id": "/subscriptions/<Subscription ID>/resourcegroups/myResourceGroup/providers/Microsoft.ContainerService/managedClusters/myAKSCluster",
  "kubernetesVersion": "1.34.10",
  "location": "westus2",
  "name": "myAKSCluster",
  "type": "Microsoft.ContainerService/ManagedClusters"
  ...
}

Cluster handmatig upgraden met behulp van Azure PowerShell

Werk uw cluster bij met behulp van de Set-AzAksCluster cmdlet. In dit voorbeeld wordt het cluster bijgewerkt naar versie 1.34.10:

Set-AzAksCluster -ResourceGroupName myResourceGroup -Name myAKSCluster -KubernetesVersion 1.34.10

In de volgende voorbeelduitvoer ziet u het resultaat van de upgrade. De KubernetesVersion waarde komt nu overeen met de versie die is opgegeven in de voorbeeld-cmdlet:

...
ProvisioningState        : Succeeded
MaxAgentPools            : 100
KubernetesVersion        : 1.34.10
CurrentKubernetesVersion : 1.34.10
...
ResourceGroupName        : myResourceGroup
Name                     : myAKSCluster
Type                     : Microsoft.ContainerService/ManagedClusters
Location                 : westus2
Tags                     :

Cluster handmatig upgraden met behulp van de Azure-portal

1. Navigeer in Azure Portal naar uw AKS-clusterresource.

2. Selecteer Upgrades in het servicemenu onder Instellingen.

3. Bij Kubernetes-versie selecteer Upgradeversie.

   

4. Op de pagina Upgrade Kubernetes-versie selecteert u de vervolgkeuzelijst Kubernetes-versie om beschikbare Kubernetes-versies voor upgrade te bekijken.

   

5. Selecteer de Kubernetes-versie waarnaar u een upgrade wilt uitvoeren en selecteer vervolgens Opslaan.

De duur van de upgrade hangt af van factoren zoals het aantal knooppunten, surge-instellingen, beperkingen voor onderbreking van workloads, de drain-time-out en de soakduur van knooppunten. De standaard time-out voor afvoeren is 30 minuten per knooppunt en kan worden geconfigureerd van vijf minuten tot 24 uur. De inwerktijd van een knooppunt kan 0 tot 30 minuten per knooppunt toevoegen. Zie surge- en onbeschikbaarheidsinstellingen voor nodepools aanpassen voor meer informatie.

Automatische clusterupgrades configureren met behulp van de Azure CLI

Automatische clusterupgrades configureren met Azure PowerShell

Automatische clusterupgrades configureren met behulp van de Azure-portal

Stel op een AKS Standard-cluster het kanaal autoupgrade in met behulp van de az aks update opdracht. In het volgende voorbeeld wordt het stable kanaal gebruikt:

az aks update --resource-group myResourceGroup --name myAKSCluster --auto-upgrade-channel stable

Stel op een AKS Standard-cluster het autoupgradekanaal in met de Set-AzAksCluster-cmdlet. In het volgende voorbeeld wordt het Stable kanaal gebruikt:

Set-AzAksCluster -ResourceGroupName myResourceGroup -Name myAKSCluster -AutoUpgradeChannel Stable

1. Navigeer in Azure Portal naar uw AKS-clusterresource.

2. Selecteer Upgrades in het servicemenu onder Instellingen.

3. Bij Kubernetes-versie selecteer Upgradeversie.

   

4. Voor een AKS Standard-cluster selecteert u op de pagina Kubernetes-versie upgraden de vervolgkeuzelijst Automatische upgrade , selecteert u Ingeschakeld met stabiel en selecteert u Opslaan.

   

Een upgrade valideren met behulp van de Azure CLI

Controleer of de upgrade is geslaagd met behulp van de az aks show opdracht.

az aks show --resource-group myResourceGroup --name myAKSCluster --output table

In de volgende voorbeelduitvoer ziet u dat het AKS-cluster de kubernetes-doelversie uitvoert:

Name          Location    ResourceGroup    KubernetesVersion    CurrentKubernetesVersion  ProvisioningState    Fqdn
------------  ----------  ---------------  -------------------  ------------------------  -------------------  ----------------------------------------------------------------
myAKSCluster  westus2      myResourceGroup  1.34.10              1.34.10                   Succeeded            myaksclust-myresourcegroup-12ab34-cd56e7fg.hcp.westus2.azmk8s.io

Een upgrade valideren met behulp van Azure PowerShell

Controleer of de upgrade is geslaagd met behulp van de Get-AzAksCluster cmdlet.

Get-AzAksCluster -ResourceGroupName myResourceGroup -Name myAKSCluster |
  Select-Object -Property Name, Location, KubernetesVersion, ProvisioningState

In de volgende voorbeelduitvoer ziet u dat het AKS-cluster de kubernetes-doelversie uitvoert:

Name             Location     KubernetesVersion     ProvisioningState
----             --------     -----------------     -----------------
myAKSCluster     westus2       1.34.10               Succeeded

Een upgrade valideren met behulp van de Azure-portal

1. Navigeer in Azure Portal naar uw AKS-clusterresource.
2. Controleer op de pagina Overzicht onder Essentials de Kubernetes-versie om te bevestigen dat de upgrade is geslaagd.

Het cluster verwijderen met behulp van de Azure CLI

Het cluster verwijderen met behulp van Azure PowerShell

Het cluster verwijderen met behulp van de Azure-portal

Verwijder de resourcegroep, containerservice en alle gerelateerde resources met behulp van de az group delete opdracht.

az group delete --name myResourceGroup --yes --no-wait

Verwijder de resourcegroep, containerservice en alle gerelateerde resources met behulp van de Remove-AzResourceGroup cmdlet.

Remove-AzResourceGroup -Name myResourceGroup

1. Navigeer in Azure Portal naar uw AKS-clusterresource.
2. Selecteer Verwijderen op de pagina Overzicht.
3. Selecteer Verwijderen op de verwijderingsbevestigingspagina voor clustert.