Skip to content

Commit 86992de

Browse files
authored
Sync release-ash-2501 with main
Sync release-ash-2501 with main
2 parents 94486e7 + 0433961 commit 86992de

22 files changed

+121
-98
lines changed

AKS-Arc/aks-arc-diagnostic-checker.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -102,7 +102,7 @@ $urlArray = @(
102102
"https://login.windows.net",
103103
"https://mcr.microsoft.com",
104104
"https://gbl.his.arc.azure.com",
105-
"https://k8connecthelm.azureedge.net",
105+
"https://k8connecthelm.download.prss.microsoft.com",
106106
"https://guestnotificationservice.azure.com",
107107
"https://sts.windows.net",
108108
"https://graph.microsoft.com"

AKS-Arc/aks-vmware-networking-concepts.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -89,8 +89,8 @@ For deployment and operation of Kubernetes clusters, the following URLs must be
8989
|linuxgeneva-microsoft.azurecr.io | HTTPS/443 |
9090
|gcr.io | HTTPS/443 |
9191
|aka.ms | HTTPS/443 |
92-
|k8connecthelm.azureedge.net | HTTPS/443 |
93-
|k8sconnectcsp.azureedge.net | HTTPS/443 |
92+
|k8connecthelm.download.prss.microsoft.com | HTTPS/443 |
93+
|k8sconnectcsp.download.prss.microsoft.com | HTTPS/443 |
9494
|.blob.core.windows.net | HTTPS/443 |
9595

9696
## Next steps

AKS-Arc/create-clusters-terraform.md

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Learn how to create Kubernetes clusters using Terraform.
44
author: sethmanheim
55
ms.author: sethm
66
ms.topic: how-to
7-
ms.date: 11/15/2024
7+
ms.date: 02/10/2025
88

99
---
1010

@@ -51,7 +51,11 @@ To create an SSH key pair (same as Azure AKS), use the following procedure:
5151

5252
## Sign in to Azure
5353

54-
Terraform only supports authenticating to Azure with the Azure CLI. Authenticating using Azure PowerShell isn't supported. Therefore, while you can use the Azure PowerShell module when doing your Terraform work, you must first [authenticate to Azure](/azure/developer/terraform/authenticate-to-azure).
54+
Terraform only supports authenticating to Azure with the Azure CLI using [`az login`](/cli/azure/reference-index#az-login). Authenticating using Azure PowerShell isn't supported. Therefore, while you can use the Azure PowerShell module when doing your Terraform work, you must first [authenticate to Azure](/azure/developer/terraform/authenticate-to-azure):
55+
56+
```azurecli
57+
az login
58+
```
5559

5660
## Implement the Terraform code
5761

@@ -114,9 +118,9 @@ Run [`terraform init`](https://www.terraform.io/docs/commands/init.html) to
114118
terraform init -upgrade
115119
```
116120

117-
## Create a Terraform execution plan and apply the plan
121+
## Create a Terraform execution plan and apply
118122

119-
Run[terraform plan](https://www.terraform.io/docs/commands/plan.html)to create an execution plan, then run[terraform apply](https://www.terraform.io/docs/commands/apply.html)to apply the output file to your cloud infrastructure:
123+
Make sure you run [`az login`](/cli/azure/reference-index#az-login) and authenticate to Azure before this step, otherwise applying the Terraform plan fails. Run [`terraform plan`](https://www.terraform.io/docs/commands/plan.html) to create an execution plan, then run [`terraform apply`](https://www.terraform.io/docs/commands/apply.html) to apply the output file to your cloud infrastructure:
120124

121125
```terraform
122126
terraform plan -out main.tfplan

AKS-Arc/includes/data-allow-table.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ ms.lastreviewed: 08/15/2022
2020
| \<region>.dp.kubernetesconfiguration.azure.com | 443 | Required to onboard AKS hybrid clusters to Azure Arc. |
2121
| gbl.his.arc.azure.com | 443 | Required to get the regional endpoint for pulling system-assigned Managed Identity certificates. |
2222
| \*.his.arc.azure.com | 443 | Required to pull system-assigned Managed Identity certificates. |
23-
| k8connecthelm.azureedge.net | 443 | Arc-enabled Kubernetes uses Helm 3 to deploy Azure Arc agents on the AKS on Azure Local management cluster. This endpoint is needed for the Helm client download to facilitate deployment of the agent helm chart. |
23+
| k8connecthelm.download.prss.microsoft.com | 443 | Arc-enabled Kubernetes uses Helm 3 to deploy Azure Arc agents on the AKS on Azure Local management cluster. This endpoint is needed for the Helm client download to facilitate deployment of the agent helm chart. |
2424
| \*.arc.azure.net| 443 | Required to manage AKS Arc clusters in the Azure portal. |
2525
| dl.k8s.io | 443 | Required to download and update Kubernetes binaries for Azure Arc. |
2626
| akshci.azurefd.net | 443 | Required for AKS on Azure Local billing when running `Install-AksHci`. |

AKS-Arc/supported-kubernetes-versions.md

Lines changed: 11 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -3,10 +3,10 @@ title: Supported Kubernetes versions for AKS enabled by Azure Arc
33
description: Understand the Kubernetes version support policy and lifecycle of clusters for Azure Kubernetes Service enabled by Azure Arc.
44
services: container-service
55
ms.topic: article
6-
ms.date: 11/22/2024
6+
ms.date: 02/10/2025
77
author: sethmanheim
88
ms.author: sethm
9-
ms.lastreviewed: 1/14/2022
9+
ms.lastreviewed: 02/10/2025
1010
ms.reviewer: abha
1111

1212
# Intent: As an IT Pro, I want to know how Kubernetes versions are supported, as well as the lifecycle of clusters in AKS enabled by Azure Arc.
@@ -40,16 +40,22 @@ You should install the latest patch release of the minor version you're running.
4040

4141
## AKS Arc Kubernetes release calendar
4242

43-
The following table lists the current supported Kubernetes released versions on AKS Arc:
44-
45-
| K8s version | Supported Azure Local versions | Current status | Last release with Kubernetes patch/CVE updates |
43+
| K8s minor version | Supported Azure Local versions | Current status | Last release with Kubernetes patch/CVE updates |
4644
|--------------|-------------------|--------------|------------|
4745
| 1.30 | TBD | Upcoming | TBD |
4846
| 1.29 | [2411](aks-whats-new-23h2.md#features-and-improvements), [2408](aks-whats-new-23h2.md#release-2408) | Generally available | TBD |
4947
| 1.28 | [2411](aks-whats-new-23h2.md#features-and-improvements), [2408](aks-whats-new-23h2.md#release-2408), [2405](aks-whats-new-23h2.md#release-2405) | Generally available | TBD |
5048
| 1.27 | [2411](aks-whats-new-23h2.md#features-and-improvements), [2408](aks-whats-new-23h2.md#release-2408), [2405](aks-whats-new-23h2.md#release-2405), 2402 | Generally available | 2411 release |
5149
| 1.26 | [2405](aks-whats-new-23h2.md#release-2405), 2402 and older | No more patch versions/CVE updates | 2405 release |
5250

51+
### AKS Arc supported Kubernetes minor and patch versions per release
52+
53+
| Release | Supported minor & patch versions |
54+
|---------------------|--------------------------------------------------|
55+
| 2411 | 1.27.7, 1.27.9, 1.28.5, 1.28.9, 1.29.2, 1.29.4 |
56+
| 2408 | 1.27.7, 1.27.9, 1.28.5, 1.28.9, 1.29.2, 1.29.4 |
57+
| 2405 | 1.26.10, 1.26.12, 1.27.7, 1.27.9, 1.28.3, 1.28.5 |
58+
5359
## Kubernetes version support policy
5460

5561
AKS defines a generally available (GA) version as a version that's available for download when deploying or updating AKS enabled by Arc. AKS supports three GA minor versions of Kubernetes:

azure-local/concepts/compare-vm-management-capabilities.md

Lines changed: 25 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Learn about the kinds of virtual machines (VMs) that can run on Azu
44
ms.topic: conceptual
55
author: ManikaDhiman
66
ms.author: v-manidhiman
7-
ms.date: 02/04/2025
7+
ms.date: 02/07/2025
88
---
99

1010
# Compare management capabilities of Azure Local VMs
@@ -48,7 +48,13 @@ The following table compares the provisioning and management methods for the var
4848

4949
The following table compares the management capabilities for Arc VMs, Arc-enabled servers, and non-Arc VMs across various operations and features available through the Azure portal:
5050

51-
|Management capability|Arc VMs|Arc-enabled servers|Non-Arc VMs|
51+
> [!IMPORTANT]
52+
> Keep in mind the following information when comparing VM management capabilities:
53+
>- Microsoft Product Terms for your program override this section. For more information, see [Microsoft Azure Product Terms](https://www.microsoft.com/licensing/#products) and select your program to show the terms.
54+
>- Some services, even if included in Azure Hybrid Benefits, may incur operational costs, such as storing log data. For more information, see [Azure Pricing calculator](https://azure.microsoft.com/pricing/calculator/).
55+
>- Some key features are part of the Windows Server Management enabled by Azure Arc experience. For more information, see [Windows Server Management enabled by Azure Arc](/azure/azure-arc/servers/windows-server-management-overview?tabs=portal).
56+
57+
|Azure VM management capability|Arc VMs|Arc-enabled servers|Non-Arc VMs|
5258
|:-----|:-----:|:-----:|:-----:|
5359
| **Settings** |
5460
| - Start||||
@@ -75,12 +81,13 @@ The following table compares the management capabilities for Arc VMs, Arc-enable
7581
| - Automanage ||||
7682
| - Run command ||||
7783
| - SQL Server Configuration ||||
78-
| - Updates | ✅ <br>(free) | ✅ <br>(additional cost) ||
79-
| - Inventory ||||
80-
| - Change tracking ||||
84+
| - Azure Update Manager | ✅ <br>[3](#3) | ✅ <br>[1](#1) and [2](#2) ||
85+
| - Inventory ||✅ <br>[1](#1) and [2](#2) ||
86+
| - Change tracking ||✅ <br>[1](#1) and [2](#2) ||
87+
| - Extended Security Updates | ✅ <br>[3](#3) | ✅ <br>[3](#3) ||
8188
| **Windows management** |
82-
| - Windows Admin Center ||||
83-
| - Best Practices Assessment ||||
89+
| - Windows Admin Center || <br>[1](#1) and [2](#2) ||
90+
| - Best Practices Assessment || <br>[1](#1) and [2](#2) ||
8491
| **Monitoring** |
8592
| - Azure Monitor ||||
8693
| - Insights||||
@@ -94,6 +101,17 @@ The following table compares the management capabilities for Arc VMs, Arc-enable
94101
| - Export template ||||
95102
| - Resource health |❌ <br>(Use Alerts) |||
96103

104+
105+
<!--- 1: at additional costs.
106+
- [^2]: included as part of Windows Server and SQL Server management capabilities enabled by Azure Arc. For more information, see [Azure Hybrid Benefits for Windows Server](/windows-server/get-started/azure-hybrid-benefit?tabs=azure).
107+
- [^3]: included for VMs running on Azure and Azure Local instances.-->
108+
109+
<a name="1"></a>1: At additional costs.
110+
111+
<a name="2"></a>2: Included as part of Windows Server and SQL Server management capabilities enabled by Azure Arc. For more information, see [Azure Hybrid Benefits for Windows Server](/windows-server/get-started/azure-hybrid-benefit?tabs=azure).
112+
113+
<a name="3"></a>3: Included for VMs running on Azure and Azure Local instances.
114+
97115
## Next steps
98116

99117
- Review [Azure Arc VM management prerequisites](../manage/azure-arc-vm-management-prerequisites.md).

azure-local/deploy/azure-verification.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ ms.topic: overview
77
ms.custom:
88
- devx-track-azurepowershell
99
ms.reviewer: jlei
10-
ms.date: 10/22/2024
10+
ms.date: 02/03/2025
1111
ms.lastreviewed: 03/05/2024
1212
ms.service: azure-local
1313
---
@@ -18,9 +18,9 @@ ms.service: azure-local
1818

1919
Microsoft Azure offers a range of differentiated workloads and capabilities that are designed to run only on Azure. Azure Local extends many of the same benefits you get from Azure, while running on the same familiar and high-performance on-premises or edge environments.
2020

21-
*Azure verification for VMs* makes it possible for supported Azure-exclusive workloads to work outside of the cloud. This feature, modeled after the [IMDS attestation](/azure/virtual-machines/windows/instance-metadata-service?tabs=windows#attested-data) service in Azure, is a built-in platform attestation service that is enabled by default on Azure Local, version 23H2 or later. It helps to provide guarantees for these VMs to operate in other Azure environments.
21+
*Azure verification for VMs* makes it possible for supported Azure-exclusive workloads to work outside of the cloud. This feature, modeled after the [IMDS attestation](/azure/virtual-machines/windows/instance-metadata-service?tabs=windows#attested-data) service in Azure, is a built-in platform attestation service that is enabled by default on Azure Local. It helps to provide guarantees for these VMs to operate in other Azure environments.
2222

23-
For more information about the previous version of this feature on Azure Local, version 22H2 or earlier, see [Azure Benefits on Azure Local](../manage/azure-benefits.md).
23+
For more information about the previous version of this feature, version 22H2 or earlier, see [Azure Benefits on Azure Local](../manage/azure-benefits.md).
2424

2525
## Benefits available on Azure Local
2626

@@ -39,14 +39,14 @@ Azure verification for VM enables you to use these benefits available only on Az
3939
4040
## Manage Azure VM verification
4141

42-
Azure VM verification is automatically enabled by default in Azure Local, version 23H2 or later. The following instructions outline the prerequisites for using this feature and steps for managing benefits (optional).
42+
Azure VM verification is automatically enabled by default in Azure Local. The following instructions outline the prerequisites for using this feature and steps for managing benefits (optional).
4343

4444
> [!NOTE]
4545
> To enable Extended Security Updates (ESUs), you must do additional setup and turn on [legacy OS support](#legacy-os-support).
4646
4747
### Host prerequisites
4848

49-
- Make sure that you have access to Azure Local, version 23H2. All machines must be online, registered, and the system deployed. For more information, see [Register your machines with Arc](./deployment-arc-register-server-permissions.md) and see [Deploy via Azure portal](deploy-via-portal.md).
49+
- Make sure that you have access to Azure Local. All machines must be online, registered, and the system deployed. For more information, see [Register your machines with Arc](./deployment-arc-register-server-permissions.md) and see [Deploy via Azure portal](deploy-via-portal.md).
5050
- [Install Hyper-V and RSAT-Hyper-V-Tools](/windows-server/virtualization/hyper-v/get-started/install-the-hyper-v-role-on-windows-server).
5151
- (Optional) If you're using Windows Admin Center, you must install Cluster Manager extension (version 2.319.0) or later.
5252

@@ -341,9 +341,9 @@ No. Turning on Azure VM verification incurs no extra fees.
341341

342342
No. Azure VM verification is a feature built into Azure Local, and can only be used on Azure Local.
343343

344-
### If I just upgraded to version 23H2 from 22H2, and I previously turned on the Azure Benefits feature, do I need to do anything new?
344+
### If I just upgraded from 22H2, and I previously turned on the Azure Benefits feature, do I need to do anything new?
345345

346-
If you upgraded a system that previously had [Azure Benefits on Azure Local](../manage/azure-benefits.md) set up for your workloads, you don't need to do anything when you upgrade to Azure Local, version 23H2. When you upgrade, the feature remains enabled, and legacy OS support is turned on as well. However, if you want to use an improved way of doing VM-to-host communication through VM Bus in version 23H2, make sure that you have the required [host prerequisites](#host-prerequisites) and the [VM prerequisites](#vm-prerequisites).
346+
If you upgraded a system that previously had [Azure Benefits on Azure Local](../manage/azure-benefits.md) set up for your workloads, you don't need to do anything when you upgrade to Azure Local. When you upgrade, the feature remains enabled, and legacy OS support is turned on as well. However, if you want to use an improved way of doing VM-to-host communication through VM Bus, make sure that you have the required [host prerequisites](#host-prerequisites) and the [VM prerequisites](#vm-prerequisites).
347347

348348
### I just set up Azure VM verification on my system. How do I ensure that Azure VM verification stays active?
349349

azure-local/deploy/deploy-via-portal.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Deploy an Azure Local instance using the Azure portal
33
description: Learn how to deploy an Azure Local instance from the Azure portal
44
author: alkohli
55
ms.topic: how-to
6-
ms.date: 11/07/2024
6+
ms.date: 02/10/2025
77
ms.author: alkohli
88
ms.service: azure-local
99
#CustomerIntent: As an IT Pro, I want to deploy an Azure Local instance of 1-16 machines via the Azure portal so that I can host VM and container-based workloads on it.
@@ -238,6 +238,10 @@ If your deployment fails, you can rerun the deployment. In your Azure Local inst
238238

239239
After the deployment is complete, you may need to perform some additional tasks to secure your system and ensure it's ready for workloads.
240240

241+
### Enable Health monitoring
242+
243+
To monitor storage pool consumption, use the steps in [Enable health alerts](../manage/health-alerts-via-azure-monitor-alerts.md) to receive alerts in Azure portal. An alert is created when the storage pool reaches 70%.
244+
241245
### Enable RDP
242246

243247
For security reasons, Remote Desktop Protocol (RDP) is disabled and the local administrator renamed after the deployment completes on Azure Local instances. For more information on the renamed administrator, go to [Local builtin user accounts](../concepts/other-security-features.md#about-local-built-in-user-accounts).

azure-local/deploy/sdn-express-23h2.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Deploy an SDN infrastructure using SDN Express for Azure Local, version 2
33
description: Learn to deploy an SDN infrastructure using SDN Express for Azure Local, version 23h2.
44
author: alkohli
55
ms.topic: how-to
6-
ms.date: 01/16/2025
6+
ms.date: 02/07/2025
77
ms.author: alkohli
88
ms.reviewer: anirbanpaul
99
---
@@ -185,7 +185,8 @@ The SDN Express script deploys your specified SDN infrastructure. When the scrip
185185
1. Run the following command from a user account with administrative credentials for the host machines:
186186

187187
```powershell
188-
.\SDNExpress.ps1 -ConfigurationDataFile MultiNodeSampleConfig.psd1 -Verbose
188+
$cred=Get-credential
189+
.\SDNExpress.ps1 -ConfigurationDataFile MultiNodeSampleConfig.psd1 -DomainJoinCredential $cred -NCCredential $cred -LocalAdminCredential $cred -Verbose
189190
```
190191
191192
1. After the NC VMs are created, configure dynamic DNS updates for the Network Controller cluster name on the DNS server. For more information, see [Dynamic DNS updates](../concepts/network-controller.md#dynamic-dns-updates).

azure-local/manage/azure-arc-vm-management-prerequisites.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,8 @@ author: alkohli
55
ms.author: alkohli
66
ms.topic: how-to
77
ms.service: azure-local
8-
ms.date: 01/08/2025
8+
ms.date: 02/03/2025
9+
910
---
1011

1112
# Azure Arc VM management prerequisites
@@ -43,7 +44,7 @@ For Arc VM images to be used on Azure Local, make sure to satisfy the following
4344

4445
## Firewall requirements
4546

46-
Make sure the requirements as listed in [Required firewall URLs for Azure Local, version 23H2 deployments](../concepts/firewall-requirements.md#required-firewall-urls-for-azure-local-version-23h2-deployments) are satisfied to allow communication between the Arc VMs running on Azure Local and Azure Arc.
47+
Make sure the requirements as listed in [Required firewall URLs for Azure Local deployments](../concepts/firewall-requirements.md#required-firewall-urls-for-azure-local-version-23h2-deployments) are satisfied to allow communication between the Arc VMs running on Azure Local and Azure Arc.
4748

4849
## Azure Command-Line Interface (CLI) requirements
4950

0 commit comments

Comments
 (0)