Azure Arc VM 관리 문제 해결

아티클
02/01/2024

적용 대상: Azure Stack HCI, 버전 23H2

이 문서에서는 Azure Stack HCI 클러스터에서 로그를 수집하고 Azure Arc VM(가상 머신)의 문제를 해결하는 방법에 대한 지침을 제공합니다. 또한 현재 Azure Arc VM 관리와 함께 존재하는 제한 사항 및 알려진 문제를 나열합니다.

로그 수집

로그를 수집하여 Azure Stack HCI 시스템에서 Arc VM 문제를 식별하고 해결할 수 있습니다. Microsoft 지원에 추가 도움말을 문의하기 전에 이러한 로그를 사용하여 주요 정보를 수집합니다.

로그 수집을 위한 최신 PowerShell 모듈이 있는지 확인합니다. PowerShell 모듈을 업데이트하려면 다음 명령을 실행합니다.

#Update the PowerShell module
Install-Module -Name ArcHci -Force -Confirm:$false -SkipPublisherCheck -AcceptLicense

Azure Stack HCI 클러스터에서 Arc VM에 대한 로그를 수집하려면 다음 명령을 실행합니다.

$csv_path="<input-from-admin>"
$VMIP_1="<input-from-admin>"
az login --use-device-code
Get-ArcHCILogs -workDirectory $csv_path\ResourceBridge -kvaTokenPath $csv_path\ResourceBridge\kvatoken.tok -ip $VMIP_1

여기서

$csv_path 는 Arc 리소스 브리지를 만들기 위해 제공되는 클러스터 공유 볼륨의 전체 경로입니다.
$VMIP_1 은 Arc Resource Bridge VM의 IP 주소입니다.
필요에 따라 매개 변수를 -logDir 설정하여 생성된 로그가 저장되는 디렉터리의 경로를 지정합니다. 경로 또는 매개 변수를 지정하지 않으면 기본적으로 로그가 현재 작업 디렉터리에 저장됩니다.

Azure Arc VM 문제 해결

이 섹션에서는 Azure Arc VM 관리와 관련된 오류 및 권장 해결 방법을 설명합니다.

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

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

오류:Deployment failed. Correlation ID: 5d0c4921-78e0-4493-af16-dffee5cbf9d8. VM Spec validation failed for guest agent provisioning: Invalid managed identity. A system-assigned managed identity must be enabled in parent resource: Invalid Configuration

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

해결 방법:

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

Azure Portal VM으로 이동합니다. 개요 페이지로 이동합니다. 속성 탭의 구성에서 게스트 관리는사용 안 함으로 표시됩니다. 오른쪽 위 모서리에서 JSON 보기를 선택합니다.
매개 변수에서 Identity 는 type 로 None표시되어야 합니다.
관리 ID를 만들려면 RDP를 통해 Azure Stack HCI 서버에 연결합니다. 다음 명령 실행:
```
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 "<ARM ID for the VM>" --set identity.type="SystemAssigned"

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

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"
        }

다음 단계

Azure Arc VM 관리 FAQ