Samouczek — uaktualnianie klastra usługi Azure Kubernetes Service (AKS)

W przypadku korzystania z interfejsu wiersza polecenia platformy Azure ten samouczek wymaga interfejsu wiersza polecenia platformy Azure w wersji 2.34.1 lub nowszej. Uruchom polecenie az --version, aby dowiedzieć się, jaka wersja jest używana. Jeśli konieczna będzie instalacja lub uaktualnienie, zobacz Instalowanie interfejsu wiersza polecenia platformy Azure.

W przypadku korzystania z programu Azure PowerShell ten samouczek wymaga programu Azure PowerShell w wersji 5.9.0 lub nowszej. Uruchom polecenie Get-InstalledModule -Name Az, aby dowiedzieć się, jaka wersja jest używana. Jeśli konieczna będzie instalacja lub uaktualnienie, zobacz Instalowanie programu Azure PowerShell.

Uzyskiwanie dostępnych wersji klastra przy użyciu Azure CLI

Przed uaktualnieniem sprawdź, które wersje platformy Kubernetes są dostępne dla klastra az aks get-upgrades przy użyciu polecenia .

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

Poniższe przykładowe dane wyjściowe pokazują bieżącą wersję klastra i wyświetla listę nowszych wersji w obszarze upgrades:

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

Uzyskiwanie dostępnych wersji klastra przy użyciu Azure PowerShell

1. Przed uaktualnieniem sprawdź bieżącą wersję klastra Kubernetes i jego region za pomocą polecenia cmdlet Get-AzAksCluster.

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

   Następujące przykładowe dane wyjściowe pokazują bieżącą wersję i lokalizację klastra:

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

2. Wyświetl listę wersji platformy Kubernetes dostępnych w regionie, w którym znajduje się klaster przy użyciu Get-AzAksVersion polecenia cmdlet .

   Get-AzAksVersion -Location westus2 | Where-Object OrchestratorVersion
   

   W poniższych przykładowych danych wyjściowych przedstawiono wersje regionalne w obszarze OrchestratorVersion:

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

   Aby zidentyfikować potencjalne cele uaktualniania, porównaj wersje nowsze niż bieżąca wersja klastra z regułami uaktualniania wersji platformy Kubernetes. To polecenie wyświetla informacje o dostępności regionalnej i nie weryfikuje ścieżki aktualizacji dla określonego klastra.

Uzyskiwanie dostępnych wersji klastra przy użyciu portalu Azure

1. Zaloguj się w witrynie Azure Portal.

2. Przejdź do zasobu w swoim klastrze AKS.

3. Z menu usługi w obszarze Ustawienia wybierz pozycję Uaktualnienia.

4. W obszarze Wersja rozwiązania Kubernetes wybierz pozycję Uaktualnij wersję.

   

5. Na stronie Uaktualnianie wersji rozwiązania Kubernetes wybierz listę rozwijaną Wersja rozwiązania Kubernetes , aby wyświetlić dostępne wersje rozwiązania Kubernetes na potrzeby uaktualnienia.

   

Jeśli nie są dostępne żadne uaktualnienia, klaster może już znajdować się w najnowszej dostępnej wersji lub wersja klastra może znajdować się poza oknem pomocy technicznej. Jeśli wersja nie jest obsługiwana, a usługa AKS nie oferuje aktualizacji naprawczej, utwórz nowy klaster z obsługiwaną wersją Kubernetes i przenieś swoje obciążenia. Aby uzyskać więcej informacji, zobacz Zasady pomocy technicznej usługi AKS dla wersji platformy Kubernetes.

Ręczne uaktualnianie klastra przy użyciu Azure CLI

Uaktualnij klaster przy użyciu az aks upgrade polecenia . W tym przykładzie klaster jest uaktualniany do wersji 1.34.10:

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

Poniższe przykładowe dane wyjściowe pokazują wynik uaktualnienia. Wartość kubernetesVersion jest teraz zgodna z wersją określoną w przykładowym poleceniu:

{
  ...
  "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"
  ...
}

Ręczne uaktualnianie klastra przy użyciu Azure PowerShell

Uaktualnij klaster za pomocą polecenia cmdlet Set-AzAksCluster. W tym przykładzie klaster jest uaktualniany do wersji 1.34.10:

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

