Edit

Share via

Quickstart: Enable Azure Linux 3.0 for Azure Kubernetes Service (AKS) clusters and node pools (Preview)

  • Article

This article shows you how to enable Azure Linux 3.0 as the default Azure Linux node OS for new AKS clusters and node pools running AKS version 1.31. Once enabled, any new AKS clusters or node pools created with the --os-sku=AzureLinux option defaults to using Azure Linux 3.0.

Limitations

  • Not supported on Kubernetes version 1.30 and below.
  • Existing clusters or node pools running Azure Linux 2.0 can't be upgraded to 3.0. New node pools or clusters need to be created.
  • Azure Linux 3.0 FIPS image is in preview and is FIPS compliant but not verified as the crypto modules are Modules in Process with NIST.
  • Supported Regions: Azure Linux 3.0 support is in preview as part of the v20241025 release. Visit the AKS Release Tracker for the latest on which regions are on this release.

Enable Azure Linux 3.0 as default for new clusters and nodepools

Important

AKS preview features are available on a self-service, opt-in basis. Previews are provided "as is" and "as available," and they're excluded from the service-level agreements and limited warranty. AKS previews are partially covered by customer support on a best-effort basis. As such, these features aren't meant for production use. For more information, see the following support articles:

  1. Register the AzureLinuxV3Preview feature flag using the az feature register command.

     az feature register --namespace "Microsoft.ContainerService" --name "AzureLinuxV3Preview"

    It takes a few minutes for the status to show Registered.

  2. Verify the registration status using the az feature show command.

    az feature show --namespace "Microsoft.ContainerService" --name "AzureLinuxV3Preview"

  3. Once these steps are completed, you can deploy the cluster using the method of your choice to use Azure Linux 3.0 as the node OS:

Disable Azure Linux 3.0

  1. Unregister the AzureLinuxV3Preview feature flag using the az feature unregister command. 
    az feature unregister --namespace "Microsoft.ContainerService" --name "AzureLinuxV3Preview"
  2. Refresh the registration of the Microsoft.ContainerService resource provider using the az provider register command. 
    az provider register --namespace "Microsoft.ContainerService"

Next steps

For more information about Azure Linux 3.0 Preview, see What's new with Azure Linux 3.0?.