Поддерживаемые версии Kubernetes в Службе Azure Kubernetes (AKS)

Сообщество Kubernetes выпускает небольшие версии примерно каждые четыре месяца.

Выпуски дополнительных версий содержат новые функции и улучшения. Исправления выпускаются чаще (иногда еженедельно) и предназначены для устранения критических ошибок в дополнительной версии. Такие выпуски ликвидируют уязвимости в системе безопасности или серьезные ошибки.

Версии Kubernetes

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

[major].[minor].[patch]

Каждое число в версии отражает совместимость с предыдущими версиями:

• Основные версии: введение несовместимых изменений API или прерывание обратной совместимости.
• Дополнительные версии: добавление новых функций. Стабильные API обычно остаются совместимыми, но нерекомендуемые API и функции можно удалить в соответствии с политикой отмены Kubernetes.
• Патч-версии: Включают исправления ошибок с обратной совместимостью.

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

Календарь выпуска AKS Kubernetes и предстоящие версии

Проверьте календарь выпуска AKS Kubernetes для предстоящих выпусков версий. Чтобы просмотреть обновления о состоянии выпуска регионов и заметки о выпуске версий в режиме реального времени, перейдите на страницу веб-сайта состояния выпуска AKS. Дополнительные сведения о веб-странице состояния выпуска смотрите в трекере выпуска AKS.

Историю предыдущих выпусков см. в истории Kubernetes.

Версии LTS

Для получения расширенной поддержки необходимо включить долгосрочную поддержку (LTS). Дополнительные сведения см. в разделе "Включение долгосрочной поддержки".

График выпуска AKS Kubernetes — диаграмма Ганта

На следующей диаграмме Ганта отображаются текущие выпуски:

Изменения, нарушающие совместимость компонентов AKS, по версиям

Обратите внимание на следующие важные изменения перед обновлением до любой из доступных дополнительных версий:

Kubernetes 1.36

Kubernetes 1.35

Kubernetes 1.34

Kubernetes 1.33

Kubernetes 1.32

Kubernetes 1.31

Kubernetes 1.30

Дополнительная версия псевдонима в AKS

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

Чтобы узнать, какой патч вы используете, выполните команду az aks show --resource-group myResourceGroup --name myAKSCluster. В выходных данных свойство currentKubernetesVersion показывает полную версию Kubernetes. Рассмотрим пример.

{
 "apiServerAccessProfile": null,
  "autoScalerProfile": null,
  "autoUpgradeProfile": null,
  "azurePortalFqdn": "myaksclust-myresourcegroup.portal.hcp.eastus.azmk8s.io",
  "currentKubernetesVersion": "<major>.<minor>.<patch>",
}

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

AKS определяет общедоступную версию (GA) как версию, доступную во всех регионах, и включенную во всех измерениях SLO или SLA. AKS поддерживает три общедоступные малые версии Kubernetes.

• Последняя общедоступная версия (N).
• Две предыдущие дополнительные версии (N-1 и N-2).
  • Каждая поддерживаемая дополнительная версия может поддерживать любое количество исправлений в определенное время. AKS оставляет за собой право прекратить поддержку исправлений в случае обнаружения критической уязвимости CVE или проблемы безопасности. Чтобы получить информацию о доступности исправлений и любых временных отзывов, см. примечания к версии и посетите веб-страницу состояния выпуска AKS.

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

AKS предоставляет поддержку платформы только для одной незначительной версии Kubernetes общедоступной версии после окончания поддержки обычных версий. Окно поддержки версий Kubernetes на платформе AKS называется N-3. Для получения дополнительной информации см. политику поддержки платформы.

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

Например, в день, когда AKS вводит версию 1.29, поддержка предоставляется для следующих версий:

Когда выпускается новая минорная версия, самая старая минорная версия становится устаревшей и удаляется. Например, предположим, что текущий поддерживаемый список минорных версий — 1.29, 1.28 и 1.27. Когда AKS выпускает 1.30, все версии 1.27 выходят из поддержки 30 дней спустя.

AKS может поддерживать любое количество исправлений на основе доступности выпуска основного сообщества для данной минорной версии. AKS оставляет за собой право объявить любое из этих исправлений устаревшим в любое время из-за уязвимости (CVE) или потенциальной ошибки. Мы рекомендуем использовать последний патч для минорной версии.

Политика поддержки платформы

Политика поддержки платформы — это сокращенный план поддержки для некоторых неподдерживаемых версий Kubernetes. Во время поддержки платформы клиенты получают поддержку только от Microsoft по вопросам, связанным с платформой AKS/Azure. Мы не оказываем поддержку по вопросам, связанным с функциями и компонентами Kubernetes.

