Skip to content

Commit f189310

Browse files
Merge pull request #17616 from v-sissondan/arc-gateway-ov
Arc gateway overview - Cristian updates
2 parents 66a875f + f21e2b6 commit f189310

File tree

1 file changed

+16
-19
lines changed

1 file changed

+16
-19
lines changed

azure-local/deploy/deployment-azure-arc-gateway-overview.md

Lines changed: 16 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Overview of Azure Arc gateway for Azure Local, version 23H2 (preview)
33
description: Learn what is Azure Arc gateway for Azure Local, version 23H2 (preview).
44
author: alkohli
55
ms.topic: how-to
6-
ms.date: 02/20/2025
6+
ms.date: 04/10/2025
77
ms.author: alkohli
88
ms.service: azure-local
99
---
@@ -12,15 +12,13 @@ ms.service: azure-local
1212

1313
::: moniker range=">=azloc-24111"
1414

15-
> Applies to: Azure Local 2411.1 and later
15+
> Applies to: Azure Local version 2411.1 and later
1616
1717
[!INCLUDE [azure-local-banner-23h2](../includes/azure-local-banner-23h2.md)]
1818

1919
This article provides an overview of the Azure Arc gateway for Azure Local. The Arc gateway can be enabled on new deployments of Azure Local running software version 2408 and later. This article also describes how to create and delete the Arc gateway resource in Azure.
2020

21-
You can use the Arc gateway to significantly reduce the number of required endpoints needed to deploy and manage Azure Local instances. Once you create the Arc gateway, you can connect to and use it for new deployments of Azure Local.
22-
23-
For information on how to deploy the Azure Arc gateway for standalone servers (not Azure Local machines), see [Simplify network configuration requirements through Azure Arc gateway](/azure/azure-arc/servers/arc-gateway).
21+
You can use the Arc gateway to significantly reduce the number of required endpoints needed to deploy and manage Azure Local instances. When you create the Arc gateway, you can connect to and use it for new deployments of Azure Local.
2422

2523
[!INCLUDE [important](../includes/hci-preview.md)]
2624

@@ -32,7 +30,7 @@ The Arc gateway works by introducing the following components:
3230

3331
- **Arc proxy** – A new component that is added to the Arc Agentry. This component runs as a service (Called the **Azure Arc Proxy**) and works as a forward proxy for the Azure Arc agents and extensions. The gateway router doesn't need any configuration from your side. This router is part of the Arc core agentry and runs within the context of an Arc-enabled resource.
3432

35-
Once you integrate the Arc gateway with release 2411 of Azure Local deployments, each machine gets Arc proxy along with other Arc Agents.
33+
When you integrate the Arc gateway with version 2411 of Azure Local deployments, each machine gets Arc proxy along with other Arc Agents.
3634

3735
When Arc gateway is used, the *http* and *https* traffic flow changes as follows:
3836

@@ -52,11 +50,11 @@ When Arc gateway is used, the *http* and *https* traffic flow changes as follows
5250

5351
1. With the proxy settings in place, ARB, and AKS outbound traffic is forwarded to Arc Proxy running on one of the Azure Local machines over the routable IP.
5452

55-
1. Once the traffic reaches Arc proxy, the remaining flow takes the same path as described. If traffic to the target service is allowed, it is sent to Arc gateway. If not, it is sent to the enterprise proxy (or direct outbound if no proxy set). Note that for AKS specifically, this path is used for downloading docker images for Arc Agentry and Arc Extension Pods.
53+
1. Once the traffic reaches Arc proxy, the remaining flow takes the same path as described. If traffic to the target service is allowed, it is sent to Arc gateway. If not, it is sent to the enterprise proxy (or direct outbound if no proxy set). For AKS specifically, this path is used for downloading docker images for Arc Agentry and Arc Extension Pods.
5654

57-
**Traffic flow for Arc VMs**
55+
**Traffic flow for Azure Local VMs**
5856

59-
*Http* and *https* traffic are forwarded to the enterprise proxy. Arc proxy inside the Arc VM is not yet supported in this version.
57+
*Http* and *https* traffic are forwarded to the enterprise proxy. Arc proxy inside an Azure Local VM enabled by Arc is not yet supported in this version.
6058

