Устранение неполадок с управлением виртуальными машинами Azure Arc для локальной среды Azure
Область применения: Azure Local 2311.2 и более поздних версий
В этой статье содержатся рекомендации по сбору журналов и устранению неполадок с виртуальными машинами Azure Arc в локальном экземпляре Azure. В нем также перечислены ограничения и известные проблемы, которые в настоящее время существуют при управлении виртуальными машинами Azure Arc.
Устранение неполадок виртуальных машин Azure Arc
В этом разделе описываются ошибки, связанные с управлением виртуальными машинами Azure Arc и их рекомендуемыми разрешениями.
Сбой при попытке включить управление гостевыми клиентами
При попытке выполнить команду для включения гостевого управления вы увидите следующую ошибку:
Ошибка: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
Эта ошибка произошла из-за того, что управляемое удостоверение не было создано для этой виртуальной машины. Для включения управления гостями требуется управляемое удостоверение, назначенное системой.
Решение.
Выполните следующие действия, чтобы убедиться, что управляемое удостоверение не создано для этой виртуальной машины, а затем включите управляемое удостоверение, назначаемое системой.
В портале Azure перейдите к виртуальной машине. Перейдите на страницу обзора . На вкладке "Свойства" в разделе "Конфигурация" управление гостевыми клиентами должно отображаться как "Отключено". Выберите представление JSON в правом верхнем углу.
Под параметром
Identity
type
должно отображаться какNone
.Чтобы создать управляемое удостоверение, подключитесь к локальному компьютеру Azure через RDP. Выполните следующую команду:
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> ```
Выполните следующую команду, чтобы назначить управляемое системой удостоверение виртуальной машине.
az connectedmachine update --ids "<Resource Manager ID for the VM>" --set identity.type="SystemAssigned"
Перейдите к портал Azure и перейдите на страницу обзора. Представление JSON должно указывать, что системная управляемая идентичность теперь назначена виртуальной машине.
Сбой при развертывании образа виртуальной машины из учетной записи хранения
При попытке развернуть образ виртуальной машины из учетной записи хранения в локальной среде Azure возникает следующая ошибка:
Ошибка:{"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"}
Сбой возникает, так как пользователь, создающий образ, не имеет необходимых разрешений для доступа к образу из учетной записи хранения. Пользователь должен иметь роль участника данных BLOB в учетной записи хранения, используемой для образа. Дополнительные сведения см. в статье Назначение ролей Azure для доступа к данным Blob.
Решение.
Добавьте пользователю, которому нужно создать образ из этой учетной записи хранения, роль "Участник данных BLOB-объектов хранилища". После добавления роли повторите развертывание образа.
При попытке развернуть образ виртуальной машины из учетной записи хранения также может появиться следующая ошибка:
Ошибка:{"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":""}}]}
Эта ошибка связана с тем, что тип блоба неверный в учетной записи хранилища. Изображение должно иметь page blob
тип.
Решение.
Загрузите образ в учетную запись для хранения в page blob format
и повторите развертывание образа.
Убедитесь, что у пользователя есть правильные разрешения, и blob находится в правильном формате. Дополнительные сведения см. в статье "Добавление образа виртуальной машины из учетной записи хранилища Azure".
Сбой при развертывании виртуальной машины Arc
При попытке развернуть виртуальную машину Arc в локальной среде Azure возникает следующая ошибка:
Ошибка:{"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."}
Эта ошибка возникает, потому что объект управляемого удостоверения SystemAssigned
не принадлежит к типу ресурса Microsoft.HybridCompute/machines
.
Решение.
Проверьте в шаблоне развертывания следующее:
Объект SystemAssigned
управляемого удостоверения находится в Microsoft.HybridCompute/machines
типе ресурса, а не в Microsoft.AzureStackHCI/VirtualMachineInstances
типе ресурса.
Шаблон развертывания должен соответствовать предоставленному образцу шаблона. Дополнительные сведения см. в примере шаблона в статье "Создание виртуальных машин Arc на локальной платформе Azure".
Сбой удаления пути к хранилищу
При попытке удалить путь к хранилищу в локальном экземпляре Azure может появиться ошибка, аналогичная приведенному ниже сообщению. Номера ресурсов и версии могут отличаться в вашем сценарии.
Ошибка:"errorMessage" serviceClient returned an error during deletion: The storage container service returned an error during deletion: rpc error: code = Unknown desc = Container is in ACTIVE use by Resources [6:
- linux-cblmariner-0.2.0.10503
- windows-windows2019-0.2.0.10503
- windows-windows2022-0.2.0.10503
].
Remove all the Resources from this container, before trying to delete: In Use: Failed,
Решение.
Изображения, перечисленные в сообщении об ошибке, отличаются от типичных рабочих нагрузок, которые представлены как объекты Azure Resource Manager (ARM) на портале Azure и в CLI. Эта ошибка возникает, так как эти образы загружаются непосредственно в файловую систему, которую Azure не распознает.
Выполните следующие действия, прежде чем попытаться удалить путь к хранилищу:
- Удалите связанные рабочие нагрузки и изображения, присутствующие в пути хранения, который требуется удалить. Найдите следующие префиксы на именах изображений:
linux-cblmariner
,windows-windows2019
,windows-windows2022
,windows_k8s
, ,aks-image-merged
.linux-K8s
- Отправьте запрос в службу поддержки в портал 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"
}