Azure Local에서 Azure 게이트웨이에 대한 등록 스크립트를 통해 Arc 프록시 구성(미리 보기)

2025-07-03

적용 대상: Azure Local 2505 이상

Azure 구독에서 Arc 게이트웨이 리소스를 만든 후 새 Arc 게이트웨이 미리 보기 기능을 사용하도록 설정할 수 있습니다. 이 문서에서는 Azure Local의 Arc 게이트웨이에 대한 등록 스크립트를 사용하여 Arc 등록 전에 Arc 프록시를 구성하는 방법을 자세히 설명합니다.

이 메서드를 사용하면 WinInet, WinHttp 또는 환경 변수에서 Arc 프록시를 수동으로 구성할 필요가 없습니다.

중요한

이 기능은 현재 미리 보기로 제공됩니다. 베타, 미리 보기 또는 아직 일반 공급으로 릴리스되지 않은 Azure 기능에 적용되는 법적 용어는 Microsoft Azure 미리 보기에 대한 추가 사용 약관 을 참조하세요.

필수 조건

계속하기 전에 다음 필수 구성 요소가 충족되는지 확인합니다.

릴리스 2505 이상을 실행하는 Azure 로컬 인스턴스에 액세스할 수 있습니다. 이전 버전은 이 시나리오를 지원하지 않습니다.
Azure Local을 배포하는 데 사용되는 것과 동일한 구독에서 만든 Arc 게이트웨이 리소스입니다. 자세한 내용은 Azure에서 Arc 게이트웨이 리소스 만들기를 참조하세요.

1단계: ArcGatewayID 가져오기

Azure 로컬 머신에서 등록 스크립트를 실행하려면 Azure의 프록시 및 ArcGatewayID가 필요합니다. 리소스의 Azure Portal 개요 페이지에서 Arc 게이트웨이 ID를 찾을 수 있습니다.

2단계: Azure Arc에 새 머신 등록

Azure Arc에 버전 2505 이상 Azure 로컬 머신을 등록하려면 , 및 Proxy bypass list 매개 변수를 전달하여 초기화 스크립트를 ArcGatewayIDProxy server실행합니다. 부트스트랩 구성 중에는 디바이스 코드를 사용하여 자격 증명으로 인증해야 합니다.

다음은 초기화 스크립트에 대해 이러한 매개 변수를 변경하는 방법의 예입니다 Invoke-AzStackHciArcInitialization . 등록이 완료되면 Arc 게이트웨이를 사용하여 Azure 로컬 머신이 Azure Arc에 등록됩니다.

#Define the subscription where you want to register your server as Arc device.
$Subscription = "yoursubscription" 

#Define the resource group where you want to register your server as Arc device.
$RG = "yourresourcegroupname" 

#Define Proxy Server if necessary 
$ProxyServer = "http://x.x.x.x:port" 

#Define the Arc gateway resource ID from Azure 
$ArcgwId = "/subscriptions/yourarcgatewayid/resourceGroups/yourresourcegroupname/providers/Microsoft.HybridCompute/gateways/yourarcgatewayname" 

#Define the bypass list for the proxy. Use comma to separate each item from the list.  
# Use "localhost" instead of <local> 
# Use specific IPs such as 127.0.0.1 without mask 
# Use * for subnets allowlisting. 192.168.1.* for /24 exclusions. Use 192.168.*.* for /16 exclusions. 
# Append * for domain names exclusions like *.contoso.com 
# DO NOT INCLUDE .svc on the list. The registration script takes care of Environment Variables configuration. 

$ProxyBypassList = "localhost,127.0.0.1,*.contoso.com,machine1,machine2,machine3,machine4,machine5,192.168.*.*,AzureLocal-1" 

#Invoke the registration script with Proxy and ArcgatewayID 
Invoke-AzStackHciArcInitialization -SubscriptionID $Subscription -ResourceGroup $RG -Region australiaeast -Cloud "AzureCloud" -Proxy $ProxyServer -ArcGatewayID $ArcgwId -ProxyBypass $ProxyBypassList

3단계: 설치가 성공했는지 확인

배포 유효성 검사가 시작되면 시스템에서 첫 번째 컴퓨터에 연결하고 Arc 게이트웨이 로그를 열어 Arc 게이트웨이로 리디렉션되는 엔드포인트와 방화벽 또는 프록시를 계속 사용하는 엔드포인트를 모니터링할 수 있습니다.

Arc 게이트웨이 로그는 c:\programdata\AzureConnectedMAchineAgent\Log\arcproxy.log 찾을 수 있습니다.

Arc 에이전트 구성을 확인하고 게이트웨이를 사용하고 있는지 확인하려면 다음 명령을 c:\program files\AzureConnectedMachineAgent>.\azcmagent show실행합니다.

표시되는 값은 다음과 같습니다.

에이전트 버전은1.45 이상입니다.
에이전트 상태가연결됨으로 표시되어야 합니다.
Arc 게이트웨이를 사용하지 않을 때, HTTPS 프록시는 비어 있습니다. Arc 게이트웨이를 사용할 때와 같이 http://localhost:40343 표시되어야 합니다.
업스트림 프록시 는 엔터프라이즈 프록시 서버 및 포트를 표시합니다.
Arc 게이트웨이를 사용하지 않을 때 Azure Arc 프록시가 중지된 것으로 표시됩니다. Arc 게이트웨이를 사용할 때 실행합니다.