Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
När du uppgraderar operativsystemets version av en arbetsbelastning som körs Windows på Azure Kubernetes Service (AKS) använder du någon av följande migreringsmetoder:
- Migrering på plats: Uppdatera OS SKU:n i en befintlig nodpool för att migrera från Windows Server 2022 till Windows Server 2025.
- Manuell migrering: Skapa en ny nodpool med önskad Windows Server os-version, flytta dina arbetsbelastningar till den nya nodpoolen och ta bort den gamla nodpoolen.
När en ny Version av Windows Server-operativsystemet släpps har AKS åtagit sig att stödja den. Vi rekommenderar att du uppgraderar till den senaste versionen för att dra nytta av korrigeringar, förbättringar och nya funktioner. AKS tillhandahåller en femårig supportlivscykel för varje Windows Server-version, från och med Windows Server 2022. Under den här perioden släpper AKS en ny version som stöder en nyare version av Windows Server OS som du kan uppgradera till. När den femåriga livscykeln är slut måste du migrera arbetsbelastningar till nyare versioner som stöds för att säkerställa kompatibilitet, säkerhetsuppdateringar och fortsatt stöd från AKS.
Viktigt!
Från och med den 30 juni 2028 stöder Azure Kubernetes Service (AKS) inte längre Windows Server 2022 nodpooler. Windows Server 2022 stöds inte i Kubernetes version 1.37 och senare. Från och med den 30 juni 2029 tar AKS bort alla befintliga nodbilder för Windows Server 2022, vilket innebär att skalningsåtgärderna misslyckas. Mer information om den här tillbakadragningen finns i GitHub-problemet för pensionering och meddelandet om azure-uppdateringars tillbakadragning. Om du vill hålla dig informerad om meddelanden och uppdateringar, följ AKS versionsinformation.
Följande begränsningar gäller för migrering av Windows Server operativsystemversion:
- Uppdatering av nodpool för migrering från en Windows Server version till en annan stöds endast för Windows Server 2022-till-Windows Server 2025-migrering med hjälp
aks-previewav Azure CLI-tillägget version 22.0.0b6 eller senare. Skapa en ny nodpool för alla andra migreringar av Windows Server operativsystemversion. - Olika Windows Server-versioner kan inte samexistera i samma nodpool i AKS. Om du skapar en ny nodpool som värd för den nya operativsystemversionen kontrollerar du att du matchar behörigheterna och åtkomsten för den tidigare nodpoolen med den nya.
- Windows Server 2025 stöds från och med Kubernetes version 1.32.0.
Förutsättningar
- Uppdatera instruktionen
FROMi din Dockerfile till den nya OS-versionen. - Kontrollera ditt program och kontrollera att containerappen fungerar på den nya operativsystemversionen.
- Distribuera den verifierade containerappen i AKS till en utvecklings- eller testmiljö.
- Anteckna det nya avbildningsnamnet eller taggen för användning i den här artikeln.
- För migrering på plats från Windows Server 2022 till Windows Server 2025 installerar eller uppdaterar
aks-previewdu Azure CLI-tillägget till version 22.0.0b6 eller senare.
Note
Information om hur du skapar en Dockerfile för Windows-arbetsbelastningar finns i Dockerfile i Windows och Optimera Windows Dockerfiles.
Viktigt!
AKS-förhandsversionsfunktioner är tillgängliga via självbetjäning och frivillig registrering. Förhandsversioner tillhandahålls "i befintligt skick" och "i mån av tillgång," och de är undantagna från servicenivåavtal och begränsad garanti. AKS-förhandsversioner stöds delvis av kundsupport efter bästa förmåga. Därför är dessa funktioner inte avsedda för produktionsanvändning. Mer information finns i följande supportartiklar:
Installera tillägget aks-preview Azure CLI
- Kör följande kommando för att installera aks-preview-tillägget:
Migrering på plats från Windows Server 2022 till Windows Server 2025
Du kan migrera en befintlig Windows Server 2022 nodpool till Windows Server 2025 på plats genom att uppdatera OS SKU:n på den befintliga nodpoolen az aks nodepool update med kommandot . Den här migreringssökvägen använder aks-preview Azure CLI-tillägget version 22.0.0b6 eller senare. Klustret måste köra Kubernetes version 1.32 till 1.36 där båda os-versionerna stöds.
Migreringsöverväganden på plats
Tänk på följande information innan du migrerar en Windows Server 2022 nodpool till Windows Server 2025:
- Windows Server 2025 använder FIPS-aktiverade avbildningar som standard. Om din Windows Server 2022 nodpool inte redan använder en FIPS-aktiverad avbildning ska du inkludera
--enable-fips-imagenär du kör uppdateringskommandot. - Uppdateringskommandot utlöser en automatisk återimering av den befintliga nodpoolen.
- Windows Server 2025 använder virtuella datorer i generation 2 som standard. Du behöver inte ha en befintlig generation 2-Windows Server 2022 nodpool för att migrera på plats. Standard-Windows Server 2022
containerdnodpooler stöds. - Om den befintliga VM-storleken stöder Generation 2 kan AKS välja en Windows Server 2025 Generation 2-avbildning under migreringen. Det här förvalda bildvalet kan påverka bildkompatibiliteten för vissa konfigurationer.
I följande tabell beskrivs vilka källkonfigurationer som stöder migrering på plats med uppdateringskommandot. Använd manuell migrering i stället för konfigurationer som inte stöds.
| Befintlig konfiguration | Support | Result |
|---|---|---|
Standardavbild för Windows Server 2022 containerd Generation 1 med en VM-storlek som endast stöder Generation 1 |
Ja | Migrerar till Windows Server 2025 Generation 1. |
Windows Server 2022 Standardbild containerd generation 1 med en VM-storlek med stöd för generation 2 |
Ja | Migrerar till Windows Server 2025 Generation 2. |
Standardavbildning för Windows Server 2022 containerd Generation 2 med en VM-storlek som stöder Generation 2 |
Ja | Migrerar till Windows Server 2025 Generation 2. |
Uppdatera befintlig Windows Server 2022 nodpool till Windows Server 2025
Uppdatera os-SKU:n för nodpoolen
az aks nodepool updatetillWindows2025med hjälp av kommandot .az aks nodepool update \ --resource-group <resource-group-name> \ --cluster-name <cluster-name> \ --name <node-pool-name> \ --os-sku Windows2025 \ --enable-fips-imageKontrollera med kommandot
kubectl describe nodeatt en nod i den uppdaterade nodpoolen använderWindows2025-OS-SKU:n och en Windows Server 2025-avbildning.kubectl describe node <node-name>Följande förkortade exempelutdata visar
Windows2025OS SKU-etiketten och Windows Server 2025 OS-avbildningen: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
Manuell migrering till en ny nodpool
Manuell migrering använder en ny nodpool i stället för att uppdatera den befintliga nodpoolen. Använd manuell migrering för Windows Server os-versionsmigreringar som inte stöder migrering på plats eller när källkonfigurationen inte stöds för migrering på plats. Om du vill migrera manuellt skapar du en ny nodpool med önskad version av Windows Server operativsystem och flyttar dina arbetsbelastningar till den nya nodpoolen.
Lägga till en ny nodpool i ett befintligt kluster
Lägg till en nodpool med önskad OPERATIVSYSTEM-version i ditt befintliga kluster:
- Använd CLI för att lägga till en Windows-nodpool i ett befintligt kluster.
- Använd portalen för att lägga till en Windows-nodpool i ett befintligt kluster.
- Använd PowerShell för att lägga till en Windows-nodpool i ett befintligt kluster.
- Använd Terraform för att lägga till en Windows-nodpool i ett befintligt kluster.
Windows Server 2025-nodpooler kräver en FIPS-aktiverad avbildning. När du lägger till en Windows Server 2025-nodpool ska du inkludera --enable-fips-image (Azure CLI) eller -EnableFIPS (Azure PowerShell).
Uppdatera YAML-filen
Node Selector är det vanligaste och rekommenderade alternativet för placering av Windows-poddar på Windows-noder.
Lägg till Node Selector i YAML-filen genom att lägga till följande kommentar:
nodeSelector: "kubernetes.io/os": windowsAnteckningen hittar alla tillgängliga Windows-noder och placerar podden på noden (efter alla andra schemaläggningsregler). När du uppgraderar os-versionen måste du framtvinga placeringen på en Windows-nod och en nod som kör den senaste operativsystemversionen. För att åstadkomma detta är ett alternativ att använda en annan anteckning. Uppdatera
<OSSKU>för att matcha ossku för den önskade Windows OS-versionen, till exempelWindows2025.nodeSelector: "kubernetes.azure.com/os-sku": <OSSKU>När du har uppdaterat
nodeSelectori YAML-filen måste du också uppdatera den containeravbildning som du vill använda. Du kan hämta den här informationen från föregående steg där du skapade en ny version av det containerbaserade programmet genom att ändra -instruktionenFROMpå din Dockerfile.Note
Du bör använda samma YAML-fil som du använde för att först distribuera programmet. Detta säkerställer att inga andra konfigurationsändringar förutom
nodeSelectoroch containeravbildningen.
Tillämpa den uppdaterade YAML-filen på den befintliga arbetsbelastningen
Visa noderna i klustret med hjälp av
kubectl get nodeskommandot .kubectl get nodes -o wideFöljande exempelutdata visar alla noder i klustret, inklusive den nya nodpoolen som du skapade och de befintliga nodpoolerna:
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+azureAnvänd den uppdaterade YAML-filen på den befintliga arbetsbelastningen med kommandot
kubectl applyoch ange namnet på YAML-filen.kubectl apply -f <filename>Följande exempelutdata visar en konfigurerad status för distributionen:
deployment.apps/sample configured service/sample unchangedNu startar AKS processen med att avsluta befintliga poddar och distribuera nya poddar till noderna med anteckningen
nodeSelector.Kontrollera statusen för distributionen med hjälp av
kubectl get podskommandot .kubectl get pods -o wideFöljande exempelutdata visar poddarna i
defaultnamnområdet: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>
Uppdatera säkerhets- och autentiseringskonfiguration
Om du använder grupphanterade tjänstkonton (gMSA) måste du uppdatera konfigurationen för hanterad identitet för den nya nodpoolen. gMSA använder en hemlighet (användarkonto och lösenord) så att noden som kör Windows-podden kan autentisera containern mot Microsoft Entra-ID. För att komma åt den hemligheten i Azure Key Vault använder noden en hanterad identitet som gör att noden kan komma åt resursen. Eftersom hanterade identiteter har konfigurerats per nodpool och podden nu finns i en ny nodpool måste du uppdatera den konfigurationen. Mer information finns i Aktivera grupphanterade tjänstkonton (GMSA) för dina Windows Server-noder i ditt AkS-kluster (Azure Kubernetes Service).
Samma princip gäller för hanterade identiteter för andra poddar eller nodpooler vid åtkomst till andra Azure-resurser. Du måste uppdatera all åtkomst som hanterad identitet tillhandahåller för att återspegla den nya nodpoolen. Information om hur du visar uppdaterings- och inloggningsaktiviteter finns i Visa aktivitet för hanterad identitet.
Nästa steg
I den här artikeln har du lärt dig hur du uppgraderar operativsystemets version för Windows-arbetsbelastningar i AKS. Mer information om Windows-arbetsbelastningar i AKS finns i Distribuera ett Windows-containerprogram på Azure Kubernetes Service (AKS).