Sync release-hotfixes with main

Sync release-hotfixes with main

Author: sethmanheim

azure-local/concepts/firewall-requirements.md

@@ -113,7 +113,7 @@ Ensure that the following firewall rules are configured in your on-premises fire
 
 | Rule | Action | Source | Destination | Service | Ports |
 |:--|:--|:--|:--|:--|:--|
-| Allow inbound/outbound connectivity to the Active Directory Web services (ADWS) and Active Directory Management Gateway Service | Allow | Active Directory Services | Azure Local | TCP | 9389 |
+| Allow inbound/outbound connectivity to the Active Directory Web services (ADWS) and Active Directory Management Gateway Service | Allow | Azure Local | Active Directory Services | TCP | 9389 |
 
 ### Network Time Protocol
 
@@ -198,4 +198,4 @@ This section shows how to configure Microsoft Defender firewall to allow IP addr
 For more information, see also:
 
 - The Windows Firewall and WinRM 2.0 ports section of [Installation and configuration for Windows Remote Management](/windows/win32/winrm/installation-and-configuration-for-windows-remote-management#windows-firewall-and-winrm-20-ports).
-- [About Azure Local deployment](../deploy/deployment-introduction.md).
+- [About Azure Local deployment](../deploy/deployment-introduction.md).

azure-local/includes/hci-registration-azure-prerequisites.md

@@ -3,7 +3,7 @@ author: alkohli
 ms.author: alkohli
 ms.service: azure-local
 ms.topic: include
-ms.date: 03/20/2025
+ms.date: 04/02/2025
 ms.reviewer: alkohli
 ms.lastreviewed: 03/20/2025
 ---
@@ -22,7 +22,8 @@ ms.lastreviewed: 03/20/2025
    Register-ResourceProviderIfRequired -ProviderNamespace "Microsoft.KubernetesConfiguration" 
    Register-ResourceProviderIfRequired -ProviderNamespace "Microsoft.ExtendedLocation" 
    Register-ResourceProviderIfRequired -ProviderNamespace "Microsoft.ResourceConnector" 
-   Register-ResourceProviderIfRequired -ProviderNamespace "HybridContainerService" 
+   Register-ResourceProviderIfRequired -ProviderNamespace "HybridContainerService"
+   Register-ResourceProviderIfRequired -ProviderNamespace "Microsoft.Attestation"
    ```
 
     > [!NOTE]

azure-local/known-issues.md

@@ -3,7 +3,7 @@ title: Release notes with fixed and known issues in Azure Local
 description: Read about the known issues and fixed issues in Azure Local.
 author: alkohli
 ms.topic: conceptual
-ms.date: 03/31/2025
+ms.date: 04/01/2025
 ms.author: alkohli
 ms.reviewer: alkohli
 ---
@@ -39,6 +39,7 @@ The following table lists the fixed issues in this release:
 
 |Feature|Issue|Workaround/Comments|
 |------|------|----------|
+| Azure Local VMs | Intermittent failures or timeouts when creating or deleting Azure Local VMs due to internal service entering a deadlocked state. | You can now deploy Azure Local VMs without facing timeout issues. |
 | Azure Local VMs <!--ADO--> | Unable to delete a gallery image if the source Azure Local VM gallery image was created from, was deleted.| You can now delete a gallery image even if the source Azure Local VM the gallery image was created from, was deleted.|
 | Azure Local VMs <!--ADO--> | After Azure Arc resource bridge disaster recovery, some Azure Local VMs may lose network connectivity. | Updated Azure Arc resource bridge disaster recovery logic to ensure network configurations of Azure Local VMs persists. |
 | Azure Local VMs <!--ADO--> | Inaccurate power state reporting on Azure for Azure Local VMs when the source image for the VM is deleted from the cluster.  | Power operations shows consistent and accurate power state representation on Azure for Azure Local VMs with deleted source images.  |

azure-local/migrate/migration-options-overview.md

@@ -3,7 +3,7 @@ title: Options for migrating virtual machines to Azure Local (preview)
 description: Learn about how to choose a migration option to migrate VM workloads to your Azure Local (preview).
 author: alkohli
 ms.topic: overview
-ms.date: 11/13/2024
+ms.date: 04/02/2025
 ms.author: alkohli
 ms.reviewer: alkohli
 ---
@@ -51,11 +51,11 @@ Manual migration options are provided by Microsoft. These options are available
 
 The following manual migration options are available:
 
-- [Migrate VMs manually to same hardware](../deploy/migrate-cluster-same-hardware.md): This option is used when you want to migrate a Windows Server failover cluster to Azure Local using your existing hardware. This process installs the new operating system for Azure Local and retains your existing cluster settings and storage, and imports your VMs.
+- [Migrate VMs manually to same hardware](migrate-cluster-same-hardware.md): This option is used when you want to migrate a Windows Server failover cluster to Azure Local using your existing hardware. This process installs the new operating system for Azure Local and retains your existing cluster settings and storage, and imports your VMs.
 
-- [Migrate VMs manually to new hardware](../deploy/migrate-cluster-new-hardware.md): This option is used when you want to migrate VMs from an existing Windows Server 2016 or later cluster to a new Azure Local instance. You migrate the VMs to the same hardware using PowerShell and Robocopy.
+- [Migrate VMs manually to new hardware](migrate-cluster-new-hardware.md): This option is used when you want to migrate VMs from an existing Windows Server 2016 or later cluster to a new Azure Local instance. You migrate the VMs to the same hardware using PowerShell and Robocopy.
 
-    If you have VMs on Windows 2012 R2 or older that you want to migrate, see [Migrating older VMs](../deploy/migrate-cluster-new-hardware.md#migrating-older-vms).
+    If you have VMs on Windows 2012 R2 or older that you want to migrate, see [Migrating older VMs](migrate-cluster-new-hardware.md#migrating-older-vms).
 
 
 

azure-local/plan/configure-custom-settings-active-directory.md

@@ -66,7 +66,7 @@ $DeploymentUser="deploymentuser"
 #Assign required permissions
 $userSecurityIdentifier = Get-ADuser -Identity $Deploymentuser
 $userSID = [System.Security.Principal.SecurityIdentifier] $userSecurityIdentifier.SID
-$acl = Get-Acl -Path $ouPath
+$acl = Get-Acl -Path "AD:$ouPath"
 $userIdentityReference = [System.Security.Principal.IdentityReference] $userSID
 $adRight = [System.DirectoryServices.ActiveDirectoryRights]::CreateChild -bor [System.DirectoryServices.ActiveDirectoryRights]::DeleteChild
 $genericAllRight = [System.DirectoryServices.ActiveDirectoryRights]::GenericAll
@@ -86,7 +86,7 @@ $rule3 = New-Object System.DirectoryServices.ActiveDirectoryAccessRule($userIden
 $acl.AddAccessRule($rule1)
 $acl.AddAccessRule($rule2)
 $acl.AddAccessRule($rule3)
-Set-Acl -Path $ouPath -AclObject $acl
+Set-Acl -Path "AD:$ouPath" -AclObject $acl
 ```
 
 ## Required DNS records
@@ -162,4 +162,4 @@ Get-NetAdapter "vManagement*"|Set-DnsClient -RegisterThisConnectionsAddress $fal
 
 Proceed to:
 - [Download the Azure Stack HCI OS software](../deploy/download-23h2-software.md).
-- [Install the Azure Stack HCI OS software](../deploy/deployment-install-os.md).
+- [Install the Azure Stack HCI OS software](../deploy/deployment-install-os.md).

azure-stack/user/kubernetes-aks-engine-release-notes.md

@@ -51,9 +51,10 @@ Download the new versions of the AKS base Ubuntu image and AKS engine.
 As explained in the documentation for AKS engine for Azure Stack Hub, deploying a Kubernetes cluster requires:
 
 - The **aks-engine** binary (required).
-- AKS Base Ubuntu 16.04-LTS Image Distro (deprecated - no longer use, change in API Model to use 20.04 instead).
-- AKS Base Ubuntu 18.04-LTS Image Distro (deprecated - no longer use, change in API Model to use 20.04 instead).
-- AKS Base Ubuntu 20.04-LTS Image Distro (required for Linux agents).
+- AKS Base Ubuntu 16.04-LTS Image Distro (deprecated - no longer use, change in API Model to use 22.04 instead).
+- AKS Base Ubuntu 18.04-LTS Image Distro (deprecated - no longer use, change in API Model to use 22.04 instead).
+- AKS Base Ubuntu 20.04-LTS Image Distro (deprecated - no longer use, change in API Model to use 22.04 instead).
+- AKS Base Ubuntu 22.04-LTS Image Distro (required for Linux agents).
 - AKS Base Windows Server Image (one of the following images is required for Windows agents):
   - AKS Base Windows Server Image Containerd.
   - AKS Base Windows Server Image Docker.
@@ -70,9 +71,9 @@ New versions of these images are available with this update:
 
 Starting with AKS Engine v0.63.0, the Ubuntu 16.04 distro is no longer a supported option, as the OS has reached its end-of-life. For AKS Engine v0.67.0 or later versions, the **aks-engine** upgrade automatically overwrites the unsupported `aks-ubuntu-16.04` distro value with with `aks-ubuntu-18.04`. For AKS Engine v0.75.3 or later versions, if you're using Kubernetes v1.24 or above, the **aks-engine-azurestack** upgrade automatically overwrites the unsupported `aks-ubuntu-16.04` distro value with `aks-ubuntu-20.04`.
 
-### Upgrading Kubernetes clusters created with the Ubuntu 18.04 distro
+### Upgrading Kubernetes clusters created with the Ubuntu 18.04 or 20.04 distro
 
-Starting with AKS Engine v0.75.3, the Ubuntu 18.04 distro is no longer a supported option, as the OS has reached its end-of-life. For AKS Engine v0.75.3 or later versions, the **aks-engine-azurestack** upgrade automatically overwrites the unsupported `aks-ubuntu-18.04` distro value with `aks-ubuntu-20.04`.
+Starting with AKS Engine v0.75.3, the Ubuntu 18.04 distro is no longer a supported option, as the OS has reached its end-of-life. Starting with AKS Engine v0.82.1, the Ubuntu 20.04 distro is no longer a supported option. For these AKS Engine versions, the **aks-engine-azurestack** upgrade automatically overwrites the unsupported `aks-ubuntu-18.04` or `aks-ubuntu-20.04` distro value with `aks-ubuntu-20.04` or `aks-ubuntu-22.04`, respectively.
 
 ### Upgrading Kubernetes clusters created with docker container runtime
 
@@ -94,8 +95,9 @@ For AKS Engine release v0.75.3, clusters with Windows nodes on Kubernetes v1.23
 | 2301                                           | 0.75.3, 0.76.0, 0.77.0, 0.78.0, 0.79.0 |
 | 2306                                           | 0.78.0, 0.79.0, 0.80.2 |
 | 2311                                           | 0.80.2 |
-| 2406                                           | 0.80.2, 0.80.3*, 0.81.1* |
-| 2408                                           | 0.80.2, 0.80.3*, 0.81.1* |
+| 2406                                           | 0.80.2, 0.80.3, 0.81.1 |
+| 2408                                           | 0.80.2, 0.80.3, 0.81.1*, 0.82.1* |
+| 2501                                           | 0.81.1*, 0.82.1* |
 
 *Supported. See the [AKS Engine Version Support policy](azure-stack-kubernetes-aks-engine-support.md#version-support) for more information.
 
@@ -124,7 +126,8 @@ You can find the supported Kubernetes versions for AKS Engine on Azure Stack Hub
 | [v0.79.0](https://github.com/Azure/aks-engine-azurestack/releases/tag/v0.79.0)   | [AKS Base Ubuntu 20.04-LTS Image Distro (2023.296.1)](https://github.com/Azure/aks-engine-azurestack/blob/v0.79.0/vhd/release-notes/aks-engine-ubuntu-2004/aks-engine-azurestack-ubuntu-2004_2023.296.1.txt), [AKS Base Windows Server 2019 Image Containerd (17763.4974.20232961)](https://github.com/Azure/aks-engine-azurestack/blob/v0.79.0/vhd/release-notes/aks-windows-2019-containerd/2019-datacenter-core-azurestack-ctrd-17763.4974.20232961.txt) | 1.26.9**, 1.27.6** | API Model Samples ([Linux](https://github.com/Azure/aks-engine-azurestack/blob/af3e6b25e6304f7c68eb90965b8e9a36887cb457/examples/azure-stack/kubernetes-azurestack.json), [Windows](https://github.com/Azure/aks-engine-azurestack/blob/af3e6b25e6304f7c68eb90965b8e9a36887cb457/examples/azure-stack/kubernetes-windows.json)) |
 | [v0.80.2](https://github.com/Azure/aks-engine-azurestack/releases/tag/v0.80.2)   | [AKS Base Ubuntu 20.04-LTS Image Distro (2024.032.1)](https://github.com/Azure/aks-engine-azurestack/blob/v0.80.2/vhd/release-notes/aks-engine-ubuntu-2004/aks-engine-azurestack-ubuntu-2004_2024.032.1.txt), [AKS Base Windows Server 2019 Image Containerd (17763.5329.20240321)](https://github.com/Azure/aks-engine-azurestack/blob/v0.80.2/vhd/release-notes/aks-windows-2019-containerd/2019-datacenter-core-azurestack-ctrd-17763.5329.20240321.txt) | 1.27.10**, 1.28.6** | API Model Samples ([Linux](https://github.com/Azure/aks-engine-azurestack/blob/96b45e116aef6ae2e5031561b0e10621ae86a068/examples/azure-stack/kubernetes-azurestack.json), [Windows](https://github.com/Azure/aks-engine-azurestack/blob/96b45e116aef6ae2e5031561b0e10621ae86a068/examples/azure-stack/kubernetes-windows.json)) |
 | [v0.80.3](https://github.com/Azure/aks-engine-azurestack/releases/tag/v0.80.3)   | [AKS Base Ubuntu 20.04-LTS Image Distro (2024.032.1)](https://github.com/Azure/aks-engine-azurestack/blob/v0.80.2/vhd/release-notes/aks-engine-ubuntu-2004/aks-engine-azurestack-ubuntu-2004_2024.032.1.txt), [AKS Base Windows Server 2019 Image Containerd (17763.5329.20240321)](https://github.com/Azure/aks-engine-azurestack/blob/v0.80.2/vhd/release-notes/aks-windows-2019-containerd/2019-datacenter-core-azurestack-ctrd-17763.5329.20240321.txt) | 1.27.10**, 1.28.6** | API Model Samples ([Linux](https://github.com/Azure/aks-engine-azurestack/blob/96b45e116aef6ae2e5031561b0e10621ae86a068/examples/azure-stack/kubernetes-azurestack.json), [Windows](https://github.com/Azure/aks-engine-azurestack/blob/96b45e116aef6ae2e5031561b0e10621ae86a068/examples/azure-stack/kubernetes-windows.json)) |
-| [v0.81.1](https://github.com/Azure/aks-engine-azurestack/releases/tag/v0.81.1)   | [AKS Base Ubuntu 20.04-LTS Image Distro (2024.311.1)](https://github.com/Azure/aks-engine-azurestack/blob/master/vhd/release-notes/aks-engine-ubuntu-2004/aks-engine-azurestack-ubuntu-2004_2024.311.1.txt), [AKS Base Windows Server 2019 Image Containerd (17763.6414.20243111)](https://github.com/Azure/aks-engine-azurestack/blob/master/vhd/release-notes/aks-windows-2019-containerd/2019-datacenter-core-azurestack-ctrd-17763.6414.20243111.txt) | 1.28.15**, 1.29.10** | API Model Samples ([Linux](https://github.com/Azure/aks-engine-azurestack/blob/master/examples/azure-stack/kubernetes-azurestack.json), [Windows](https://github.com/Azure/aks-engine-azurestack/blob/master/examples/azure-stack/kubernetes-windows.json)) |
+| [v0.81.1](https://github.com/Azure/aks-engine-azurestack/releases/tag/v0.81.1)   | [AKS Base Ubuntu 20.04-LTS Image Distro (2024.311.1)](https://github.com/Azure/aks-engine-azurestack/blob/master/vhd/release-notes/aks-engine-ubuntu-2004/aks-engine-azurestack-ubuntu-2004_2024.311.1.txt), [AKS Base Windows Server 2019 Image Containerd (17763.6414.20243111)](https://github.com/Azure/aks-engine-azurestack/blob/master/vhd/release-notes/aks-windows-2019-containerd/2019-datacenter-core-azurestack-ctrd-17763.6414.20243111.txt) | 1.28.15**, 1.29.10** | API Model Samples ([Linux](https://github.com/Azure/aks-engine-azurestack/blob/0ea7973bb1826b7607086d4741b73313d72ce256/examples/azure-stack/kubernetes-azurestack.json), [Windows](https://github.com/Azure/aks-engine-azurestack/blob/0ea7973bb1826b7607086d4741b73313d72ce256/examples/azure-stack/kubernetes-windows.json)) |
+| [v0.82.1](https://github.com/Azure/aks-engine-azurestack/releases/tag/v0.82.1)   | [AKS Base Ubuntu 20.04-LTS Image Distro (2025.079.2)](https://github.com/Azure/aks-engine-azurestack/blob/master/vhd/release-notes/aks-engine-ubuntu-2204/aks-engine-azurestack-ubuntu-2204_2025.079.2.txt), [AKS Base Windows Server 2019 Image Containerd (17763.7009.20250792)](https://github.com/Azure/aks-engine-azurestack/blob/master/vhd/release-notes/aks-windows-2019-containerd/2019-datacenter-core-azurestack-ctrd-17763.7009.20250792.txt) | 1.29.15**, 1.30.10** | API Model Samples ([Linux](https://github.com/Azure/aks-engine-azurestack/blob/master/examples/azure-stack/kubernetes-azurestack.json), [Windows](https://github.com/Azure/aks-engine-azurestack/blob/master/examples/azure-stack/kubernetes-windows.json)) |
 
 > [!NOTE]  
 > *Starting from Kubernetes v1.21, only the [Cloud Provider for Azure](https://github.com/Azure/aks-engine-azurestack/blob/master/docs/topics/azure-stack.md#cloud-provider-for-azure) is supported on Azure Stack Hub.
@@ -136,6 +139,12 @@ You can find the supported Kubernetes versions for AKS Engine on Azure Stack Hub
 
 The AKS engine `upgrade` command fully automates the upgrade process of your cluster, and handles virtual machines (VMs), networking, storage, Kubernetes, and orchestration tasks. Before applying the update, make sure to review the release note information.
 
+### What's new in AKSe 0.82.1
+
+- Added support for Kubernetes 1.29.15 and 1.30.10.
+- AKS Engine release v0.82.1 on Azure Stack Hub offers Ubuntu 22.04 LTS as its Linux base image. Starting with this release, Ubuntu 20.04 is no longer supported.
+- You can find other features at [the v0.82.1 GitHub page](https://github.com/Azure/aks-engine-azurestack/releases/tag/v0.82.1).
+
 ### What's new with AKSe 0.76.0
 
 - Added support for Kubernetes v1.24.11 and v1.25.7.
@@ -196,6 +205,7 @@ The following list is the complete set of release notes for Azure and Azure Stac
 - https://github.com/Azure/aks-engine-azurestack/releases/tag/v0.80.2
 - https://github.com/Azure/aks-engine-azurestack/releases/tag/v0.80.3
 - https://github.com/Azure/aks-engine-azurestack/releases/tag/v0.81.1
+- https://github.com/Azure/aks-engine-azurestack/releases/tag/v0.82.1
 
 ::: moniker-end