6159
Traffic flows are illustrated in the following diagram:
6260

@@ -83,12 +81,11 @@ The list of supported endpoints by the Arc gateway in Azure Local will increase
8381
You can use the Arc gateway in the following scenario for Azure Local versions 2411.1 or later:
8482

8583
- Enable Arc gateway during deployment of new Azure Local instances running versions 2411.1 or later.
84+
- The Arc gateway resource must be created on the same subscription where you are planning to deploy your Azure Local instance.
8685

87-
Unsupported scenarios for Azure Local, versions 2408, 2411 and 2411.1 include:
88-
89-
- Azure Local instances updated from versions 2402 or 2405 to versions 2408 or 2411 can't take advantage of all the new endpoints supported by this Arc gateway preview. Host components, Arc extensions, ARB, and AKS required endpoints are only supported when enabling the Arc gateway as part of a new version 2408 deployment.
86+
Unsupported scenarios for Azure Local include:
9087

91-
- Enabling Arc gateway after deployment cannot take advantage of all the new endpoints supported by this Arc gateway preview. Host, Arc extensions, ARB, and AKS required endpoints are only supported when enabling the Arc gateway as part of a new deployment.
88+
- Enabling Arc gateway after deployment is not supported.
9289

9390
## Azure Local endpoints not redirected
9491

@@ -139,15 +136,15 @@ You can create an Arc gateway resource using the Azure portal, Azure CLI, or Azu
139136

140137
1. Sign in to [Azure portal](https://ms.portal.azure.com/).
141138
1. Go to the **Azure Arc > Azure Arc gateway** page, then select **Create**.
142-
1. Select the subscription and resource group where you want the Arc gateway resource to be managed within Azure. An Arc gateway resource can be used by any Arc-enabled resource in the same Azure tenant.
139+
1. Select the subscription where you are planning to deploy your Azure Local instance.
143140
1. For **Name**, enter the name for the Arc gateway resource.
144-
1. For **Location**, enter the region where the Arc gateway resource should live. An Arc gateway resource can be used by any Arc-enabled resource in the same Azure tenant.
141+
1. For **Location**, enter the region where the Arc gateway resource should live. An Arc gateway resource is used by any Arc-enabled resource in the same Azure tenant.
145142
1. Select **Next**.
146143
1. On the **Tags** page, specify one or more custom tags to support your standards.
147144
1. Select **Review & Create**.
148145
1. Review your details, and then select **Create**.
149146

150-
The gateway creation process takes nine to ten minutes to complete.
147+
The gateway creation process takes nine to 10 minutes to complete.
151148

152149

153150
# [CLI](#tab/cli)
@@ -184,10 +181,10 @@ The gateway creation process takes 9-10 minutes to complete.
184181

185182
## Detach or change the Arc gateway association from the machine
186183

187-
To detach the gateway resource from your Arc-enabled server, set the gateway resource ID to `null`. If you want to attach your Arc-enabled server to another Arc gateway resource just update the name and resource ID with the new Arc gateway information:
184+
To detach the gateway resource from your Arc-enabled server, set the gateway resource ID to `null`. To attach your Arc-enabled server to another Arc gateway resource just update the name and resource ID with the new Arc gateway information:
188185

189186
```azurecli
190-
az arcgateway settings update --resource-group <Resource Group> --subscription <subscription name> --base-provider Microsoft.HybridCompute --base-resource-type machines --base-resource-name <Arc-Server's name> --gateway-resource-id "
187+
az arcgateway settings update --resource-group <Resource Group> --subscription <subscription name> --base-provider Microsoft.HybridCompute --base-resource-type machines --base-resource-name <Arc-enabled server name> --gateway-resource-id "
191188
```
192189

193190
## Delete the Arc gateway resource
@@ -212,6 +209,6 @@ This operation can take a couple of minutes.
212209

213210
::: moniker range="<=azloc-24111"
214211

215-
This feature is available only in Azure Local 2411.1 or later.
212+
This feature is available only in Azure Local version 2411.1 or later.
216213

217214
::: moniker-end

0 commit comments

Comments
 (0)