Update CHANGELOG.md#5820
Open
wdarko1 wants to merge 7 commits into
Open
Conversation
Add NAP related updated for Machine API Integration
Clarified Node Auto Provisioning (NAP) changes regarding machine manager role and deletion policies in the changelog.
Contributor
There was a problem hiding this comment.
Pull request overview
Updates the AKS changelog to document new Node Auto Provisioning (NAP) capabilities and behavioral changes related to Machine API integration, so customers can understand new supported scenarios and upcoming cluster behavior changes.
Changes:
- Added NAP feature notes for custom Linux OS settings and AMD GPU SKU support via
AKSNodeClass. - Added NAP behavioral changes covering label restrictions, Machine API representation, subnet/identity constraints, and upcoming node naming changes.
xuexu6666
reviewed
Jun 10, 2026
Revise details on machine api node pool name in NAP clusters
Added information about mixed SKU autoscaling in Virtual Machine node pools to the changelog.
Corrected capitalization of 'Nvidia' to 'NVIDIA' and made minor grammatical adjustments in the changelog.
| * AKS now allows migration from the `managedNATGatewayV2` outbound type to the `block` and `none` outbound types, supporting [network-isolated cluster](https://learn.microsoft.com/azure/aks/concepts-network-isolated) scenarios. Migration to other outbound types remains blocked. | ||
| * AKS now validates pod CIDR ranges during cluster create and update for kubenet and [Azure CNI Overlay](https://learn.microsoft.com/azure/aks/azure-cni-overlay) clusters. Clusters can no longer be created or updated with a pod CIDR that overlaps with reserved IP ranges (`172.30.0.0/16`, `172.31.0.0/16`), preventing potential in-cluster networking failures. Existing clusters with an overlapping pod CIDR are unaffected. See [CNI prerequisites](https://learn.microsoft.com/azure/aks/concepts-network-cni-overview#prerequisites). | ||
| * AKS now rejects [Calico NPM and Azure NPM](https://learn.microsoft.com/azure/aks/use-network-policies) install and uninstall operations on clusters running Kubernetes versions earlier than 1.30. Requests are rejected at the API level with a descriptive error directing customers to upgrade to a newer supported Kubernetes version before retrying. Existing clusters already using Calico NPM or Azure NPM are unaffected. | ||
| * Use of specific labels for AKS nodes is restricted from user input, including `agentpool`, `storageprofile`, `storagetier`, `accelerator`, and labels with a prefix of `kubernetes.azure.com/`. New subscriptions using NAP are no longer able to select these labels, and existing subscriptions will be restricted on 30 September 2026. For more information, see [Azure Karpenter Provider Issue #1707](https://github.com/Azure/karpenter-provider-azure/issues/1707). |
| * AKS now validates pod CIDR ranges during cluster create and update for kubenet and [Azure CNI Overlay](https://learn.microsoft.com/azure/aks/azure-cni-overlay) clusters. Clusters can no longer be created or updated with a pod CIDR that overlaps with reserved IP ranges (`172.30.0.0/16`, `172.31.0.0/16`), preventing potential in-cluster networking failures. Existing clusters with an overlapping pod CIDR are unaffected. See [CNI prerequisites](https://learn.microsoft.com/azure/aks/concepts-network-cni-overview#prerequisites). | ||
| * AKS now rejects [Calico NPM and Azure NPM](https://learn.microsoft.com/azure/aks/use-network-policies) install and uninstall operations on clusters running Kubernetes versions earlier than 1.30. Requests are rejected at the API level with a descriptive error directing customers to upgrade to a newer supported Kubernetes version before retrying. Existing clusters already using Calico NPM or Azure NPM are unaffected. | ||
| * Use of specific labels for AKS nodes is restricted from user input, including `agentpool`, `storageprofile`, `storagetier`, `accelerator`, and labels with a prefix of `kubernetes.azure.com/`. New subscriptions using NAP are no longer able to select these labels, and existing subscriptions will be restricted on 30 September 2026. For more information, see [Azure Karpenter Provider Issue #1707](https://github.com/Azure/karpenter-provider-azure/issues/1707). | ||
| * Node Auto Provisioning (NAP) managed clusters will now include a managed machines-mode node pool named `aksmanagedap`. This machine node pool is used to represent each NAP managed virtual machine instance. This node pool cannot be user-deleted, and will be deleted during NAP-disable. |
| * AKS now rejects [Calico NPM and Azure NPM](https://learn.microsoft.com/azure/aks/use-network-policies) install and uninstall operations on clusters running Kubernetes versions earlier than 1.30. Requests are rejected at the API level with a descriptive error directing customers to upgrade to a newer supported Kubernetes version before retrying. Existing clusters already using Calico NPM or Azure NPM are unaffected. | ||
| * Use of specific labels for AKS nodes is restricted from user input, including `agentpool`, `storageprofile`, `storagetier`, `accelerator`, and labels with a prefix of `kubernetes.azure.com/`. New subscriptions using NAP are no longer able to select these labels, and existing subscriptions will be restricted on 30 September 2026. For more information, see [Azure Karpenter Provider Issue #1707](https://github.com/Azure/karpenter-provider-azure/issues/1707). | ||
| * Node Auto Provisioning (NAP) managed clusters will now include a managed machines-mode node pool named `aksmanagedap`. This machine node pool is used to represent each NAP managed virtual machine instance. This node pool cannot be user-deleted, and will be deleted during NAP-disable. | ||
| * The cluster identity of Node Auto Provisioning (NAP) enabled clusters will now have a `machine manager` role granted. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Update May 2026 release note with
NAP changes
agentpool,storageprofile,storagetier,accelerator, and labels with a prefix ofkubernetes.azure.com. Breaking change for existing subscriptions will happen Sept 30.VM Node Pools