Устранение неполадок управления виртуальными машинами Azure Arc

Применимо к: Azure Stack HCI версии 23H2

В этой статье содержатся рекомендации по сбору журналов и устранению неполадок с виртуальными машинами Azure Arc в кластере Azure Stack HCI. Здесь также перечислены ограничения и известные проблемы, которые в настоящее время существуют при управлении виртуальными машинами Azure Arc.

Сбор журналов

Вы можете собирать журналы для выявления и устранения проблем с виртуальными машинами Arc в системе Azure Stack HCI. Используйте эти журналы для сбора ключевых сведений, прежде чем обращаться в службу поддержки Майкрософт за дополнительной помощью.

Убедитесь, что у вас есть последняя версия модуля PowerShell для сбора журналов. Чтобы обновить модуль PowerShell, выполните следующую команду:

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

Чтобы собрать журналы для виртуальных машин Arc в кластере Azure Stack HCI, выполните следующую команду:

$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 — ЭТО IP-адрес виртуальной машины Arc Resource Bridge.

  • При необходимости задайте -logDir параметр , чтобы указать путь к каталогу, в котором хранятся созданные журналы. Если вы не укажете путь или параметр, по умолчанию журналы будут храниться в текущем рабочем каталоге.

Устранение неполадок виртуальных машин Azure Arc

В этом разделе описываются ошибки, связанные с управлением виртуальными машинами Azure Arc, и рекомендуемые способы их устранения.

Сбой при попытке включить гостевую службу управления

При попытке выполнить команду для включения гостевого управления вы увидите следующую ошибку:

Ошибка: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

Приведенный выше сбой связан с тем, что управляемое удостоверение не было создано для этой виртуальной машины. Для включения гостевого управления требуется управляемое удостоверение, назначаемое системой.

Решение.

Выполните следующие действия, чтобы убедиться, что управляемое удостоверение не создано для этой виртуальной машины, а затем включите управляемое удостоверение, назначаемое системой.

  1. В портал Azure перейдите к виртуальной машине. Перейдите на страницу Обзор . На вкладке Свойства в разделе Конфигурация для параметра Управление гостевыми клиентами должно отображаться значение Отключено. Выберите представление JSON в правом верхнем углу.

    Снимок экрана: как получить представление JSON.

  2. В Identity параметре type должен отображаться как None.

    Снимок экрана: представление JSON, указывающее, что управляемое удостоверение отсутствует.

  3. Чтобы создать управляемое удостоверение, подключитесь к серверу Azure Stack HCI по протоколу RDP. Выполните следующую команду:

    az extension add --name connectedmachine
    
  4. Убедитесь, что в кластере установлено расширение 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>
        ```
    
  5. Выполните следующую команду, чтобы назначить управляемое системой удостоверение виртуальной машине.

    az connectedmachine update --ids "<ARM ID for the VM>" --set identity.type="SystemAssigned"
    
  6. Перейдите к портал Azure и перейдите на страницу Обзор. Представление JSON должно указывать, что управляемое системой удостоверение теперь назначено виртуальной машине.

    Снимок экрана: представление JSON при включенном управляемом удостоверении.

Установка 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"
        }

Дальнейшие действия