AKS-knooppuntinstallatiekopieën (Azure Kubernetes Service) upgraden

  • Artikel

Azure Kubernetes Service (AKS) biedt regelmatig nieuwe knooppuntinstallatiekopieën, dus het is handig om uw knooppuntinstallatiekopieën regelmatig te upgraden om de nieuwste AKS-functies te gebruiken. Installatiekopieën van Linux-knooppunten worden wekelijks bijgewerkt en Installatiekopieën van Windows-knooppunten worden maandelijks bijgewerkt. Aankondigingen over de upgrade van installatiekopieën zijn opgenomen in de opmerkingen bij de AKS-release en het kan een week duren voordat deze updates in alle regio's worden geïmplementeerd. Upgrades van knooppuntinstallatiekopieën kunnen ook automatisch en gepland worden uitgevoerd met behulp van gepland onderhoud. Zie Knooppuntinstallatiekopieën automatisch upgraden voor meer informatie.

In dit artikel wordt beschreven hoe u installatiekopieën van AKS-clusterknooppunten bijwerkt en hoe u installatiekopieën van knooppuntgroepen bijwerkt zonder de Kubernetes-versie bij te werken. Zie Een AKS-cluster upgraden voor informatie over het upgraden van de Kubernetes-versie voor uw cluster.

Notitie

Het AKS-cluster moet virtuele-machineschaalsets voor de knooppunten gebruiken.

Het is niet mogelijk om een versie van een knooppuntinstallatiekopieën te downgraden (bijvoorbeeld AKSShell-2204 naar AKSShell-1804 of AKSShell-2204-202308.01.0 naar AKSShell-2204-202307.27.0).

Controleren op beschikbare upgrades van knooppuntinstallatiekopieën

Controleer op beschikbare upgrades van knooppuntinstallatiekopieën met behulp van de az aks nodepool get-upgrades opdracht.

az aks nodepool get-upgrades \
    --nodepool-name mynodepool \
    --cluster-name myAKSCluster \
    --resource-group myResourceGroup

In de uitvoer ziet u de latestNodeImageVersionuitvoer, zoals in het volgende voorbeeld:

{
  "id": "/subscriptions/XXXX-XXX-XXX-XXX-XXXXX/resourcegroups/myResourceGroup/providers/Microsoft.ContainerService/managedClusters/myAKSCluster/agentPools/mynodepool/upgradeProfiles/default",
  "kubernetesVersion": "1.17.11",
  "latestNodeImageVersion": "AKSUbuntu-1604-2020.10.28",
  "name": "default",
  "osType": "Linux",
  "resourceGroup": "myResourceGroup",
  "type": "Microsoft.ContainerService/managedClusters/agentPools/upgradeProfiles",
  "upgrades": null
}

De voorbeelduitvoer wordt weergegeven AKSUbuntu-1604-2020.10.28 als de latestNodeImageVersion.

Vergelijk de nieuwste versie met de huidige versie van de knooppuntinstallatiekopieën met behulp van de az aks nodepool show opdracht.

az aks nodepool show \
    --resource-group myResourceGroup \
    --cluster-name myAKSCluster \
    --name mynodepool \
    --query nodeImageVersion

Uw uitvoer moet er ongeveer uitzien als de uitvoer in het volgende voorbeeld:

"AKSUbuntu-1604-2020.10.08"

In dit voorbeeld is er een upgrade van de versie van de knooppuntinstallatiekopieën beschikbaar. Dit is van versie AKSUbuntu-1604-2020.10.08 tot versie AKSUbuntu-1604-2020.10.28.

Alle knooppuntinstallatiekopieën in alle knooppuntgroepen bijwerken

Werk de knooppuntinstallatiekopieën bij met behulp van de az aks upgrade opdracht met de --node-image-only vlag.

az aks upgrade \
    --resource-group myResourceGroup \
    --name myAKSCluster \
    --node-image-only

U kunt de status van de knooppuntinstallatiekopieën controleren met behulp van de kubectl get nodes opdracht.

Notitie

Deze opdracht kan enigszins verschillen, afhankelijk van de shell die u gebruikt. Zie de Kubernetes JSONPath-documentatie voor meer informatie over Windows- en PowerShell-omgevingen.

kubectl get nodes -o jsonpath='{range .items[*]}{.metadata.name}{"\t"}{.metadata.labels.kubernetes\.azure\.com\/node-image-version}{"\n"}{end}'

Wanneer de upgrade is voltooid, gebruikt u de az aks show opdracht om de bijgewerkte gegevens van de knooppuntgroep op te halen. De huidige knooppuntinstallatiekopie wordt weergegeven in de eigenschap nodeImageVersion.

az aks show \
    --resource-group myResourceGroup \
    --name myAKSCluster

Een specifieke knooppuntgroep upgraden

Als u de installatiekopieën van het besturingssysteem van een knooppuntgroep wilt bijwerken zonder een Kubernetes-clusterupgrade uit te voeren, gebruikt u de az aks nodepool upgrade opdracht met de --node-image-only vlag.

az aks nodepool upgrade \
    --resource-group myResourceGroup \
    --cluster-name myAKSCluster \
    --name mynodepool \
    --node-image-only

U kunt de status van de knooppuntinstallatiekopieën controleren met de kubectl get nodes opdracht.

Notitie

Deze opdracht kan enigszins verschillen, afhankelijk van de shell die u gebruikt. Zie de Kubernetes JSONPath-documentatie voor meer informatie over Windows- en PowerShell-omgevingen.

kubectl get nodes -o jsonpath='{range .items[*]}{.metadata.name}{"\t"}{.metadata.labels.kubernetes\.azure\.com\/node-image-version}{"\n"}{end}'

Wanneer de upgrade is voltooid, gebruikt u de az aks nodepool show opdracht om de bijgewerkte gegevens van de knooppuntgroep op te halen. De huidige knooppuntinstallatiekopie wordt weergegeven in de eigenschap nodeImageVersion.

az aks nodepool show \
    --resource-group myResourceGroup \
    --cluster-name myAKSCluster \
    --name mynodepool

Installatiekopieën van knooppunten upgraden met knooppuntpieken

Als u het upgradeproces van de knooppuntinstallatiekopieën wilt versnellen, kunt u uw knooppuntinstallatiekopieën upgraden met behulp van een aanpasbare piekwaarde voor knooppunten. AKS gebruikt standaard één extra knooppunt om upgrades te configureren.

Als u de snelheid van upgrades wilt verhogen, gebruikt u de az aks nodepool update opdracht met de --max-surge vlag om het aantal knooppunten te configureren dat wordt gebruikt voor upgrades. Zie De upgrade van knooppuntpieken aanpassen voor meer informatie over de afwegingen van verschillende --max-surge instellingen.

az aks nodepool update \
    --resource-group myResourceGroup \
    --cluster-name myAKSCluster \
    --name mynodepool \
    --max-surge 33% \
    --no-wait

U kunt de status van de knooppuntinstallatiekopieën controleren met de kubectl get nodes opdracht.

kubectl get nodes -o jsonpath='{range .items[*]}{.metadata.name}{"\t"}{.metadata.labels.kubernetes\.azure\.com\/node-image-version}{"\n"}{end}'

Gebruik az aks nodepool show dit om de bijgewerkte gegevens van de knooppuntgroep op te halen. De huidige knooppuntinstallatiekopie wordt weergegeven in de eigenschap nodeImageVersion.

az aks nodepool show \
    --resource-group myResourceGroup \
    --cluster-name myAKSCluster \
    --name mynodepool

Volgende stappen