Политика поддержки платформы применяется к кластерам в версии N-3 (где N является последней поддерживаемой минорной версией AKS GA), прежде чем версия кластера опустится до N-4. Например, Kubernetes v1.26 считается поддержкой платформы, если последней GA-версией является v1.29. Предположим, что вы используете версию N-2 . Как только версия достигает N-3, ее официальная поддержка завершается, и вы переходите на политику поддержки платформы.

AKS использует выпуски и исправления от Kubernetes, который является проектом с открытым исходным кодом и поддерживает только скользящее окно из трех минорных версий. AKS может гарантировать полную поддержку , пока эти версии обслуживаются вышестоящими. Так как больше нет исправлений, создаваемых от исходного поставщика, AKS может либо оставить эти версии неисправленными, либо создать форк. Из-за этого ограничения платформа не может полагаться на поддержку из основного источника Kubernetes.

В следующей таблице приведены рекомендации по поддержке сообщества по сравнению с поддержкой платформы.

Поддерживаемые версии kubectl

Вы можете использовать kubectl версию, которая является одной минорной версией старше или младше, чем версия kube-apiserver. Дополнительные сведения см. в политике поддержки Kubernetes для kubectl.

Например, если kube-apiserver версии 1.28, можно использовать версии от 1.27 до 1.29kubectl.

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

az aks install-cli

Install-AzAksKubectl -Version latest

Долгосрочная поддержка (LTS)

AKS предлагает один год поддержки сообщества и один год долгосрочной поддержки (LTS), включая исправления безопасности, перенесенные из нижестоящего сообщества. Наша основная рабочая группа LTS вносит вклад в сообщество, чтобы предоставить нашим клиентам более длительный период поддержки.

Дополнительные сведения о LTS см. в разделе долгосрочная поддержка для службы Azure Kubernetes (AKS).

Процесс выпуска и вывода из эксплуатации

Сведения о предстоящих выпусках и устаревших версиях см. в календаре выпуска AKS Kubernetes.

Для новых минорных версий Kubernetes

• AKS объявляет даты выпуска новых версий и снятие старых версий с поддержки в заметках о выпуске AKS за не менее чем 30 дней до удаления.

• AKS использует Помощник по Azure для оповещения о том, что новая версия может вызвать проблемы в кластере из-за устаревших API. Помощник по Azure также оповещает вас, если у вас нет поддержки.

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

  Note

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

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

Для новых патч версий Kubernetes:

• Из-за срочного характера исправлений они могут быть добавлены в службу, как только станут доступны. Как только они становятся доступными, исправления имеют минимальный жизненный цикл в два месяца.
• Как правило, AKS широко не сообщает о выпуске новых версий исправлений. Однако AKS постоянно отслеживает и проверяет наличие доступных исправлений CVE, чтобы своевременно применять их в AKS. Если обнаружен критически важный исправление или требуется действие пользователя, AKS уведомляет вас об обновлении до нового доступного исправления.
• У вас есть 30 дней после удаления исправления из AKS для обновления до поддерживаемого исправления и продолжения получения поддержки. Однако вы больше не сможете создавать кластеры или пулы узлов после удаления версии.

Исключения из политики поддержки версий

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

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

Версии на портале Azure и в интерфейсе командной строки

При развертывании кластера AKS с помощью портала Azure, Azure CLI или Azure PowerShell кластер по умолчанию использует дополнительную версию N-1 и последнее исправление.

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

# The following example lists the available Kubernetes versions for the EastUS region:

az aks get-versions --location eastus --output table

# The following example lists the available Kubernetes versions for the EastUS region:

Get-AzAksVersion -Location eastus

Часто задаваемые вопросы (FAQ)

Как корпорация Майкрософт уведомляет о новых версиях Kubernetes?

Команда AKS объявляет о новых датах выпуска версии Kubernetes в нашей документации, на сайте GitHub и по электронной почте администраторам подписки с кластерами, приближающимися к концу поддержки. AKS также использует Помощник по Azure, чтобы предупреждать вас внутри портала Azure, если у вас нет поддержки, и чтобы уведомить вас о устаревших API, которые могут повлиять на ваше приложение или процесс разработки.

Как часто следует ждать обновления версий Kubernetes, чтобы поддерживать продукт в актуальном состоянии?

