Azure Arc에서 사용하도록 설정된 Azure 로컬 가상 머신 문제 해결하기

2025-07-03

적용 대상: Azure Local 2311.2 이상

이 문서에서는 Azure Arc에서 사용하도록 설정된 Azure 로컬 VM(Virtual Machines)에서 로그를 수집하고 문제를 해결하는 방법을 설명합니다. 또한 권장 해결 방법과 함께 Azure 로컬 VM 관리의 현재 제한 사항 및 알려진 문제를 나열합니다.

이 작업에는 이 속성이 지원되지 않습니다.

오류:

Property '<Property Name>' isn't supported for this operation on your Azure Local cluster version. Please update your cluster if you want to set this property for this operation. Please view aka.ms/hciproperties.

원인:

이 오류는 사용하려는 기능을 Azure 로컬 인스턴스에서 실행되는 소프트웨어 버전에 사용할 수 없는 경우에 발생합니다. 클러스터의 소프트웨어 버전이 오래되었거나 기능이 이후 버전에서 도입된 경우에 발생할 수 있습니다.

해상도:

이 문제를 해결하려면 Azure 로컬 인스턴스를 최신 버전으로 업데이트합니다. 자세한 내용은 PowerShell을 통한 업데이트 또는 Azure Portal을 통한 업데이트를 참조하세요.

클러스터 확장은 리소스 유형을 지원하지 않습니다.

오류:

The cluster extension '<Cluster Extension Azure Resource Manager ID>' doesn't support resource type 'Microsoft.AzureStackHCI/<Resource Type>'. The currently enabled resource types are '<Supported Resource Type Names>'. Please ensure the 'Microsoft.AzureStackHCI' cluster extension version metadata file supports the resource type. [ClusterExtensionVersion='<Cluster Extension Version>'] [CorrelationId='<Correlation ID>'].

원인:

해상도:

신뢰할 수 있는 시작 VM에 대한 이미지를 선택할 수 없음

Azure 로컬 VM에 대한 신뢰할 수 있는 시작은 현재 선택한 Azure Marketplace 이미지 집합만 지원합니다. 지원되는 이미지 목록은 게스트 운영 체제 이미지를 참조하세요. Azure Portal에서 신뢰할 수 있는 시작 VM을 만들 때 이미지 드롭다운 목록에는 신뢰할 수 있는 시작에서 지원하는 이미지만 표시됩니다. 사용자 지정 이미지를 포함하여 지원되지 않는 이미지를 선택하면 이미지 드롭다운이 비어 표시됩니다. 신뢰할 수 있는 시작에서 Azure 로컬 시스템에서 사용할 수 있는 이미지가 지원되지 않는 경우에도 목록이 비어 있는 것으로 표시됩니다.

게스트 관리를 사용하도록 설정하려고 할 때 실패

명령을 실행하여 게스트 관리를 사용하도록 설정하려고 하면 다음 오류가 표시됩니다.

오류:Deployment failed. Correlation ID: aaaa0000-bb11-2222-33cc-444444dddddd. VM Spec validation failed for guest agent provisioning: Invalid managed identity. A system-assigned managed identity must be enabled in parent resource: Invalid Configuration

이 오류는 관리 ID가 이 VM에 대해 만들어지지 않았기 때문입니다. 게스트 관리를 사용하려면 시스템 할당 관리 ID가 필요합니다.

해상도:

다음 단계에 따라 이 VM에 대해 관리 ID가 만들어지지 않는지 확인한 다음 시스템 할당 관리 ID를 사용하도록 설정합니다.

Azure Portal에서 VM으로 이동합니다. 개요 페이지로 이동합니다. 속성 탭의 구성에서 게스트 관리는사용 안 함으로 표시되어야 합니다. 오른쪽 위 모서리에서 JSON 보기를 선택합니다.
매개 변수 Identity 아래에서 type는 None로 표시되어야 합니다.
관리 ID를 만들려면 RDP(원격 데스크톱 프로토콜)를 통해 Azure 로컬 컴퓨터에 연결합니다. 다음 명령을 실행합니다.
```
az extension add --name connectedmachine
```

