AKS-knooppuntinstallatiekopieën (Azure Kubernetes Service) upgraden

Artikel
09/24/2024

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. U kunt ook knooppuntinstallatiekopieën automatisch upgraden en plannen 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 <node-pool-name> \
    --cluster-name <cluster-name> \
    --resource-group <resource-group>

Zoek en noteer de waarde in de latestNodeImageVersion uitvoer. Deze waarde is de nieuwste versie van de knooppuntinstallatiekopieën die beschikbaar zijn voor uw knooppuntgroep.

Controleer de huidige versie van de knooppuntinstallatiekopieën om te vergelijken met de nieuwste versie met behulp van de az aks nodepool show opdracht.

az aks nodepool show \
    --resource-group <resource-group> \
    --cluster-name <cluster-name> \
    --name <node-pool-name> \
    --query nodeImageVersion

Als de nodeImageVersion waarde verschilt van de latestNodeImageVersionwaarde, kunt u de knooppuntinstallatiekopieën upgraden.

Alle knooppuntinstallatiekopieën in alle knooppuntgroepen upgraden

Werk alle knooppuntinstallatiekopieën in alle knooppuntgroepen in uw cluster bij met behulp van de az aks upgrade opdracht met de --node-image-only vlag.
```
az aks upgrade \
    --resource-group <resource-group> \
    --name <cluster-name> \
    --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 <resource-group> \
    --name <cluster-name>
```

Een specifieke knooppuntgroep upgraden

Werk de installatiekopieën van het besturingssysteem van een knooppuntgroep bij zonder een Kubernetes-clusterupgrade uit te voeren met behulp van de az aks nodepool upgrade opdracht met de --node-image-only vlag.
```
az aks nodepool upgrade \
    --resource-group <resource-group> \
    --cluster-name <cluster-name> \
    --name <node-pool-name> \
    --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 <resource-group> \
    --cluster-name <cluster-name> \
    --name <node-pool-name>
```

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.

Upgrade van knooppuntinstallatiekopieën met knooppuntpieken met behulp van de az aks nodepool update opdracht met de --max-surge vlag om het aantal knooppunten te configureren dat wordt gebruikt voor upgrades.

Notitie

Zie De upgrade van knooppuntpieken aanpassen voor meer informatie over de afwegingen van verschillende --max-surge instellingen.
```
az aks nodepool update \
    --resource-group <resource-group> \
    --cluster-name <cluster-name> \
    --name <node-pool-name> \
    --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}'

Haal de bijgewerkte details van de knooppuntgroep op met behulp van de az aks nodepool show opdracht om de bijgewerkte details van de knooppuntgroep op te halen. De huidige knooppuntinstallatiekopie wordt weergegeven in de eigenschap nodeImageVersion.
```
az aks nodepool show \
    --resource-group <resource-group> \
    --cluster-name <cluster-name> \
    --name <node-pool-name>
```

Volgende stappen

Zie de opmerkingen bij de release van AKS voor informatie over de nieuwste installatiekopieën van knooppunten.
Meer informatie over het upgraden van de Kubernetes-versie met Een AKS-cluster upgraden.
Automatisch cluster- en knooppuntgroepupgrades toepassen met GitHub Actions.
Meer informatie over meerdere knooppuntgroepen met Meerdere knooppuntgroepen maken.
Meer informatie over het upgraden van best practices met AKS-patch- en upgraderichtlijnen.

Delen via