Esercitazione: Aggiornare un cluster del servizio Azure Kubernetes

• Prima di eseguire l'aggiornamento, verificare quali versioni di Kubernetes sono disponibili per il cluster usando il comando az aks get-upgrades.

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

  L'output di esempio seguente mostra la versione corrente come 1.28.9 ed elenca le versioni disponibili in upgrades:

    {
      "agentPoolProfiles": null,
      "controlPlaneProfile": {
        "kubernetesVersion": "1.28.9",
        ...
        "upgrades": [
          {
            "isPreview": null,
            "kubernetesVersion": "1.29.4"
          },
          {
            "isPreview": null,
            "kubernetesVersion": "1.29.2"
          }
        ]
      },
      ...
    }
  

1. Prima di eseguire l'aggiornamento, verificare quali versioni di Kubernetes sono disponibili per il cluster e l'area in cui risiede il cluster usando il cmdlet Get-AzAksCluster.

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

   L'output di esempio seguente mostra la versione corrente come 1.28.9 e la posizione come eastus:

   Name              CurrentKubernetesVersion      Location
   ----              ------------------------      --------
   myAKSCluster      1.28.9                        eastus
   

2. Controllare quali versioni di aggiornamento di Kubernetes sono disponibili nell'area in cui risiede il cluster usando il cmdlet Get-AzAksVersion.

   Get-AzAksVersion -Location eastus | Where-Object OrchestratorVersion
   

   L'output di esempio seguente mostra le versioni disponibili in OrchestratorVersion:

   Default     IsPreview     OrchestratorType     OrchestratorVersion
   -------     ---------     ----------------     -------------------
                             Kubernetes               1.29.4
                             Kubernetes               1.29.2
   True                      Kubernetes               1.28.9
                             Kubernetes               1.28.5
   ...
   

1. Accedere al portale di Azure.

2. Passare al cluster del servizio Azure Kubernetes.

3. Dal menu del servizio, in Impostazioni selezionare Configurazione cluster.

4. In versione di Kubernetes, selezionare Aggiorna versione. In questo modo si reindirizza a una nuova pagina.

5. Nella versione di Kubernetesselezionare la versione per verificare la disponibilità degli aggiornamenti.

   

Se non sono disponibili aggiornamenti, creare un nuovo cluster con una versione supportata di Kubernetes ed eseguire la migrazione dei carichi di lavoro dal cluster esistente al nuovo cluster. Non è supportato aggiornare un cluster a una versione più recente di Kubernetes quando non sono disponibili aggiornamenti.

• Aggiornare il cluster usando il comando az aks upgrade.

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

• Verrà richiesto di confermare l'operazione di aggiornamento e di confermare che si vuole aggiornare il piano di controllo e tutti i pool di nodi alla versione selezionata di Kubernetes:

   Are you sure you want to perform this operation? (y/N): y
  Since control-plane-only argument is not specified, this will upgrade the control plane AND all nodepools to version 1.29.2. Continue? (y/N): y
  

  Nota

  È possibile aggiornare solo una versione secondaria per volta. Ad esempio, è possibile eseguire l'aggiornamento da 1.14.x a 1.15.x, ma non è possibile eseguire direttamente l'aggiornamento da 1.14.x a 1.16.x. Per eseguire l'aggiornamento da 1.14.x a 1.16.x, è prima necessario eseguire l'aggiornamento da 1.14.x a 1.15.x, quindi eseguire un altro aggiornamento da 1.15.x a 1.16.x.

  L'output di esempio seguente mostra il risultato dell'aggiornamento a 1.29.2. Si noti che ora kubernetesVersion è 1.29.2:

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

• Aggiornare il cluster usando il Set-AzAksCluster cmdlet .

  Set-AzAksCluster -ResourceGroupName myResourceGroup -Name myAKSCluster -KubernetesVersion <KUBERNETES_VERSION>
  

  Nota

  È possibile aggiornare solo una versione secondaria per volta. Ad esempio, è possibile eseguire l'aggiornamento da 1.14.x a 1.15.x, ma non è possibile eseguire direttamente l'aggiornamento da 1.14.x a 1.16.x. Per eseguire l'aggiornamento dalla versione 1.14 alla versione 1.16.x, procedere prima con l'aggiornamento dalla versione 1.14 alla versione 1.15.x, quindi eseguire un altro aggiornamento dalla versione 1.15.x alla versione 1.16.x.

  L'output di esempio seguente mostra il risultato dell'aggiornamento a 1.29.2. Si noti che ora KubernetesVersion è 1.29.2:

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

1. Nel portale di Azure passare al cluster del servizio Azure Kubernetes.

2. Dal menu del servizio, in Impostazioni selezionare Configurazione cluster.

3. In versione di Kubernetes, selezionare Aggiorna versione. In questo modo si reindirizza a una nuova pagina.

4. In versione di Kubernetesselezionare la versione desiderata e quindi selezionare Salva.

   

Per aggiornare il cluster sono necessari alcuni minuti, a seconda del numero di nodi di cui si dispone.

• Impostare un canale di aggiornamento automatico nel cluster usando il comando az aks update con il parametro --auto-upgrade-channel impostato su patch.

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

• Impostare un canale di aggiornamento automatico nel cluster usando il cmdlet Set-AzAksCluster con il parametro -AutoUpgradeChannel impostato su Patch.

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

1. Nel portale di Azure passare al cluster del servizio Azure Kubernetes.

2. Dal menu del servizio, in Impostazioni selezionare Configurazione cluster.

3. In versione di Kubernetes, selezionare Aggiorna versione.

4. Per aggiornamento automatico, selezionare Abilitato con patch (scelta consigliata)>Salva.

   

• Verificare che l'aggiornamento sia riuscito usando il comando az aks show.

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

  L'output di esempio seguente mostra che il cluster del servizio Azure Kubernetes esegue KubernetesVersion 1.27.3:

  Name          Location    ResourceGroup    KubernetesVersion    CurrentKubernetesVersion  ProvisioningState    Fqdn
  ------------  ----------  ---------------  -------------------  ------------------------  -------------------  ----------------------------------------------------------------
  myAKSCluster  eastus      myResourceGroup  1.29.2               1.29.2                    Succeeded            myaksclust-myresourcegroup-19da35-bd54a4be.hcp.eastus.azmk8s.io
  

• Verificare che l'aggiornamento sia riuscito usando il cmdlet Get-AzAksCluster.

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

  L'output di esempio seguente mostra che il cluster del servizio Azure Kubernetes esegue KubernetesVersion 1.27.3:

  Name             Location     KubernetesVersion     ProvisioningState
  ----             --------     -----------------     -----------------
  myAKSCluster     eastus       1.29.2                Succeeded
  

1. Nel portale di Azure passare al cluster del servizio Azure Kubernetes.

2. Nella pagina panoramica, selezionare la versione Kubernetes e verificare che sia la versione più recente installata nel passaggio precedente.

   

• Rimuovere il gruppo di risorse, il servizio contenitore e tutte le risorse correlate usando il comando az group delete.

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

• Rimuovere il gruppo di risorse, il servizio contenitore e tutte le risorse correlate usando il cmdlet Remove-AzResourceGroup.

  Remove-AzResourceGroup -Name myResourceGroup
  

1. Nel portale di Azure passare al cluster del servizio Azure Kubernetes.

2. Nella pagina Panoramica selezionare Elimina.

3. Nella pagina di conferma Elimina cluster selezionare Elimina.