Skip to content

Commit 42a944e

Browse files
authored
Sync release-local-disconnectednew with main
Sync release-local-disconnectednew with main
2 parents 8dfcb90 + 25091c3 commit 42a944e

File tree

4 files changed

+16
-9
lines changed

4 files changed

+16
-9
lines changed

AKS-Arc/aks-hci-network-system-requirements.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,11 +2,11 @@
22
title: AKS enabled by Azure Arc network requirements
33
description: Learn about AKS network prerequisites.
44
ms.topic: overview
5-
ms.date: 04/23/2025
5+
ms.date: 07/02/2025
66
author: sethmanheim
77
ms.author: sethm
8-
ms.reviewer: abha
9-
ms.lastreviewed: 04/02/2024
8+
ms.reviewer: srikantsarwa
9+
ms.lastreviewed: 07/10/2025
1010
---
1111

1212
# AKS enabled by Azure Arc network requirements
@@ -42,7 +42,7 @@ The following parameters are required in order to use a logical network for AKS
4242

4343
### Control plane IP
4444

45-
Kubernetes uses a control plane to ensure every component in the Kubernetes cluster is kept in the desired state. The control plane also manages and maintains the worker nodes that hold the containerized applications. AKS enabled by Arc deploys the KubeVIP load balancer to ensure that the API server IP address of the Kubernetes control plane is available at all times. This KubeVIP instance requires a single immutable "control plane IP address" to function correctly. AKS Arc automatically chooses a control plane IP for you from the logical network passed during the Kubernetes cluster create operation.
45+
Kubernetes uses a control plane to ensure every component in the Kubernetes cluster is kept in the desired state. The control plane also manages and maintains the worker nodes that hold the containerized applications. AKS enabled by Arc deploys the KubeVIP load balancer to ensure that the API server IP address of the Kubernetes control plane is always available. This KubeVIP instance requires a single immutable "control plane IP address" to function correctly. AKS Arc automatically chooses a control plane IP for you from the logical network passed during the Kubernetes cluster create operation.
4646

4747
You also have the option of passing a control plane IP. In such cases, the control plane IP must be within the scope of the address prefix of the logical network. You must ensure that the control plane IP address does not overlap with anything else, including Arc VM logical networks, infrastructure network IPs, load balancers, etc. Overlapping IP addresses can lead to unexpected failures for both the AKS cluster and any other place the IP address is being used. You must plan to reserve one IP address per Kubernetes cluster in your environment.
4848

@@ -73,7 +73,7 @@ Firewall requirements for AKS have been consolidated with Azure Local firewall r
7373

7474
## DNS server settings
7575

76-
You need to ensure that the DNS server of the logical network can resolve the FQDN of the Azure Local cluster. DNS name resolution is required for all Azure Local nodes to be able to communicate with the AKS VM nodes.
76+
You need to ensure that the DNS server of the logical network can resolve the FQDN of the Azure Local cluster. DNS name resolution is required for all Azure Local nodes to be able to communicate with the AKS VM nodes.
7777

7878
## Network port and cross-VLAN requirements
7979

AKS-Arc/ssh-connect-to-windows-and-linux-worker-nodes.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Connect to Windows or Linux worker nodes with SSH
33
description: Learn how to use SSH to connect to Windows or Linux worker nodes in an AKS Arc cluster.
4-
ms.date: 07/02/2025
4+
ms.date: 07/10/2025
55
ms.topic: how-to
66
author: sethmanheim
77
ms.author: sethm
@@ -39,6 +39,8 @@ You can use the Kubernetes CLI, [**kubectl**](https://kubernetes.io/docs/referen
3939
Install-AzAksCliTool
4040
```
4141

42+
---
43+
4244
## Use SSH to connect to worker nodes
4345

4446
1. To access the Kubernetes cluster with the specified permissions, you must retrieve the certificate-based admin **kubeconfig** file using the [az aksarc get-credentials](/cli/azure/aksarc#az-aksarc-get-credentials) command. For more information, see [Retrieve certificate-based admin kubeconfig](retrieve-admin-kubeconfig.md):

azure-local/includes/hci-vm-image-prerequisites-storage-account.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ author: alkohli
33
ms.author: alkohli
44
ms.service: azure-local
55
ms.topic: include
6-
ms.date: 07/18/2024
6+
ms.date: 07/08/2025
77
---
88

99

@@ -16,4 +16,4 @@ ms.date: 07/18/2024
1616
- Make sure that you're uploading your VHD or VHDX as a page blob image into the Storage account. Only page blob images are supported to create VM images via the Storage account.
1717
- If using a VHDX:
1818
- The VHDX image must be Gen 2 type and secure boot enabled.
19-
- The VHDX image must be prepared using `sysprep /generalize /shutdown /oobe`. For more information, see [Sysprep command-line options](/windows-hardware/manufacture/desktop/sysprep-command-line-options?view=windows-11#oobe&preserve-view=true).
19+
- The VHDX image must be prepared using `sysprep /generalize /shutdown /oobe`. For more information, see [Sysprep command-line options](/windows-hardware/manufacture/desktop/sysprep-command-line-options?view=windows-11#oobe&preserve-view=true). This is true for both Windows and Linux VM images.

azure-local/manage/virtual-machine-image-existing-arc-vm.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ ms.author: alkohli
66
ms.topic: how-to
77
ms.service: azure-local
88
ms.custom: devx-track-azurecli
9-
ms.date: 03/27/2025
9+
ms.date: 07/08/2025
1010
---
1111

1212
# Create Azure Local VM image using existing Azure Local VMs enabled by Azure Arc
@@ -21,12 +21,17 @@ Before you begin, make sure that:
2121

2222
- You've reviewed and completed the [Azure Local VM management prerequisites](./azure-arc-vm-management-prerequisites.md).
2323
- You've connected to your Azure Local using the instructions in [Connect to Azure Local via Azure CLI client](./azure-arc-vm-management-prerequisites.md#azure-command-line-interface-cli-requirements).
24+
- The VHDX image must be prepared using `sysprep /generalize /shutdown /oobe`. For more information, see [Sysprep command-line options](/windows-hardware/manufacture/desktop/sysprep-command-line-options#oobe). This is true for both Windows and Linux VM images.
25+
- The source VM must be powered off before attempting to create the VM image.
2426

2527

2628
## Create VM image from existing Azure Local VM
2729

2830
You create a VM image starting from the OS disk of the Azure Local VM and then use this image to deploy VMs on your Azure Local.
2931

32+
> [!IMPORTANT]
33+
> Running Sysprep on an Azure Local VM will render the VM unusable. Sysprep resets system identity, removes user profiles, may invalidate Windows product activation, and can cause instability for applications that rely on machine-specific configuration. This action is irreversible.
34+
3035
Follow these steps to create a VM image using the Azure CLI.
3136

3237
### Sign in and set subscription

0 commit comments

Comments
 (0)