De versie van het besturingssysteem (OS) upgraden voor uw Windows-workloads (Azure Kubernetes Service)

Wanneer u de versie van het besturingssysteem van een actieve Windows workload op Azure Kubernetes Service (AKS) bijwerkt, gebruikt u een van de volgende migratiemethoden:

  • In-place migratie: werk de SKU van het besturingssysteem in een bestaande knooppuntgroep bij om te migreren van Windows Server 2022 naar Windows Server 2025.
  • Handmatige migratie: Maak een nieuwe knooppuntgroep met de gewenste Windows Server versie van het besturingssysteem, verplaats uw workloads naar de nieuwe knooppuntgroep en verwijder de oude knooppuntgroep.

Wanneer er een nieuwe versie van het Windows Server-besturingssysteem wordt uitgebracht, wordt AKS verplicht deze te ondersteunen. U wordt aangeraden een upgrade uit te voeren naar de nieuwste versie om te profiteren van de fixes, verbeteringen en nieuwe functionaliteit. AKS biedt een levenscyclus van vijf jaar ondersteuning voor elke Windows Server-versie, te beginnen met Windows Server 2022. Gedurende deze periode brengt AKS een nieuwe versie uit die ondersteuning biedt voor een nieuwere versie van het Windows Server-besturingssysteem waarnaar u een upgrade kunt uitvoeren. Nadat de levenscyclus van vijf jaar is beëindigd, moet u workloads migreren naar nieuwere ondersteunde versies om compatibiliteit, beveiligingsupdates en continue ondersteuning van AKS te garanderen.

Belangrijk

Vanaf 30 juni 2028 biedt Azure Kubernetes Service (AKS) geen ondersteuning meer voor Windows Server 2022 knooppuntgroepen. Windows Server 2022 wordt niet ondersteund in Kubernetes versie 1.37 en hoger. Vanaf 30 juni 2029 verwijdert AKS alle bestaande knooppuntinstallatiekopieën voor Windows Server 2022, wat betekent dat schaalbewerkingen mislukken. Zie voor meer informatie over deze buitengebruikstelling het GitHub-probleem met buitengebruikstelling en de aankondiging van de buitengebruikstelling van Azure Updates. Als u op de hoogte wilt blijven van aankondigingen en updates, volgt u de opmerkingen bij de AKS-release.

De volgende beperkingen gelden voor Windows Server migratie van besturingssysteemversies:

  • Update van knooppuntgroep voor migratie van een Windows Server versie naar een andere wordt alleen ondersteund voor Windows Server 2022-naar-Windows Server 2025-migratie met behulp van de aks-preview Azure CLI-extensie versie 22.0.0b6 of hoger. Maak een nieuwe knooppuntgroep voor alle andere Windows Server-versiemigraties van het besturingssysteem.
  • Verschillende Versies van Windows Server kunnen niet naast elkaar bestaan in dezelfde knooppuntgroep in AKS. Als u een nieuwe knooppuntgroep maakt om de nieuwe versie van het besturingssysteem te hosten, moet u ervoor zorgen dat u de machtigingen en toegang van de vorige knooppuntgroep aan de nieuwe knooppuntgroep koppelt.
  • Windows Server 2025 wordt ondersteund vanaf Kubernetes versie 1.32.0.

Vereiste voorwaarden

  • Werk de FROM instructie in uw Dockerfile bij naar de nieuwe versie van het besturingssysteem.
  • Controleer uw toepassing en controleer of de container-app werkt op de nieuwe versie van het besturingssysteem.
  • Implementeer de geverifieerde container-app op AKS in een ontwikkel- of testomgeving.
  • Noteer de nieuwe afbeeldingsnaam of -tag voor gebruik in dit artikel.
  • Voor in-place migratie van Windows Server 2022 naar Windows Server 2025 installeert of werkt u de aks-preview Azure CLI-extensie bij naar versie 22.0.0b6 of hoger.

Notitie

Zie Dockerfile in Windows en Windows Dockerfiles optimaliseren voor meer informatie over het bouwen van een Dockerfile voor Windows-workloads.

