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

Область применения: гиперконвергентные развертывания локальной среды Azure

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

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

Проблема.

В диспетчере Hyper-V или Windows Admin Center виртуальная машина моста ресурсов Azure Arc может показать предполагаемое значение спроса на память, превышающее назначенную память.

Причина.

Мост ресурсов Arc — это виртуальная машина Linux, на которой выполняются контейнерные рабочие нагрузки. Hyper-V предполагаемое требование памяти является консервативной оценкой на основе распределения памяти и поведения сбоя страницы. Это не мера активно используемой в виртуальной машине памяти. Кэши Linux и шаблоны выделения контейнеров могут привести к высокой оценке, даже если виртуальная машина не имеет нагрузки на память. Большое значение само по себе не указывает на чрезмерное использование памяти, утечку памяти или проблему производительности.

Резолюция:

Не изменяйте размер виртуальной машины моста ресурсов Arc или не изменяйте параметры памяти только на основе этого значения. Внесение этих изменений не изменяет гостевую память виртуальной машины моста ресурсов. Если мост ресурсов и Azure Local управление виртуальными машинами остаются функциональными, никаких действий не требуется.

Если вы испытываете устойчивые сбои моста ресурсов Arc, запустите средство поддержки для проблем с компонентом инфраструктуры Azure Local. Если проблема сохранится, обратитесь в службу поддержки Майкрософт. Поддержка может проверить внутренние метрики, чтобы определить, испытывает ли виртуальная машина моста ресурсов Arc фактическое давление на память.

Логическая сеть инфраструктуры не отображается на портале Azure

Проблема: Для версии 2601 и более поздних версий логическая сеть инфраструктуры, созданная во время локального развертывания Azure, не отображается на портале Azure.

Разрешение: Если после развертывания решения версии 2601 или обновления в ней не отображается логическая сеть инфраструктуры, эта сеть появляется при попытке последующего обновления решения.

Если у ваших локальных виртуальных машин Azure возникнут проблемы, которые вы не можете устранить, запустите средство поддержки для компонентов локальной инфраструктуры Azure перед отправкой запроса на поддержку. Если проблемы сохраняются, воспользуйтесь рекомендациями, приведенными в этой статье, для дальнейшего устранения неполадок с локальными виртуальными машинами Azure.

Свойство не поддерживается для этой операции

Ошибка.

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.

Расширение кластера не поддерживает тип ресурса

Ошибка.

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>'].

Причина.

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

Резолюция:

Чтобы устранить эту проблему, обновите локальный экземпляр Azure до последней версии. Дополнительные сведения см. в статье "Обновление с помощью PowerShell " или "Обновление" с помощью портала Azure.

Не удается выбрать образ для доверенных виртуальных машин запуска

Доверенный запуск для локальных виртуальных машин Azure в настоящее время поддерживает только набор образов Azure Marketplace. Список поддерживаемых образов см. в разделе "Образы гостевой операционной системы". При создании доверенной виртуальной машины запуска на портале Azure раскрывающийся список образов отображает только образы, поддерживаемые доверенным запуском. В раскрывающемся списке "Изображение" отображается пусто, если выбран неподдерживаемый образ, включая пользовательский образ. Список также отображается пустым, если ни один из образов, доступных в локальной системе 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

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

Резолюция:

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

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

   

2. Под параметром Identitytype отображается как None.

   

3. Чтобы создать управляемое удостоверение, подключитесь к локальному компьютеру Azure через протокол Remote Desktop (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 "<Resource Manager ID for the VM>" --set identity.type="SystemAssigned"
   

6. Перейдите на портал 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":""}}]}

Эта ошибка возникает из-за того, что тип BLOB некорректен в учетной записи хранения. Изображение должно иметь page blob тип.

Резолюция:

Загрузите образ в учетную запись для хранения в page blob format и повторите развертывание образа.

Убедитесь, что у вас есть правильные разрешения, и BLOB находится в правильном формате. Дополнительные сведения см. в статье "Добавление образа виртуальной машины из учетной записи хранения Azure".

Сбой при развертывании локальной виртуальной машины Azure

При попытке развернуть локальную виртуальную машину 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 типе ресурса.

• Шаблон развертывания соответствует предоставленному образцу шаблона. Дополнительные сведения см. в примере шаблона в статье "Создание локальных виртуальных машин Azure" с поддержкой Azure Arc.

Установка 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 создала временный файл подкачки"

Ошибка.

При развертывании локальной виртуальной машины Azure с помощью SQL Server 2022 на образах Windows Server 2022 Azure Marketplace (standard или Enterprise) может появиться следующее предупреждение при запуске:

Windows создал временный файл разбиения по страницам...

Резолюция:

Проблему можно устранить следующим способом.

1. Нажмите OK в появившемся предупреждении. Или перейдите в "Свойства системы>Дополнительно>Производительность>Настройки", чтобы открыть окно "Параметры производительности>".

2. В окне "Параметры производительности " выберите "Изменить" в разделе "Виртуальная память ".

   

3. В окне виртуальной памяти выберите управляемый системой размер.  Кроме того, убедитесь, что флажок " Автоматически управлять файлами разбиения на страницы" для всех дисков снят.

   

4. Нажмите кнопку "Задать", а затем нажмите кнопку "ОК ", чтобы применить изменения.

5. Перезапустите виртуальную машину. После перезапуска предупреждение не должно отображаться.

Сбой развертывания ресурсов из-за нехватки места на первом пути к хранилищу

Ошибка.

The system failed to create <Azure resource name>: There is not enough space on the disk.

Причина.

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

Резолюция:

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

"storageProfile": {
 "vmConfigStoragePathId": "Insert ARM ID of specified storage path"
}

Связанные шаги

• Часто задаваемые вопросы об управлении локальными виртуальными машинами Azure