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

Статья
04/12/2024

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

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

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

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

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

В коде 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), вы получите сообщение об ошибке, похожее на следующий текст:

Не удалось выполнить запрос на https://management.azure.com/subscriptions/<subscription-guid>/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. В этом случае установка завершилась сбоем, так как для развертывания приложения Kubernetes требуется поставщик ресурсов Microsoft.KubernetesConfiguration. Инструкции по регистрации см. в разделе "Регистрация поставщиков ресурсов" статьи Развертывание предложения контейнера из Azure Marketplace.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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