Belangrijk

AKS preview-functies zijn beschikbaar op selfservice, opt-in basis. Previews worden geleverd 'zoals het is' en 'voor zover beschikbaar' en zijn uitgesloten van de serviceovereenkomsten en beperkte garantie. AKS-previews worden gedeeltelijk gedekt door klantondersteuning naar best vermogen. Zodoende zijn deze functies niet bedoeld voor productiegebruik. Zie de volgende ondersteuningsartikelen voor meer informatie:

aks-preview De Azure CLI-extensie installeren

  • Voer de volgende opdracht uit om de aks-preview-extensie te installeren:

In-place migratie van Windows Server 2022 naar Windows Server 2025

U kunt een bestaande Windows Server 2022 knooppuntgroep migreren naar Windows Server 2025 door de SKU van het besturingssysteem bij te werken in de bestaande knooppuntgroep met de az aks nodepool update opdracht. Dit migratiepad maakt gebruik van de aks-preview Azure CLI-extensie versie 22.0.0b6 of hoger. Het cluster moet Kubernetes versie 1.32 tot en met 1.36 uitvoeren, waarbij beide besturingssysteemversies worden ondersteund.

Aandachtspunten bij in-place-migratie

Houd rekening met de volgende details voordat u een Windows Server 2022 knooppuntgroep migreert naar Windows Server 2025:

  • Windows Server 2025 gebruikt standaard installatie-images met FIPS ingeschakeld. Als uw Windows Server 2022-knooppuntgroep nog geen FIPS-ingeschakelde installatiekopie gebruikt, neemt u --enable-fips-image op wanneer u de updateopdracht uitvoert.
  • Met de opdracht update wordt automatisch een nieuwe image op de bestaande nodegroep toegepast.
  • Windows Server 2025 maakt standaard gebruik van VM's van de tweede generatie. U hoeft geen bestaande knooppuntgroep van de tweede generatie Windows Server 2022 te hebben om te migreren. Standard Windows Server 2022-knooppuntgroepen containerd worden ondersteund.
  • Als de bestaande VM-grootte ondersteuning biedt voor generatie 2, kan AKS tijdens de migratie een installatiekopieën van Windows Server 2025 generatie 2 selecteren. Deze standaardafbeeldingsselectie kan van invloed zijn op de compatibiliteit van afbeeldingen voor sommige configuraties.

In de volgende tabel wordt beschreven welke bronconfiguraties ondersteuning bieden voor in-place migratie met de updateopdracht. Gebruik in plaats daarvan handmatige migratie voor niet-ondersteunde configuraties.

Bestaande configuratie Support Result
Standard Windows Server 2022 containerd Generatie 1-image met een VM-grootte die alleen Generatie 1 ondersteunt Ja Migreert naar Windows Server 2025 Generatie 1.
Standard Windows Server 2022 containerd Generatie 1-image met een VM-grootte met ondersteuning voor Generatie 2 Ja Migreert naar Windows Server 2025 Generatie 2.
Standaardinstallatiekopie van Windows Server 2022 containerd Generatie 2 met een voor Generatie 2 geschikte VM-grootte Ja Migreert naar Windows Server 2025 Generatie 2.

Bestaande Windows Server 2022-knooppuntgroep bijwerken naar Windows Server 2025

  1. Werk de os-SKU van de knooppuntgroep bij naar Windows2025 met behulp van de az aks nodepool update opdracht.

    az aks nodepool update \
    --resource-group <resource-group-name> \
    --cluster-name <cluster-name> \
    --name <node-pool-name> \
    --os-sku Windows2025 \
    --enable-fips-image

  2. Controleer of een knooppunt in de bijgewerkte knooppuntgroep gebruikmaakt van de SKU van het Windows2025 besturingssysteem en een Windows Server 2025-installatiekopieën met behulp van de kubectl describe node opdracht.

    kubectl describe node <node-name>

    In de volgende beknopte voorbeelduitvoer worden het Windows2025 OS-SKU-label en de Windows Server 2025-OS-image weergegeven:

    Labels:
  kubernetes.azure.com/os-sku=Windows2025
  kubernetes.io/os=windows
