Обновление агентов Kubernetes с поддержкой Azure Arc

  • Статья

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

Включение или отключение автоматического обновления при подключении кластера к Azure Arc

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

При подключении кластера к Azure Arc параметр по умолчанию — включить автоматическое обновление.

Следующая команда подключает кластер к Azure Arc с включенным автоматическим обновлением:

az connectedk8s connect --name AzureArcTest1 --resource-group AzureArcTest

Внимание

Убедитесь, что вы разрешаете подключение ко всем необходимым конечным точкам. В частности, для автоматического обновления требуется подключение dl.k8s.io .

Чтобы отказаться от автоматического обновления, укажите --disable-auto-upgrade параметр при подключении кластера к Azure Arc.

Следующая команда подключает кластер к Azure Arc с отключенным автоматическим обновлением:

az connectedk8s connect --name AzureArcTest1 --resource-group AzureArcTest --disable-auto-upgrade

Совет

Если вы планируете отключить автоматическое обновление, помните о политике поддержки версий для Kubernetes с поддержкой Azure Arc.

Переключение автоматического обновления после подключения кластера к Azure Arc

После подключения кластера к Azure Arc можно изменить выбор автоматического обновления с помощью az connectedk8s update команды и задать --auto-upgrade значение true или false.

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

az connectedk8s update --name AzureArcTest1 --resource-group AzureArcTest --auto-upgrade false

Обновление агентов вручную

Если вы отключили автоматическое обновление, можно вручную инициировать обновления для агентов с помощью az connectedk8s upgrade команды. При этом необходимо указать версию, до которой требуется обновить.

Kubernetes с поддержкой Azure Arc следует стандартной схеме MAJOR.MINOR.PATCH семантического управления версиями для управления версиями своих агентов. Каждый элемент номера версии указывает на общую совместимость с предыдущей версией:

  • Основные версии изменяются при внесении несовместимых изменений в API или при возможном нарушении обратной совместимости.
  • Дополнительные версии изменяются при внесении изменений в функции, которые обратно совместимы с другими дополнительными выпусками.
  • Номер версии исправления изменяется при исправлении ошибок с сохранением обратной совместимости.

Хотя расписание может отличаться, новая дополнительная версия агентов Kubernetes с поддержкой Azure Arc выпускается примерно один раз в месяц.

Следующая команда вручную обновляет агенты до версии 1.8.14:

az connectedk8s upgrade -g AzureArcTest1 -n AzureArcTest --agent-version 1.8.14

Проверка версии агента

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

az connectedk8s list --query '[].{name:name,rg:resourceGroup,id:id,version:agentVersion}'

Проверка включения автоматического обновления в кластере

Чтобы проверить, включен ли кластер для автоматического обновления, выполните следующую команду kubectl. Обратите внимание, что конфигурация автоматического обновления недоступна в общедоступном API для Kubernetes с поддержкой Azure Arc.

kubectl -n azure-arc get cm azure-clusterconfig -o jsonpath="{.data['AZURE_ARC_AUTOUPDATE']}"

Политика поддержки версий

При создании запросов на поддержку для Kubernetes с поддержкой Azure Arc применяется следующая политика поддержки версий:

  • Агенты Kubernetes с поддержкой Azure Arc имеют окно поддержки "N-2", где "N" является последним дополнительным выпуском агентов.

    • Например, если Kubernetes с поддержкой Azure Arc представляет 0.28.a сегодня, поддерживаются версии 0.28.a, 0.28.b, 0.27.c, 0.27.d, 0.26.e и 0.26.f.

  • У кластеров Kubernetes, подключающихся к Azure Arc, есть окно поддержки "N-2", где "N" — это последний стабильный дополнительный выпуск вышестоящей версии Kubernetes.

    • Например, если Kubernetes сегодня вводит значение 1,20.a, это значит, что поддерживаются версии 1,20.a, 1,20.b, 1.19.c, 1.19.d, 18E.e и 18E.f.

Если вы создаете запрос на поддержку и используете версию, которая находится вне политики поддержки (старше поддерживаемых версий агентов N-2 и вышестоящих кластеров Kubernetes), вам будет предложено обновить кластеры и агенты до поддерживаемой версии.

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