Устранение неполадок с неудачным развертыванием предложения приложения Kubernetes

Статья
11/20/2024

В этой статье описывается, как устранить сбой развертывания предложения приложения Kubernetes, принятого в Microsoft Azure Marketplace. При запуске покупки предложения Kubernetes Azure развертывает шаблон Azure Resource Manager (шаблон ARM), который пытается установить необходимые ресурсы для выполнения предложения. Однако развертывание шаблона ARM может завершиться сбоем по различным причинам.

Контрольный список по устранению неполадок

Изучение журналов операций развертывания

Чтобы определить причину сбоя развертывания, необходимо проверить журналы операций развертывания. Если вы по-прежнему просматриваете страницу сбоя развертывания в портал Azure, начните с шага 5 следующей процедуры. Если вместо этого вы завершили портал Azure или перейдите на другую страницу портала, выполните следующие действия:

На портале Azure найдите и выберите элемент Группы ресурсов.
В списке групп ресурсов выберите имя группы ресурсов, в которой вы попытались развернуть приложение Kubernetes.
На странице "Обзор" группы ресурсов найдите раздел Essentials и выберите гиперссылку на текст, который отображается рядом с полем "Развертывания". Этот текст отображает частоту успешного развертывания группы ресурсов (например, 4 сбой, 30 успешно).
В списке попыток развертывания для группы ресурсов выберите значение имени развертывания развертывания, которое завершилось сбоем, на основе следующих соответствующих полей:
- Последнее изменение (метка времени)
- Длительность
- Состояние (отображается сбой вместо успешного выполнения)
В списке сведений о развертывании на странице развертывания найдите ресурс, для которого поле "Состояние" имеет значение "Конфликт". Выберите ссылку сведений об операциях для этого ресурса.
В области сведений о операции найдите свойство Status (отображает значение конфликта) и проверьте поле сообщения "Состояние" под свойством.

Код JSON в сообщении о состоянии показывает status свойство Failed. В нем также показано error свойство, содержащее дочерние свойства code (имя кода ошибки, например ExtensionOperationFailed) и message (описание сообщения об ошибке, например "Операция расширения завершилась ошибкой: не удалось разрешить версию расширения из заданных значений". Код JSON похож на следующий текст:
```
{
    "status": "Failed",
    "error": {
        "code": "ExtensionOperationFailed",
        "message": "The extension operation failed with the following error: Failed to resolve the extension version from the given values."
    }
}
```

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

Причина 1. Приложение не было установлено в выбранном кластере AKS

Если приложение Kubernetes не установлено в выбранном кластере Служба Azure Kubernetes (AKS), появится сообщение об ошибке, похожее на следующий текст:

Запрос не удалось выполнить подписку-guidhttps://management.azure.com/subscriptions/<>/resourceGroups/resourceGroup/providers/Microsoft.ContainerService/managedclusters/aks-cluster/extensionaddons/default?api-version=2021-03-01. Код ошибки: запрещено. Причина: запрещено.
{  
  "error": {  
    "code": "AuthorizationFailed",  
    "message": "The client '<client-guid>' with object id '<client-guid>' does not have authorization to perform action 'Microsoft.ContainerService/managedclusters/extensionaddons/read' over scope '/subscriptions/<subscription-guid>/resourceGroups/resourceGroup/providers/Microsoft.ContainerService/managedclusters/aks-cluster/extensionaddons/default' or the scope is invalid. If access was recently granted, please refresh your credentials."  
  }  
} 

Решение 1a. Регистрация поставщика ресурсов Microsoft.KubernetesConfiguration

Зарегистрируйте поставщика ресурсов Microsoft.KubernetesConfiguration. В этом случае установка завершилась ошибкой, так как поставщик ресурсов Microsoft.KubernetesConfiguration требуется для развертывания приложения Kubernetes. Инструкции по регистрации см. в разделе "Регистрация поставщиков ресурсов" статьи "Развертывание предложения контейнера из Azure Marketplace".

Решение 1b. Поддержание работоспособности кластера AKS

Как правило, необходимо проверить работоспособность кластера AKS, чтобы предотвратить возникновение других проблем в течение периода установки. Чтобы убедиться, что кластер работоспособен, устраните проблемы, обнаруженные в кластере.

Решение 1c. Проверка журнала действий Azure Monitor

Что делать, если кластер работоспособен, но установка по-прежнему завершается ошибкой? В этом случае изучите журнал действий Azure Monitor в кластере AKS, чтобы найти причину сбоя на этом этапе установки.

Причина 2. Подписка имеет ограничения ресурсов

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

Инструмент оплаты "неизвестный" не поддерживается для предложения с помощью OfferId: "<имя> предложения", PlanId "<subscription-plan-name>".

Решение 2. Убедитесь, что подписка соответствует необходимой конфигурации выставления счетов

Проверьте конфигурацию выставления счетов подписки, чтобы убедиться, что она соответствует требованиям к ресурсам приложения Kubernetes. Дополнительные сведения см. в разделе "Проверка покупки".

Причина 3. Предложение не было доступно в вашем регионе

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

Предложение: "<предложение-имя>" не может быть приобретено по подписке:< "subscription-guid>", так как оно не продается на рынке: "<двухбуквенный регион-код".

Решение 3. Проверьте, доступно ли предложение и где он по-прежнему доступен

Убедитесь, что предложение по-прежнему доступно, и дважды проверьте регионы, к которым применяется предложение.

Причина 4. Произошла внутренняя ошибка сервера

Приложение Kubernetes не установлено, так как ресурс расширения не установлен. Этот сбой создает следующее сообщение об ошибке:

Не удалось развернуть расширение с ошибкой внутреннего сервера

Решение 4. Удаление и переустановка расширения

Сначала удалите ресурс расширения, который является частью покупки предложения. Затем переустановите расширение.

Причина 5. Диаграмма Helm не устанавливала

Ошибки в диаграмме Helm создают следующее сообщение об ошибке:

Не удалось установить диаграмму из пути [] для выпуска

Решение 5. Повторно проверьте записи, сделанные в шаблоне ARM

Убедитесь, что значения и выбранные значения, введенные в портал Azure для развертывания шаблона ARM, допустимы в приложении Kubernetes.

Причина 6. Вы не приняли юридические условия подписки для этого плана

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

Вы не приняли юридические условия этой подписки: "<subscription-guid>" для этого плана. Прежде чем использовать подписку, необходимо принять юридические условия образа.

Решение 6. Примите юридические условия

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

Следующие шаги

Устранение ошибок при развертывании расширений кластера AKS

Заявление об отказе от ответственности за сведения о продуктах сторонних производителей

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

Свяжитесь с нами для получения помощи

Если у вас есть вопросы или вам нужна помощь, создайте запрос в службу поддержки или обратитесь за поддержкой сообщества Azure. Вы также можете отправить отзыв о продукте в сообщество отзывов Azure.

Поделиться через