Начиная с Kubernetes 1.19, открытый код сообщество расширило поддержку до одного года. AKS стремится предоставлять патчи и поддержку в соответствии с обязательствами, принятыми на вышестоящем уровне. Для кластеров AKS в версии 1.19 и более поздних версий можно обновить как минимум один раз в год, чтобы оставаться в поддерживаемой версии.

Что произойдет при обновлении кластера Kubernetes на минорную версию, которая не поддерживается?

Если ваша версия не поддерживается в списке поддерживаемых версий Kubernetes, необходимо обновить. Вы можете обновить неподдерживаемые версии до поддерживаемых версий. Рассмотрим пример.

• Если минимальная поддерживаемая версия AKS — 1.33 , и вы находитесь в версии 1.32 или более ранней версии, вы выходите за рамки поддержки.
• При успешном обновлении с версии 1.32 до версии 1.33 или более поздней версии вы вернеесь в политики поддержки.

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

Что значит быть "вне поддержки"?

"Вне поддержки" означает:

• Используемая версия не входит в список поддерживаемых.
• При запросе поддержки вам будет предложено обновить кластер до поддерживаемой версии, если вы не воспользовались 30-дневным периодом отсрочки после перевода текущей версии в разряд нерекомендуемых.

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

Можете ли вы остаться на версии Kubernetes навсегда?

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

Что произойдет, если масштабировать кластер Kubernetes с минорной версией, которая не поддерживается?

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

Какую версию поддерживает контрольная плоскость, если пул узлов не использует одну из поддерживаемых версий AKS?

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

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

Теперь политика отклонения версий позволяет различать до трех версий между плоскостью управления и пулами агентов. AKS следует этому изменению политики версий, начиная с версии 1.28.

Можно ли пропустить несколько версий AKS во время обновления кластера?

Да, в некоторых случаях можно пропускать минорные версии. Однако, если вы обновляете плоскость управления независимо от пулов узлов, необходимо соблюдать политики совместимости версий Kubernetes. Политика отклонения версий Kubernetes в настоящее время поддерживает только N-3, поэтому плоскость управления и пулы агентов должны находиться в пределах N-3 друг от друга.

• LTS: версия с включенным планом поддержки AKS Long-Term. См. версии LTS.
• Неподдерживаемая версия LTS: версия с поддержкой LTS, которая находится после окончания срока жизни LTS в таблице версий LTS .
• Поддерживается не LTS: версия, которая не является LTS, но по-прежнему указана как поддерживаемая в календаре выпуска AKS Kubernetes.
• Неподдерживаемая не-LTS-версия: версия, которая не относится к LTS и больше не указана как поддерживаемая в календаре выпусков Kubernetes AKS.

Примеры:

• Если ваш кластер использует 1.29 LTS и вы хотите перейти на 1.32 LTS, вы можете пропустить несколько второстепенных версий, при условии, что 1.32 LTS по-прежнему доступна в AKS и обновление проходит проверки допустимого расхождения версий и валидации.
• Если в вашем кластере используется версия 1.28 без LTS, вы можете перейти на AKS LTS 1.30 LTS, используя неподдерживаемый путь восстановления, при условии, что целевая версия указана в AKS, проходит проверки валидации и выполняется полное обновление кластера, а не control-plane-only.
• Если ваш кластер работает на поддерживаемой версии без LTS 1.33 и вы хотите перейти на поддерживаемую версию без LTS 1.35, вы не можете перейти напрямую с 1.33 на 1.35. Необходимо обновить одну дополнительную версию за раз, например 1.33 до 1.34, а затем 1.34 до 1.35.

В приведённой выше таблице Unsupported recovery path указывает, что обновление выполняется по сценарию, безопасность которого не может быть гарантирована, и поэтому оно не поддерживается. AKS позволяет продолжить обновление, но оно не поддерживается и может привести к рискам.

Чтобы выбрать правильный путь, проверьте доступные целевые объекты, выполнив команду az aks get-upgrades --resource-group <resource-group-name> --name <cluster-name>. Просмотрите предыдущую таблицу, а затем оцените риск обновления по сравнению с пересозданием кластера и переносом рабочих нагрузок.

Можно ли создать кластер версии 1.xx.x во время окна поддержки платформы?

Нет, создание новых кластеров невозможно в течение периода поддержки платформы.

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

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

Связанный контент

Дополнительные сведения об обновлениях кластера AKS см. в статье:

• Практическое руководство по обновлению кластера Службы Azure Kubernetes (AKS)
• Обновление нескольких кластеров AKS с помощью Диспетчера флотов Azure Kubernetes