Poniższe przykładowe dane wyjściowe pokazują wynik uaktualnienia. Wartość KubernetesVersion jest teraz zgodna z wersją określoną w przykładowym poleceniu cmdlet:

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

Ręczne uaktualnianie klastra przy użyciu portalu Azure

1. W portalu Azure przejdź do zasobu klastra AKS.

2. Z menu usługi w obszarze Ustawienia wybierz pozycję Uaktualnienia.

3. W obszarze Wersja rozwiązania Kubernetes wybierz pozycję Uaktualnij wersję.

   

4. Na stronie Uaktualnianie wersji rozwiązania Kubernetes wybierz listę rozwijaną Wersja rozwiązania Kubernetes , aby wyświetlić dostępne wersje rozwiązania Kubernetes na potrzeby uaktualnienia.

   

5. Wybierz wersję platformy Kubernetes, do której chcesz przeprowadzić uaktualnienie, a następnie wybierz pozycję Zapisz.

Czas trwania uaktualnienia zależy od czynników, takich jak liczba węzłów, ustawienia wzrostu, ograniczenia zakłóceń obciążenia, limit czasu opróżniania i czas trwania moczenia węzła. Domyślny limit czasu opróżniania wynosi 30 minut na węzeł i można go skonfigurować od pięciu minut do 24 godzin. Czas trwania moczenia węzła może dodać zero do 30 minut na węzeł. Aby uzyskać więcej informacji, zobacz Dostosowywanie wzrostu puli węzłów i niedostępnych ustawień.

Konfigurowanie automatycznych uaktualnień klastra przy użyciu Azure CLI

Konfigurowanie automatycznych uaktualnień klastra przy użyciu Azure PowerShell

Konfigurowanie automatycznych uaktualnień klastra przy użyciu portalu Azure

W klastrze AKS w warstwie Standard ustaw kanał automatycznej aktualizacji za pomocą polecenia az aks update. W poniższym przykładzie użyto kanału stable :

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

W klastrze AKS w warstwie Standard ustaw kanał automatycznych uaktualnień za pomocą polecenia cmdlet Set-AzAksCluster. W poniższym przykładzie użyto kanału Stable :

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

1. W portalu Azure przejdź do zasobu klastra AKS.

2. Z menu usługi w obszarze Ustawienia wybierz pozycję Uaktualnienia.

3. W obszarze Wersja rozwiązania Kubernetes wybierz pozycję Uaktualnij wersję.

   

4. W przypadku klastra usługi AKS w warstwie Standardowa na stronie Uaktualnianie wersji rozwiązania Kubernetes wybierz listę rozwijaną Automatyczne uaktualnianie , wybierz pozycję Włączone ze stabilną, a następnie wybierz pozycję Zapisz.

   

Weryfikowanie uaktualnienia przy użyciu Azure CLI

Upewnij się, że uaktualnienie zakończyło się pomyślnie, używając az aks show polecenia .

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

Następujące przykładowe dane wyjściowe pokazują, że klaster usługi AKS uruchamia docelową wersję rozwiązania Kubernetes:

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

Weryfikowanie uaktualnienia przy użyciu Azure PowerShell

Potwierdź, że uaktualnienie zakończyło się pomyślnie, za pomocą polecenia cmdlet Get-AzAksCluster.

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

Następujące przykładowe dane wyjściowe pokazują, że klaster usługi AKS uruchamia docelową wersję rozwiązania Kubernetes:

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

Weryfikowanie uaktualnienia przy użyciu portalu Azure

1. W portalu Azure przejdź do zasobu klastra AKS.
2. Na stronie Przegląd w obszarze Podstawy sprawdź wersję rozwiązania Kubernetes , aby potwierdzić pomyślne uaktualnienie.

Usuwanie klastra przy użyciu Azure CLI

Usuwanie klastra przy użyciu Azure PowerShell

Usuwanie klastra przy użyciu portalu Azure

Usuń grupę zasobów, usługę kontenera i wszystkie powiązane zasoby przy użyciu az group delete polecenia .

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

Usuń grupę zasobów, usługę kontenera i wszystkie powiązane zasoby przy użyciu Remove-AzResourceGroup polecenia cmdlet .

Remove-AzResourceGroup -Name myResourceGroup

1. W portalu Azure przejdź do zasobu klastra AKS.
2. Na stronie Przegląd wybierz pozycję Usuń.
3. Na stronie potwierdzenia usunięcia klastra, wybierz pozycję Usuń.