You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
- You can create an Arc gateway resource using Azure CLI or the Azure portal. For more information about how to create an Arc gateway resource for your AKS clusters and Azure Local, see [create the Arc gateway resource in Azure](/hci/deploy/deployment-azure-arc-gateway-overview#create-the-arc-gateway-resource-in-azure). When you create the Arc gateway resource, get the gateway resource ID by running the following command:
46
+
- You can create an Arc gateway resource using Azure CLI or the Azure portal. For more information about how to create an Arc gateway resource for your AKS clusters and Azure Local, see [create the Arc gateway resource in Azure](/azure/azure-local/deploy/deployment-azure-arc-gateway-overview?tabs=portal#create-the-arc-gateway-resource-in-azure). When you create the Arc gateway resource, get the gateway resource ID by running the following command:
47
47
48
48
```azurecli
49
49
$gatewayId = "(az arcgateway show --name <gateway's name> --resource-group <resource group> --query id -o tsv)"
@@ -57,7 +57,7 @@ Ensure your Arc gateway URL and all of the URLs below are allowed through your e
57
57
|---------|---------|
58
58
|`[Your URL prefix].gw.arc.azure.com`| Your gateway URL. You can obtain this URL by running `az arcgateway list` after you create the resource. |
59
59
|`management.azure.com`|Azure Resource Manager endpoint, required for the Azure Resource Manager control channel. |
60
-
|`<region>.obo.arc.azure.com`|Required when [Cluster connect](conceptual-cluster-connect.md) is configured. |
60
+
|`<region>.obo.arc.azure.com`|Required when Cluster Connect is configured. |
61
61
|`login.microsoftonline.com`, `<region>.login.microsoft.com`| Microsoft Entra ID endpoint, used for acquiring identity access tokens. |
62
62
|`gbl.his.arc.azure.com`, `<region>.his.arc.azure.com`|The cloud service endpoint for communicating with Arc Agents. Uses short names; for example `eus` for East US. |
63
63
|`mcr.microsoft.com`, `*.data.mcr.microsoft.com`|Required to pull container images for Azure Arc agents. |
When you install Azure Local, three virtual hard disks (VHDs) - Azure Linux, Windows Server 2019 and Windows Server 2022 - are automatically downloaded. VHDs are needed to deploy AKS on Azure Local because they serve as the base operating system images for the Kubernetes nodes within your AKS cluster. For a mixed-OS environment (both Windows and Linux nodes), a Windows Server 2019 or Windows Server 2022 VHD is necessary for provisioning a Windows Server 2019, or 2022 nodepool. The Linux nodepool uses the Azure Linux VHD that's been optimized for running Kubernetes. In environments where only Linux containers are being used, however, the Windows VHD is unnecessary, and disabling the Windows nodepool feature helps avoid downloading and storing this large file, saving bandwidth and storage space.
17
+
When you install Azure Local, three virtual hard disks (VHDs) - Azure Linux, Windows Server 2019 and Windows Server 2022 - are automatically downloaded. VHDs are needed to deploy AKS on Azure Local because they serve as the base operating system images for the Kubernetes nodes within your AKS cluster. For a mixed-OS environment (both Windows and Linux nodes), a Windows Server 2019 or Windows Server 2022 VHD is necessary for provisioning a Windows Server 2019, or 2022 nodepool. The Linux nodepool uses the Azure Linux VHD optimized for running Kubernetes. In environments where only Linux containers are being used, however, the Windows VHD is unnecessary, and disabling the Windows nodepool feature helps avoid downloading and storing this large file, saving bandwidth and storage space.
18
18
19
19
This how-to article walks you through how to disable the Windows nodepool feature for Azure Kubernetes Service (AKS) on Azure Local. Disabling this feature prevents the automatic download of Windows Virtual Hard Disks (VHDs), which are approximately 20 GB in size and required for creating Windows-based nodepools. By doing so, enterprises with limited internet bandwidth can avoid unnecessary downloads, especially if their workloads are exclusively using Linux containers. This feature helps optimize bandwidth usage and simplifies resource management for environments where Windows nodes are not needed.
20
20
@@ -25,7 +25,7 @@ Before you begin, make sure you have the following prerequisites in place:
25
25
-**Azure Local deployed**: This article is only applicable if you already deployed Azure Local. You cannot run the commands in this article before you deploy Azure Local. We currently do not support the ability to make this change before the initial Azure Local deployment.
26
26
-**Custom Location ID**: Azure Resource Manager ID of the custom location. The custom location is configured during the Azure Local deployment. If you're in the Azure portal, go to the **Overview > Server** page in the Azure Stack HCI system resource. You should see a custom location for your cluster.
27
27
-**Azure resource group**: The Azure resource group where Azure Local is deployed.
28
-
- Azure RBAC permissions to update Azure Stack HCI configuration. Make sure you have the following roles. For more information, see [required permissions for deployment](/hci/deploy/deployment-arc-register-server-permissions?tabs=powershell#assign-required-permissions-for-deployment):
28
+
- Azure RBAC permissions to update Azure Stack HCI configuration. Make sure you have the following roles. For more information, see [required permissions for deployment](/azure/azure-local/deploy/deployment-arc-register-server-permissions?tabs=powershell#assign-required-permissions-for-deployment):
29
29
- Azure Stack HCI Administrator
30
30
- Reader
31
31
@@ -37,10 +37,10 @@ Set the custom location and the resource group values in environment variables.\
37
37
38
38
```azurecli
39
39
$customlocationID = <The custom location ARM ID for Azure Local>
40
-
$resourceGroup = <The Azure resource group where Azure Local has been deployed>
40
+
$resourceGroup = <The Azure resource group where Azure Local is deployed>
41
41
```
42
42
43
-
Next, run the following command to obtain the `clusterName` parameter. This parameter is the name of the Arc Resource Bridge that is deployed on Azure Local:
43
+
Next, run the following command to obtain the `clusterName` parameter. This parameter is the name of the Arc Resource Bridge that you deployed on Azure Local:
44
44
45
45
```azurecli
46
46
az customlocation show -n $customlocationID -g $resourceGroup --query hostResourceId
In this output, `sanjose-arcbridge` is the name of the Arc resource bridge that's deployed on the Azure local cluster. This name is different for your deployment.
55
+
In this output, `sanjose-arcbridge` is the name of the Arc resource bridge you deployed on the Azure local cluster. This name is different for your deployment.
56
56
57
57
```azurecli
58
58
$clusterName = <Name of Arc resource bridge deployed on the Azure Local cluster>
59
59
```
60
60
61
-
Next, obtain the name of the AKS Arc extension that's deployed to the custom location. To get this name, run the following command to list the extensions installed on the custom location:
61
+
Next, obtain the name of the AKS Arc extension you deployed to the custom location. To get this name, run the following command to list the extensions installed on the custom location:
62
62
63
63
```azurecli
64
64
az customlocation show -n $customlocationID -g $resourceGroup --query clusterExtensionIds -o tsv
@@ -74,7 +74,7 @@ Expected output:
74
74
You should have two extensions installed on your custom location: AKS Arc and Arc VM management. Copy the extension name for AKS into an environment variable. In the example output, the extension name is `hybridaksextension`. It might be different from what you see:
75
75
76
76
```azurecli
77
-
$extensionName = <Name of AKS Arc extension that's been deployed on the custom location>
77
+
$extensionName = <Name of AKS Arc extension you deployed on the custom location>
78
78
```
79
79
80
80
Once you have the extension name, create variables for the following parameters.
0 commit comments