Skip to content

Commit 4968cdd

Browse files
Merge pull request #18345 from CristianEdwards/Arcgwregupdate
Arc gateway registration update - No need for authentication parameters anymore starting with 2505 new deployments.
2 parents 3cba865 + 4dc7140 commit 4968cdd

File tree

3 files changed

+9
-34
lines changed

3 files changed

+9
-34
lines changed

azure-local/deploy/deployment-azure-arc-gateway-configure-manually.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ 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 2411, 2503 and 2504 new deployments. Starting with 2505, there is no need to configure the proxy manually anymore. Please refer to [Deploy with Arc gateway via Arc script](/azure-local/deploy/deployment-azure-arc-gateway-configure-via-script.md) if you are using an enterprise proxy, or refer to [Deploy with Arc gateway without proxy](/azure-local/deploy/deployment-azure-arc-gateway-use-without-proxy.md) if you don't use an enterprise proxy.
1616

1717
After creating the Arc gateway resource in your Azure subscription, you can enable the new Arc gateway preview features. This article details how to manually configure the Arc proxy before Arc registration.
1818

azure-local/deploy/deployment-azure-arc-gateway-configure-via-script.md

Lines changed: 5 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -10,9 +10,9 @@ ms.service: azure-local
1010

1111
# Configure Arc proxy via registration script for Azure gateway on Azure Local (preview)
1212

13-
::: moniker range=">=azloc-24111"
13+
::: moniker range=">=azloc-2505"
1414

15-
Applies to: Azure Local 2411.1 and later
15+
Applies to: Azure Local 2505 and later
1616

1717
After creating the Arc gateway resource in your Azure subscription, you can enable the new Arc gateway preview features. This article details how to configure the Arc proxy before Arc registration using a registration script for the Arc gateway on Azure Local.
1818

@@ -24,7 +24,7 @@ Using this method, you don't need to configure the Arc proxy across WinInet, Win
2424

2525
Make sure the following prerequisites are met before proceeding:
2626

27-
- You've access to an Azure Local instance running release 2411.1 or later. Prior versions do not support this scenario.
27+
- You've access to an Azure Local instance running release 2505 or later. Prior versions do not support this scenario.
2828

2929
- An Arc gateway resource created in the same subscription as used to deploy Azure Local. For more information, see [Create the Arc gateway resource in Azure](deployment-azure-arc-gateway-overview.md#create-the-arc-gateway-resource-in-azure).
3030

@@ -34,8 +34,7 @@ You need the proxy and the ArcGatewayID from Azure to run the registration scrip
3434

3535
## Step 2: Register new machines in Azure Arc
3636

37-
To register new version 2408 or version 2411 machines in Azure Arc, you run
38-
the initialization script by passing the `ArcGatewayID`, `Proxy server`, and `Proxy bypass list` parameters.
37+
To register version 2505 or later Azure Local machines in Azure Arc, you run the initialization script by passing the `ArcGatewayID`, `Proxy server`, and `Proxy bypass list` parameters. During the bootstrap configuration you will be required to authenticate with your credentials using the device code.
3938

4039
Here's an example of how you should change these parameters for the `Invoke-AzStackHciArcInitialization` initialization script. Once registration is completed, the Azure Local machines are registered in Azure Arc using the Arc gateway:
4140

@@ -46,9 +45,6 @@ $Subscription = "yoursubscription"
4645
#Define the resource group where you want to register your server as Arc device.
4746
$RG = "yourresourcegroupname"
4847
49-
#Define the tenant to use to register your server as Arc device.
50-
$Tenant = "yourtenant"
51-
5248
#Define Proxy Server if necessary
5349
$ProxyServer = "http://x.x.x.x:port"
5450
@@ -64,17 +60,8 @@ $ArcgwId = "/subscriptions/yourarcgatewayid/resourceGroups/yourresourcegroupname
6460
6561
$ProxyBypassList = "localhost,127.0.0.1,*.contoso.com,machine1,machine2,machine3,machine4,machine5,192.168.*.*,AzureLocal-1"
6662
67-
#Connect to your Azure account and Subscription
68-
Connect-AzAccount -SubscriptionId $Subscription -TenantId $Tenant -DeviceCode
69-
70-
#Get the Access Token and Account ID for the registration
71-
$ARMtoken = (Get-AzAccessToken).Token
72-
73-
#Get the Account ID for the registration
74-
$id = (Get-AzContext).Account.Id
75-
7663
#Invoke the registration script with Proxy and ArcgatewayID
77-
Invoke-AzStackHciArcInitialization -SubscriptionID $Subscription -ResourceGroup $RG -TenantID $Tenant -Region australiaeast -Cloud "AzureCloud" -ArmAccessToken $ARMtoken -AccountID $id -Proxy $ProxyServer -ArcGatewayID $ArcgwId -ProxyBypass $ProxyBypassList
64+
Invoke-AzStackHciArcInitialization -SubscriptionID $Subscription -ResourceGroup $RG -Region australiaeast -Cloud "AzureCloud" -Proxy $ProxyServer -ArcGatewayID $ArcgwId -ProxyBypass $ProxyBypassList
7865
```
7966

8067
## Step 3: Verify that the setup succeeded

azure-local/deploy/deployment-azure-arc-gateway-use-without-proxy.md

Lines changed: 3 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -10,9 +10,9 @@ ms.service: azure-local
1010

1111
# Use Azure Arc gateway without a proxy on Azure Local (preview)
1212

13-
::: moniker range=">=azloc-24111"
13+
::: moniker range=">=azloc-2505"
1414

15-
> Applies to: Azure Local 2411.1 and later
15+
> Applies to: Azure Local 2505 and later
1616
1717
After creating the Arc gateway resource in your Azure subscription, you can enable the new Arc gateway preview features on your Azure Local. This article details how to use Azure gateway for Azure Local instances without a proxy.
1818

@@ -44,23 +44,11 @@ $Subscription = "yoursubscription"
4444
#Define the resource group where you want to register your server as Arc device.
4545
$RG = "yourresourcegroupname"
4646
47-
#Define the tenant you will use to register your server as Arc device.
48-
$Tenant = "yourtenant"
49-
5047
#Define the Arc gateway resource ID from Azure
5148
$ArcgwId = "/subscriptions/yourarcgatewayid/resourceGroups/yourresourcegroupname/providers/Microsoft.HybridCompute/gateways/yourarcgatewayname"
5249
53-
#Connect to your Azure account and Subscription
54-
Connect-AzAccount -SubscriptionId $Subscription -TenantId $Tenant -DeviceCode
55-
56-
#Get the Access Token and Account ID for the registration
57-
$ARMtoken = (Get-AzAccessToken).Token
58-
59-
#Get the Account ID for the registration
60-
$id = (Get-AzContext).Account.Id
61-
6250
#Invoke the registration script with Proxy and ArcgatewayID
63-
Invoke-AzStackHciArcInitialization -SubscriptionID $Subscription -ResourceGroup $RG -TenantID $Tenant -Region australiaeast -Cloud "AzureCloud" -ArmAccessToken $ARMtoken -AccountID $id -ArcGatewayID $ArcgwId
51+
Invoke-AzStackHciArcInitialization -SubscriptionID $Subscription -ResourceGroup $RG -Region australiaeast -Cloud "AzureCloud" -ArcGatewayID $ArcgwId
6452
```
6553

6654
## Step 3: Start Azure Local cloud deployment

0 commit comments

Comments
 (0)