Azure 로컬 버전 23H2에 대한 Azure Portal 배포 유효성 검사 문제 해결

적용 대상: 2405 이상을 실행하는 Azure Local 버전 23H2

이 문서에서는 Azure Portal을 통해 Azure Local을 배포하는 동안 발생하는 배포 유효성 검사 문제를 해결하는 방법에 대한 지침을 제공합니다.

오류 - 배포 유효성 검사 실패

Azure Portal을 통해 Azure Local 버전 23H2를 배포할 때 배포 유효성 검사 오류가 발생할 수 있습니다. 다음 오류와 함께 "Azure 로컬 네트워크 - 네트워크 요구 사항 확인" 유효성 검사 작업이 실패합니다.

Could not complete the operation. 400: Resource creation validation failed. Details:
[{"Code":"AnswerFileValidationFailed","Message":"Errors in Value Validation:\r\nPhysicalNodesValidator
found error at deploymentdata.physicalnodes[0].ipv4address: The specified  for 
\u0027deploymentdata.physicalnodes[0].ipv4address\u0027 is not a valid IPv4 address.
Example: 192.168.0.1 or 192.168.0.1","Target":null,"Details":null}].

Azure Portal 배포의 네트워킹 탭으로 이동하면 네트워크 의도 구성 내에서 다음 오류가 표시 될 수 있습니다.

The selected physical network adapter is not binded to the management virtual switch.

원인

이 문제는 8월 6일 이후에 트리거된 배포에서 발생합니다. 이 문제는 시스템에서 배포 유효성 검사가 트리거되고 유효성 검사 결과가 실패하고 후속 유효성 검사가 다시 시도된 경우에 발생합니다.

이 문제는 다음과 같은 이유로 발생합니다.

• 디바이스의 유효성 검사는 네트워크 관련 테스트에 대한 VM 스위치를 만들고 테스트가 끝날 때 삭제됩니다.
• DeviceManagementExtension 확장에서 VM 스위치의 삭제를 검색하지 않습니다.

권장 솔루션

다단계 해결 프로세스에는 다음 단계가 포함됩니다.

• 시드 노드에서 잠금 제거
• 유효성 검사 오류 제거
• 잘못된 VM 스위치 정보로 Edge 디바이스 Azure 리소스 정리
• 클라우드 데이터 새로 고침
• Azure Portal을 통해 배포 다시 시작
• 시드 노드 리소스에 대한 잠금 다시 생성

참고 항목

이 문서의 모든 단계는 시드 노드에서 수행해야 합니다.

시드 노드에서 잠금 제거

시드 노드에서 잠금을 제거하려면 다음 단계를 수행합니다.

1. 잠금을 제거하려면 Azure Portal에서 리소스 그룹을 통해 또는 Machines - Azure Arc 내에서 개체로 이동합니다.
2. 왼쪽 창에서 설정 > 잠금으로 이동합니다. DoNotDelete라는 잠금이 표시됩니다. 노드가 온보딩될 때 만들어지는 자동 리소스 잠금입니다.
3. 잠금에 대해 삭제를 선택합니다.

잠금 을 제거하지 않고 다음 섹션의 단계를 시도하면 다음 오류와 함께 Delete 명령이 실패합니다.

Some resources failed to be deleted (run with `--verbose` for more information):
/subscriptions/<subid>/resourceGroups/<rgname>/providers/Microsoft.HybridCompute/machines/<Machine Name>/providers/Microsoft.AzureStackHCI/edgeDevices/default

스위치를 사용하여 실행할 때의 출력 예제는 --verbose 다음과 같습니다.

(ScopeLocked) The scope '/subscriptions/<Subscription ID>/resourceGroups/<Resource Group Name>/providers/Microsoft.HybridCompute/machines/<Machine Name>/providers/Microsoft.AzureStackHCI/edgeDevices/default' cannot perform delete operation because following scope(s) are locked: '/subscriptions/<subid>/resourceGroups/<rgname>/providers/Microsoft.HybridCompute/machines/<Machine Name>'. Please remove the lock and try again.
Code: ScopeLocked
Message: The scope '/subscriptions/<subid>/resourceGroups/<rgname>/providers/Microsoft.HybridCompute/machines/<Machine Name>/providers/Microsoft.AzureStackHCI/edgeDevices/default' cannot perform delete operation because following scope(s) are locked: '/subscriptions/<subid>/resourceGroups/<rgname>/providers/Microsoft.HybridCompute/machines/<Machine Name>'. Please remove the lock and try again.

유효성 검사 오류 제거

잠금이 제거되면 다음 단계에 따라 유효성 검사 오류를 제거합니다.

1. 시드 노드에 연결합니다. 다음 PowerShell 명령을 실행합니다.

   Get-VMSwitch
   

2. 예기치 않은 VM 스위치에 대한 명령 출력 Get-VMSwitch 을 확인합니다. 예를 들어 네트워크 유효성 검사 단계에서 만들어지고 다음과 유사한 "ConvergedSwitch(compute_management)"이름을 가진 스위치입니다. 스위치의 정확한 이름은 선택한 네트워크 의도 구성에 따라 달라집니다.

3. 의도적으로 만들지 않은 VM 스위치가 있는 경우 스위치를 제거합니다. 다음 PowerShell 명령을 실행합니다.

   Remove-VMSwitch -Name "<VM Switch Name>" -Force
   

   명령에서 Get-VMSwitch VM 스위치 이름을 사용해야 합니다. 의도적으로 VM 스위치 Get-VMSwitch 를 만들지 않은 경우 명령에 결과가 없습니다. 네트워크 유효성 검사 단계에서 VM 스위치를 정리했지만 정리를 DeviceManagementExtension 검색하지 못했기 때문에 오류가 발생합니다.

정리 단계를 계속합니다.

잘못된 VM 스위치 정보로 Edge 디바이스 Azure 리소스 정리

디바이스의 VM 스위치를 제거한 후 Azure CLI를 통해 잘못된 VM 스위치 정보를 포함하는 Edge 디바이스 ARM 리소스를 정리합니다.

1. Azure에 액세스할 수 있는 클라이언트에서 AZ CLI 설치 또는 설치 확인: Windows에 Azure CLI 설치

   • 다음을 실행하여 설치를 확인할 수 있습니다. az
   • 설치되면 사용 가능한 명령이 포함된 "Welcome to Azure CLI!" 메시지를 출력합니다.

2. Azure CLI를 사용하여 Azure에 로그인합니다. 다음 명령을 실행합니다.

   az login --tenant <tenant ID> --use-device-code
   

   자세한 내용은 Azure CLI를 사용하여 대화형으로 로그인합니다.

3. 특정 구독을 설정하려면 다음 명령을 실행합니다.

   az account set --subscription "<Subscription ID>"
   

   위 예제 명령의 값을 적절한 값 <Subscription ID>으로 바꿉다.

4. 잘못 저장된 VM 스위치 정보가 있는 리소스 내에 edgeDevices 저장된 데이터를 출력합니다. 다음 명령을 실행합니다.

   az resource show --ids "/subscriptions/<Subscription ID>/resourceGroups/<Resource Group Name>/providers/Microsoft.HybridCompute/machines/<Machine Name>/providers/Microsoft.AzureStackHCI/edgeDevices/default"
   

   위 예제 명령의 값을 다음과<Subscription ID><Resource Group Name><Machine Name> 같은 적절한 값으로 바꿉다.

   다음은 출력 예제입니다.

   az resource show --ids "/subscriptions/<Subscription ID>/resourceGroups/<Resource Group Name>/providers/Microsoft.HybridCompute/machines/ASRR1N26R15U33/providers/Microsoft.AzureStackHCI/edgeDevices/default"
   

   이 명령의 출력에는 명령에 사용된 컴퓨터 이름>에 <대한 세부 정보가 꽤 많이 표시됩니다. 출력의 아래쪽 근처에 다음을 표시할 수 있는 섹션 "switchDetails"이 있습니다(디바이스에서 생성 및 정리되었지만 DeviceManagementExtension 및 업데이트된 클라우드 쪽에서 검색되지 않은 유효성 검사 VM 스위치). "switchName": "ConvergedSwitch(managementcompute)","switchType": "External"

5. 데이터를 출력 edgeDevices 하고 확인하여 작업을 수행한 명령을 확인한 show "switchDetails"후에는 ARM에서 리소스로 이동하여 delete 시드 노드에서 적절하게 새로 고칠 수 있습니다.

   참고 항목

   데이터를 삭제하는 edgeDevices 것은 안전한 작업이지만 명시적으로 언급된 경우에만 수행해야 합니다. 권장하지 않는 한 이 작업을 수행하지 마세요.

6. edgeDevices 잘못 저장된 VM 스위치 정보가 있는 리소스를 삭제합니다. 다음 명령을 실행합니다.

   az resource delete --ids "/subscriptions/<Subscription ID>/resourceGroups/<Resource Group Name>/providers/Microsoft.HybridCompute/machines/<Machine Name>/providers/Microsoft.AzureStackHCI/edgeDevices/default"
   

   값을 다음과 같은 적절한 값으로 바꿉니다(문자를 제거 <> 해야 합니다). <subGUID><resourceGROUPNAME><Machine Name>

   이 리소스는 동일한 리소스 --ids show이므로 동일한 문자열만 사용할 수 있습니다. 실제로 콘솔에서 "위쪽 화살표"만 사용하고 .로 delete바꿀 show 수 있습니다.

   다음은 출력 예제입니다.

   `az resource delete --ids "/subscriptions/<Subscription ID>/resourceGroups/<Resource Group Name>/providers/Microsoft.HybridCompute/machines/<Machine Name>/providers/Microsoft.AzureStackHCI/edgeDevices/default"
   

   실행하면 이 명령의 출력이 없습니다. 명령이 작동하고 명령 프롬프트를 반환하거나 오류를 표시합니다. 오류를 표시해서는 안 되지만 오류가 발생하면 더 많은 문제 해결이 필요합니다.

7. 명령을 다시 실행하여 리소스 삭제를 확인합니다 show . 다음은 출력 예제입니다.

   (ResourceNotFound) The resource 'Microsoft.HybridCompute/machines/<Machine Name>/providers/Microsoft.AzureStackHCI/edgeDevices/default' could not be found.
   Code: ResourceNotFound
   Message: The resource 'Microsoft.HybridCompute/machines/<Machine Name>/providers/Microsoft.AzureStackHCI/edgeDevices/default' could not be found.
   

클라우드 edgeDevices 데이터 새로 고침

ARM 리소스와 의도하지 않은 모든 VM 스위치가 제거되면 클라우드 쪽 edgeDevices 데이터를 다시 새로 고칩니다.

클라우드 데이터를 새로 고치려면 다음 단계를 수행합니다.

1. DeviceManagementService 시드 노드에서 다시 시작합니다. 다음 PowerShell 명령을 실행합니다.

    Restart-Service DeviceManagementService
   

2. 몇 분 정도 기다린 다음 클라우드 edgeDevices 데이터가 업데이트되고 현재 상태를 반영하는지 확인합니다. 명령을 show 다시 실행하고 출력을 검토합니다. 출력에 예기치 않은 VM 스위치가 더 이상 포함되어 있지 않은지 확인합니다. 즉,

   "switchName": "ConvergedSwitch(managementcompute)", "switchType": "External"

Azure Portal을 통해 배포 다시 시작

디바이스 및 클라우드 데이터가 다시 동기화되면 Azure Portal로 이동하여 배포 입력을 제공할 수 있습니다. 이전 단계에서는 이전 시도에서 캐시된 정보를 방지합니다.

Azure Portal에서 다음 단계를 따릅니다.

1. 기본 사항 탭에서 드롭다운 목록에서 다시 한 번 선택하여 입력을 위쪽의 필드에 제공합니다.

2. 페이지 맨 아래에 있는 노드의 선택을 취소합니다.

3. 다시 선택한 노드의 유효성을 다시 검사합니다.

4. 후속 페이지에 대한 정보를 확인합니다. 다음과 같은 변경 내용이 표시됩니다.

   • 네트워킹 페이지에서 이전에 표시되었을 수 있는 오류가 더 이상 표시되지 The selected physical network adapter is not binded to the management virtual Switch 않습니다.
   • 끝에 있는 유효성 검사 페이지에서 원래 문제가 deploymentdata.physicalnodes[0].ipv4address is not a valid IPv4 address 지난 경우 오류가 표시되지 않습니다.

5. 다른 유효성 검사 문제가 발생하지 않으면 배포를 시작합니다.

시드 노드 리소스에 대한 잠금 다시 생성

완화가 완료되면 리소스에 대한 잠금을 다시 만드는 것이 좋습니다.

잠금을 다시 만들려면 다음 단계를 수행합니다.

1. Azure Portal에서 리소스 그룹을 통해 또는 Machines - Azure Arc 내에서 개체로 이동합니다.
2. 설정 > 잠금으로 이동합니다.
3. 페이지 맨 위에서 + 추가를 선택합니다.
   1. 잠금 이름에 DoNotDelete를 입력합니다.
   2. 잠금 형식의 경우 드롭다운에서 삭제를 선택합니다.
4. 확인을 선택하여 잠금을 저장합니다.