...
System Info:
  OS Image:                   Windows Server 2025 Datacenter
  Container Runtime Version:  containerd://2.0.4+azure

Handmatige migratie naar een nieuwe knooppuntgroep

Handmatige migratie maakt gebruik van een nieuwe knooppuntgroep in plaats van de bestaande knooppuntgroep bij te werken. Gebruik handmatige migratie voor Windows Server versiemigraties van het besturingssysteem die geen ondersteuning bieden voor in-place migratie of wanneer uw bronconfiguratie niet wordt ondersteund voor in-place migratie. Als u handmatig wilt migreren, maakt u een nieuwe knooppuntgroep met de gewenste Windows Server versie van het besturingssysteem en verplaatst u uw workloads naar de nieuwe knooppuntgroep.

Een nieuwe knooppuntgroep toevoegen aan een bestaand cluster

Voeg een knooppuntgroep toe met de gewenste versie van het besturingssysteem aan uw bestaande cluster:

voor Windows Server 2025-knooppuntgroepen is een installatiekopie met FIPS-functionaliteit vereist. Wanneer u een Windows Server 2025-knooppuntgroep toevoegt, neemt u --enable-fips-image (Azure CLI) of -EnableFIPS (Azure PowerShell) op.

Het YAML-bestand bijwerken

Knooppuntkiezer is de meest voorkomende en aanbevolen optie voor het plaatsen van Windows-pods op Windows-knooppunten.

  1. Voeg nodeselector toe aan uw YAML-bestand door de volgende aantekening toe te voegen:

          nodeSelector:
        "kubernetes.io/os": windows

    De annotatie zoekt een beschikbaar Windows-knooppunt en plaatst de pod op dat knooppunt (volgens alle andere inplanningsregels). Wanneer u de versie van het besturingssysteem bijwerkt, moet u de plaatsing afdwingen op een Windows-knooppunt en een knooppunt met de nieuwste versie van het besturingssysteem. Hiervoor kunt u een andere aantekening gebruiken. Werk <OSSKU> bij om deze overeen te laten komen met de ossku van de door u gewenste Windows-besturingssysteemversie, bijvoorbeeld Windows2025.

          nodeSelector:
        "kubernetes.azure.com/os-sku": <OSSKU>

  2. Zodra u de nodeSelector in het YAML-bestand hebt bijgewerkt, moet u ook de containerimage aanpassen die u wilt gebruiken. U kunt deze informatie ophalen uit de vorige stap waarin u een nieuwe versie van de containertoepassing hebt gemaakt door de FROM instructie in uw Dockerfile te wijzigen.

    Notitie

    U moet hetzelfde YAML-bestand gebruiken dat u hebt gebruikt om de toepassing in eerste instantie te implementeren. Dit zorgt ervoor dat er geen andere configuratiewijzigingen zijn dan de nodeSelector en de containerimage.

Het bijgewerkte YAML-bestand toepassen op de bestaande workload

  1. Bekijk de knooppunten in uw cluster met behulp van de kubectl get nodes opdracht.

    kubectl get nodes -o wide

    In de volgende voorbeelduitvoer ziet u alle knooppunten in het cluster, inclusief de nieuwe knooppuntgroep die u hebt gemaakt en de bestaande knooppuntgroepen:

    NAME                                STATUS   ROLES   AGE     VERSION   INTERNAL-IP    EXTERNAL-IP   OS-IMAGE                         KERNEL-VERSION     CONTAINER-RUNTIME
