Обновление агентов 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" является последним стабильным минорным выпуском upstream Kubernetes.

    • Например, если Kubernetes вводит 1.20.a сегодня, поддерживаются версии 1.20.a, 1.20.b, 1.19.c, 1.19.d, 1.18.e и 1.18.f.

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

Дальнейшие шаги