연결된 컴퓨터 CLI 확장이 시스템에 설치되어 있는지 확인합니다. 확장이 성공적으로 설치된 샘플 출력은 다음과 같습니다. 버전 connectedmachine 0.7.0이 설치되었음을 나타냅니다.

[v-hostl]: PS C:\Clusterstorage\lnfrastructure_l\ArcHci> az version
{
"azure-cli": "2.53.0",
"azure-cli-core": "2.53.0",
"azure-cli-telemetry": "1.1.0",
"extensions": {
    "akshybrid": "0.1.1",
    "arcappliance"^ "1.0.2",
    "connectedk8s": "1.5.4",
    "connectedmachine": "0.7.0",
    "customlocation": "0.1.3",
    "hybridaks": "0.2.4",
    "k8s-extension": "1.4.5",
    "stack-hci-vm": "0.1.8"
    }
}
[v-hostl]: PS C:\ClusterStorage\Infrastructure_l\ArcHci>
    ```

다음 명령을 실행하여 VM에 시스템 관리 ID를 할당합니다.

az connectedmachine update --ids "<Resource Manager ID for the VM>" --set identity.type="SystemAssigned"

Azure Portal로 이동하여 개요 페이지로 이동합니다. JSON 뷰는 시스템 관리 ID가 이제 VM에 할당되었음을 나타내야 합니다.

스토리지 계정에서 VM 이미지 배포 실패

Azure 로컬의 스토리지 계정에서 VM 이미지를 배포하려고 할 때 다음 오류가 표시됩니다.

오류:{"code":"moc-operator galleryimage serviceClient returned an error while reconciling: rpc error: code = Unknown desc = ===== RESPONSE ERROR (ErrorCode=AuthorizationPermissionMismatch) =====\nDescription=, Details: (none)\n","message":"moc-operator galleryimage serviceClient returned an error while reconciling: rpc error: code = Unknown desc = ===== RESPONSE ERROR (ErrorCode=AuthorizationPermissionMismatch) =====\nDescription=, Details: (none)\n"}

또는 다음 오류가 표시됩니다.

오류:{"code":"moc-operator galleryimage serviceClient returned an error while reconciling: rpc error: code = Unknown desc = ===== RESPONSE ERROR (ErrorCode=NoAuthenticationInformation) =====\nDescription=, Details: (none)\n","message":"moc-operator galleryimage serviceClient returned an error while reconciling: rpc error: code = Unknown desc = ===== RESPONSE ERROR (ErrorCode=NoAuthenticationInformation) =====\nDescription=, Details: (none)\n"}

이미지를 만드는 사용자에게 스토리지 계정에서 이미지에 액세스할 수 있는 권한이 없기 때문에 오류가 발생합니다. 사용자에게 이미지에 사용하는 스토리지 계정에 대한 Storage Blob 데이터 기여자 역할이 있어야 합니다. 자세한 내용은 Blob 데이터에 대한 액세스에 대한 Azure 역할 할당 을 참조하세요.

해상도:

이 스토리지 계정에서 이미지를 만들어야 하는 사용자에게 Storage Blob 데이터 기여자 역할을 추가합니다. 역할이 추가되면 이미지 배포를 다시 시도합니다.

스토리지 계정에서 VM 이미지를 배포하려고 할 때 다음 오류가 표시될 수도 있습니다.

오류:{"code":"moc-operator galleryimage serviceClient returned an error while reconciling: rpc error: code = Unknown desc = ===== RESPONSE ERROR (ErrorCode=InvalidBlobType) =====\nDescription=The blob type is invalid for this operation.\nRequestId:5e74055f-e01e-0033-66eb-ff9734000000\nTime:2024-09-05T23:32:56.3001852Z, Details: (none)\n","message":"moc-operator galleryimage serviceClient returned an error while reconciling: rpc error: code = Unknown desc = ===== RESPONSE ERROR (ErrorCode=InvalidBlobType) =====\nDescription=The blob type is invalid for this operation.\nRequestId:5e74055f-e01e-0033-66eb-ff9734000000\nTime:2024-09-05T23:32:56.3001852Z, Details: (none)\n","additionalInfo":[{"type":"ErrorInfo","info":{"category":"Uncategorized","recommendedAction":"","troubleshootingURL":""}}]}

이 오류는 스토리지 계정 내에서 Blob 유형이 올바르지 않기 때문입니다. 이미지는 page blob 형식이어야 합니다.

해상도:

이미지를 스토리지 계정에 page blob format 업로드하고 이미지 배포를 다시 시도합니다.

사용자에게 올바른 권한이 있고 Blob이 올바른 형식인지 확인합니다. 자세한 내용은 Azure Storage 계정에서 VM 이미지 추가를 참조하세요.

Azure 로컬 VM 배포 실패

Azure 로컬 VM을 배포하려고 할 때 다음 오류가 표시됩니다.

오류:{"code":"ConflictingOperation","message":"Unable to process request 'Microsoft.AzureStackHCI/virtualMachineInstances'. There is already a previous running operation for resource '/subscriptions/<subscription ID>/resourceGroups/<Resource group name>/providers/Microsoft.HybridCompute/machines/<VM name>/providers/Microsoft.AzureStackHCI/virtualMachineInstances/default'. Please wait for the previous operation to complete."}

이 오류는 관리 ID 개체가 SystemAssigned 리소스 유형에 있지 않기 때문 Microsoft.HybridCompute/machines 입니다.

해상도:

배포 템플릿에서 다음을 확인합니다.

SystemAssigned 관리 ID 개체는 Microsoft.HybridCompute/machines 리소스 유형에 있으며 Microsoft.AzureStackHCI/VirtualMachineInstances 리소스 종류에는 없습니다.

배포 템플릿은 제공된 샘플 템플릿과 일치해야 합니다. 자세한 내용은 Azure Arc에서 사용하도록 설정된 Azure 로컬 가상 머신 만들기의 샘플 템플릿을 참조하세요.

Azure CLI 설치가 인식되지 않음

환경을 설치한 후 Azure CLI를 인식하지 못하는 경우 다음 코드 블록을 실행하여 환경 경로에 Azure CLI 설치 경로를 추가합니다.

        if ( -not( $env:PATH -like '*C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\wbin*') ) {
            $env:PATH += "C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\wbin;"
            Write-Host "Updated path $env:PATH"
        }

시작 시 "Windows에서 임시 페이징 파일을 만들었습니다." 메시지가 나타납니다.

오류:

Windows Server 2022 Azure Marketplace 이미지(표준 또는 엔터프라이즈)에서 SQL Server 2022를 사용하여 Azure 로컬 VM을 배포하는 경우 시작 시 다음 경고가 표시될 수 있습니다.

Windows에서 임시 페이징 파일을 만들었습니다...

해상도:

이 이슈를 해결하려면 다음 단계를 따릅니다.

경고 팝업에서 확인을 선택합니다. 또는 시스템 속성>고급>성능>설정 으로 이동하여 성능 옵션 창을 엽니다.
성능 옵션 창의 가상 메모리 섹션에서 변경을 선택합니다.
가상 메모리 창에서 시스템 관리 크기를 선택합니다.  또한 모든 드라이브에 대한 페이징 파일 크기 자동 관리 확인란의 선택을 취소했는지 확인합니다.
[설정]을 선택한 다음[확인]을 선택하여 변경 내용을 적용합니다.
VM을 다시 시작합니다. 다시 시작한 후에는 경고 메시지가 더 이상 표시되지 않습니다.