aks-agentpool-18877473-vmss000000   Ready    agent   5h40m   v1.33.12   10.240.0.4     <none>        Ubuntu 22.04.5 LTS               5.15.0-1116-azure  containerd://1.7.33-1
akspoolws000000                     Ready    agent   3h15m   v1.33.12   10.240.0.208   <none>        Windows Server 2022 Datacenter   10.0.20348.825     containerd://1.6.6+azure
akspoolws000001                     Ready    agent   3h17m   v1.33.12   10.240.0.239   <none>        Windows Server 2022 Datacenter   10.0.20348.825     containerd://1.6.6+azure
akspoolws000002                     Ready    agent   3h17m   v1.33.12   10.240.1.14    <none>        Windows Server 2022 Datacenter   10.0.20348.825     containerd://1.6.6+azure
akswspool000000                     Ready    agent   5h37m   v1.33.12   10.240.0.115   <none>        Windows Server 2025 Datacenter   10.0.26100.32995    containerd://2.0.4+azure
akswspool000001                     Ready    agent   5h37m   v1.33.12   10.240.0.146   <none>        Windows Server 2025 Datacenter   10.0.26100.32995    containerd://2.0.4+azure
akswspool000002                     Ready    agent   5h37m   v1.33.12   10.240.0.177   <none>        Windows Server 2025 Datacenter   10.0.26100.32995    containerd://2.0.4+azure

  2. Pas het bijgewerkte YAML-bestand toe op de bestaande workload met behulp van de kubectl apply opdracht en geef de naam op van het YAML-bestand.

    kubectl apply -f <filename>

    In de volgende voorbeelduitvoer ziet u een geconfigureerde status voor de implementatie:

    deployment.apps/sample configured
service/sample unchanged

    Op dit punt start AKS het proces van het beëindigen van de bestaande pods en het implementeren van nieuwe pods op de knooppunten met de nodeSelector aantekening.

  3. Controleer de status van de implementatie met behulp van de kubectl get pods opdracht.

    kubectl get pods -o wide

    In de volgende voorbeelduitvoer ziet u de pods in de default naamruimte:

    NAME                      READY   STATUS    RESTARTS   AGE     IP             NODE              NOMINATED NODE   READINESS GATES
sample-7794bfcc4c-k62cq   1/1     Running   0          2m49s   10.240.0.238   akspoolws000000   <none>           <none>
sample-7794bfcc4c-rswq9   1/1     Running   0          2m49s   10.240.1.10    akspoolws000001   <none>           <none>
sample-7794bfcc4c-sh78c   1/1     Running   0          2m49s   10.240.0.228   akspoolws000000   <none>           <none>

Beveiligings- en verificatieconfiguratie bijwerken

Als u Beheerde serviceaccounts voor groepen (gMSA) gebruikt, moet u de configuratie van de beheerde identiteit voor de nieuwe knooppuntgroep bijwerken. gMSA maakt gebruik van een geheim (gebruikersaccount en wachtwoord), zodat het knooppunt waarop de Windows-pod wordt uitgevoerd, de container kan verifiëren bij Microsoft Entra-id. Voor toegang tot dat geheim in Azure Key Vault gebruikt het knooppunt een beheerde identiteit waarmee het knooppunt toegang heeft tot de resource. Omdat beheerde identiteiten per knooppuntgroep zijn geconfigureerd en de pod zich nu in een nieuwe knooppuntgroep bevindt, moet u die configuratie bijwerken. Zie Group Managed Service Accounts (GMSA) inschakelen voor uw Windows Server-knooppunten in uw AKS-cluster (Azure Kubernetes Service) voor meer informatie.

Hetzelfde principe geldt voor beheerde identiteiten voor elke andere pod of knooppuntgroep bij toegang tot andere Azure-resources. U moet alle toegang die managed identity biedt bijwerken om de nieuwe knooppuntgroep weer te geven. Als u bijwerk- en aanmeldingsactiviteiten wilt weergeven, raadpleegt u Hoe u de activiteiten van beheerde identiteiten kunt weergeven.

Volgende stappen

In dit artikel hebt u geleerd hoe u de versie van het besturingssysteem voor Windows-workloads op AKS bijwerkt. Zie Een Windows-containertoepassing implementeren in Azure Kubernetes Service (AKS) voor meer informatie over Windows-workloads in AKS.

  • Laatst bijgewerkt om