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

Заметки о выпуске ядра AKS в Azure Stack Hub

  • Статья

Применяется к версии 0.80.2 ядра AKS.

В этой статье описывается содержимое обновления обработчика Azure Kubernetes Service (AKS) в Azure Stack Hub. Это обновление содержит улучшения и исправления для последнего выпуска обработчика AKS, предназначенной для платформы Azure Stack Hub. Эта статья не предназначена для документирования сведений о выпуске подсистемы AKS для глобальной платформы Azure.

Моменты, которые следует учитывать при обновлении

  • Вы используете правильные элементы Marketplace, akS Base Ubuntu 20.04 Image Distro или AKS Base Windows Server для вашей версии ядра AKS? В разделе " Скачивание новых образов" и подсистемы AKS можно найти версии.
  • Вы используете правильную спецификацию кластера (apimodel.json) и группу ресурсов для целевого кластера? Этот файл был создан в выходном каталоге при первоначальном развертывании кластера. См. параметры команды развертывания Развертывания кластера Kubernetes.
  • Вы используете надежный компьютер для запуска ядра AKS и от которого выполняется обновление?
  • Если вы обновляете операционный кластер с активными рабочими нагрузками, вы можете применить обновление, не затрагивая их, если кластер находится под обычной нагрузкой. Однако в случае необходимости перенаправлять пользователей на него необходимо иметь кластер резервного копирования. Настоятельно рекомендуется использовать резервный кластер.
  • Если это возможно, выполняйте команду на виртуальной машине в среде Azure Stack Hub, чтобы снизить число сетевых прыжков и рисков сбоев подключения.
  • Убедитесь, что ваша подписка имеет достаточную квоту для завершения процесса. Этот процесс связан с выделением новых виртуальных машин. Результирующее количество виртуальных машин будет совпадать с исходным, но планируется создать несколько виртуальных машин во время процесса.
  • Не запланировано обновлений системы или других задач.
  • Настройте промежуточное обновление в кластере с теми же значениями параметров, что и у рабочего кластера, и проверьте в нем обновление перед тем, как запускать его в рабочем кластере.

Использование команды upgrade

Необходимо использовать aks-engine upgrade команду, как описано в разделе "Обновление кластера Kubernetes в Azure Stack Hub".

Прерывания обновления

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

Предполагаемое время обновления

Предполагаемое время обновления — 12–15 минут на виртуальную машину в кластере. Например, кластер с 20 узлами может занять около 5 часов для обновления.

Инструкции по использованию модуля AKS 0.70.0 и выше

Скачивание нового образа и обработчика AKS

Скачайте новые версии базового образа Ubuntu AKS и ядра AKS.

Как описано в документации по обработчику AKS для Azure Stack Hub, для развертывания кластера Kubernetes требуется:

  • Двоичный файл aks-engine (обязательный).
  • Дистрибутив образа AKS Base Ubuntu 16.04-LTS (устаревший — больше не используется, измените модель API на использование 20.04).
  • Дистрибутив образа AKS Base Ubuntu 18.04-LTS (устаревший — больше не используется, измените модель API, чтобы использовать вместо этого 20.04).
  • Дистрибутив образа AKS Base Ubuntu 20.04-LTS (требуется для агентов Linux).
  • Базовый образ Windows Server AKS (один из следующих образов необходим для агентов Windows):
    • Контейнеры образов Windows Server базы AKS.
    • AKS Base Windows Server Image Docker.

Новые версии этих образов доступны в этом обновлении:

Обновление кластеров Kubernetes, созданных с помощью дистрибутива Ubuntu 16.04

Начиная с модуля AKS версии 0.63.0 дистрибутив Ubuntu 16.04 больше не поддерживается, так как ОС достигла его окончания. Для модулей AKS версии 0.67.0 или более поздних версий модуль aks-engine автоматически перезаписывает неподдерживаемое aks-ubuntu-16.04 значение дистрибутива с помощью aks-ubuntu-18.04. Для модулей AKS версии 0.75.3 или более поздних версий, если вы используете Kubernetes версии 1.24 или более поздней версии, обновление aks-engine-azurestack автоматически перезаписывает неподдерживаемое aks-ubuntu-16.04 значение дистрибутива.aks-ubuntu-20.04

Обновление кластеров Kubernetes, созданных с помощью дистрибутива Ubuntu 18.04

Начиная с модуля AKS версии 0.75.3 дистрибутив Ubuntu 18.04 больше не поддерживается, так как ОС достигла его окончания. Для akS Engine версии 0.75.3 или более поздних версий обновление aks-engine-azurestack автоматически перезаписывает неподдерживаемое aks-ubuntu-18.04 значение дистрибутива.aks-ubuntu-20.04

Обновление кластеров Kubernetes, созданных с помощью среды выполнения контейнеров Docker

В Kubernetes версии 1.24 компонент dockershim был удален из kubelet. В результате среда выполнения контейнера Docker больше не поддерживается. Дополнительные сведения см. в заметках о выпуске Kubernetes версии 1.24. Для модулей AKS версии 0.75.3 или более поздних версий обновление aks-engine-azurestack автоматически перезаписывает неподдерживаемое docker containerRuntime значение containerd.

Для ядра AKS версии 0.75.3 кластеры с узлами Windows в Kubernetes версии 1.23 могут использовать базовый образ Windows с средой выполнения Docker. Кластеры с узлами Windows в Kubernetes версии 1.24 могут использовать базовый образ Windows с контейнерной средой выполнения.

Сопоставление обработчика AKS и версии Azure Stack

Версия Azure Stack Hub Версия обработчика AKS
1910 0.43.0, 0.43.1
2002 0.48.0, 0.51.0
2005 0.48.0, 0.51.0, 0.55.0, 0.55.4
2008 0.55.4, 0.60.1
2102 0.60.1, 0.63.0, 0.67.0, 0.67.3
2108 0.63.0, 0.67.0, 0.67.3, 0.70.0, 0.71.0, 0.73.0, 0.75.3, 0.76.0
2206 0.70.0, 0.71.0, 0.73.0, 0.75.3, 0.76.0, 0.77.0
2301 0.75.3, 0.76.0, 0.77.0, 0.78.0, 0.79.0
2306 0.78.0, 0.79.0*, 0.80.2*
2311 0.80.2*
2406 0.80.2*

Примечание.

Поддерживается.* Дополнительные сведения см. в политике поддержки версий ядра AKS.

Подсистема AKS и соответствующее сопоставление изображений

Поддерживаемые версии Kubernetes для ядра AKS можно найти в Azure Stack Hub в следующей таблице. Не используйте команду aks-engine get-versions , которая возвращает версии, поддерживаемые в глобальной среде Azure, а также в Azure Stack Hub.

Обработчик AKS Базовый образ AKS Версии Kubernetes Примеры модели API
Версия 0.43.1 Дистрибутив базового образа AKS для Ubuntu 16.04-LTS за октябрь 2019 г. (24.10.2019) 1.15.5, 1.15.4, 1.14.8, 1.14.7
Версия 0.48.0 Дистрибутив базового образа AKS для Ubuntu 16.04-LTS за май 2020 г. (2020.03.19) 1.15.10, 1.14.7
Версия 0.51.0 Дистрибутив образа AKS Base Ubuntu 16.04-LTS, май 2020 г. (2020.05.13), базовый образ Windows AKS (17763.1217.200513) 1.15.12, 1.16.8, 1.16.9 Linux, Windows
Версия 0.55.0 Дистрибутив образа AKS Base Ubuntu 16.04-LTS, август 2020 г. (2020.08.24), базовый образ Windows AKS (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
Версия 0.55.4 Дистрибутив образа AKS Base Ubuntu 16.04-LTS, сентябрь 2020 г. (2020.09.14), базовый образ Windows AKS (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
Версия 0.60.1 Дистрибутив образа AKS Base Ubuntu 16.04-LTS, январь 2021 г. (2021.01.28),
AkS Base Ubuntu 18.04-LTS Image Distro, 2021 Q1 (2021.01.28),
Базовый образ AKS для Windows (17763.1697.210129)		 1.16.14, 1.16.15, 1.17.17, 1.18.15 Linux, Windows
v0.63.0 Дистрибутив образа AKS Base Ubuntu 18.04-LTS, 2021 Q2 (2021.05.24), базовый образ Windows AKS (17763.1935.210520) 1.18.18, 1.19.10, 1.20.6 Примеры модели API (Linux, Windows)
v0.67.0 Дистрибутив образа AKS Base Ubuntu 18.04-LTS, 2021 Q3 (2021.09.27), базовый образ Windows AKS (17763.2213.210927) 1.19.15, 1.20.11 Примеры модели API (Linux, Windows)
v0.67.3 Дистрибутив образа AKS Base Ubuntu 18.04-LTS, 2021 Q3 (2021.09.27), базовый образ Windows AKS (17763.2213.210927) 1.19.15, 1.20.11 Примеры модели API (Linux, Windows)
v0.70.0 Дистрибутив образа AKS Base Ubuntu 18.04-LTS, 2022 Q2 (2022.04.07),базовый образ Windows AKS (17763.2565.220408) 1.21.10*, 1.22.7* Примеры модели API (Linux, Windows)
v0.71.0 Дистрибутив образа AKS Base Ubuntu 18.04-LTS, 2022 Q3 (2022.08.12), базовый образ Windows AKS (17763.3232.220805) 1.22.7*, 1.23.6* Примеры модели API (Linux, Windows)
v0.73.0 Дистрибутив образа AKS Base Ubuntu 18.04-LTS, 2022 Q4 (2022.11.02), базовый образ Windows AKS (17763.3532.221102) 1.22.15*, 1.23.13* Примеры модели API (Linux, Windows)
v0.75.3 Дистрибутив образа AKS Base Ubuntu 20.04-LTS (2023.032.2), контейнер образов Docker базового образа AKS Для Windows Server 2019 (17763.3887.20230332), контейнер образа AKS base Windows Server 2019 (17763.3887.20230332) 1.23.15*, 1.24.9** Примеры модели API (Linux, Windows)
v0.76.0 Дистрибутив образа AKS Base Ubuntu 20.04-LTS (2023.116.3), контейнер образа AKS Base Windows Server 2019 (17763.4252.20231163) 1.24.11**, 1.25.7** Примеры модели API (Linux, Windows)
v0.77.0 Дистрибутив образа AKS Base Ubuntu 20.04-LTS (2023.206.1), контейнер образа AKS Base Windows Server 2019 (17763.4645.20232061) 1.25.7**, 1.26.6** Примеры модели API (Linux, Windows)
v0.78.0 Дистрибутив образа AKS Base Ubuntu 20.04-LTS (2023.242.3), контейнер образа AKS Base Windows Server 2019 (17763.4737.2023233) 1.25.13**, 1.26.8** Примеры модели API (Linux, Windows)
v0.79.0 Дистрибутив образа AKS Base Ubuntu 20.04-LTS (2023.296.1), контейнер образа AKS Base Windows Server 2019 (17763.4974.20232961) 1.26.9**, 1.27.6** Примеры модели API (Linux, Windows)
v0.80.2 Дистрибутив образа AKS Base Ubuntu 20.04-LTS (2024.032.1), контейнер образа AKS Base Windows Server 2019 (17763.5329.20240321) 1.27.10**, 1.28.6** Примеры модели API (Linux, Windows)

Примечание.

*Начиная с Kubernetes версии 1.21, в Azure Stack Hub поддерживается только поставщик облачных служб Azure.

Примечание.

** Начиная с Kubernetes версии 1.24, поддерживается только containerd среда выполнения контейнера. Дополнительные сведения см. в разделе Об обновлении кластеров Kubernetes, созданных с помощью среды выполнения контейнеров Docker.

Планирование обновлений

Команда ядра upgrade AKS полностью автоматизирует процесс обновления кластера и обрабатывает виртуальные машины (виртуальные машины), сети, хранилище, Kubernetes и задачи оркестрации. Перед применением обновления обязательно просмотрите сведения о заметке о выпуске.

Новые возможности AKSe 0.76.0

  • Добавлена поддержка Kubernetes версии 1.24.11 и версии 1.25.7.
  • Другие функции можно найти на странице GitHub версии 0.76.0.

Новые возможности AKSe 0.75.3 и более поздних версий

Модуль AKS версии 0.75.3 и все будущие выпуски ядра AKS в Azure Stack Hub будут использоваться в новом репозитории aks-engine-azurestack. Таким образом, все aks-engine команды должны быть заменены aks-engine-azurestackна . Команды для получения последнего выпуска ядра AKS в Azure Stack Hub также изменились. Новые команды можно просмотреть в разделе "Создание клиента Linux" и "Создание клиента Windows". При обнаружении проблем создайте проблему в новом репозитории.

Модуль AKS версии 0.75.3 в Azure Stack Hub предлагает Ubuntu 20.04 LTS в качестве базового образа Linux. Начиная с этого выпуска, Ubuntu 18.04 больше не поддерживается. Дополнительные сведения см. в статье об обновлении кластеров Kubernetes, созданных с помощью дистрибутива Ubuntu 18.04.

Начиная с Kubernetes версии 1.24, поддерживается только containerd среда выполнения. Дополнительные сведения см. в статье об обновлении кластеров Kubernetes, созданных с помощью среды выполнения Docker. Для ядра AKS версии 0.75.3 кластеры с узлами Windows в Kubernetes версии 1.23 могут использовать базовый образ Windows с средой выполнения Docker. Кластеры с узлами Windows в Kubernetes версии 1.24 могут использовать базовый образ Windows с контейнерной средой выполнения.

Дополнительные возможности можно найти на странице GitHub версии 0.75.3.

Инструкции по использованию модуля AKS 0.70.0 и выше

Корпорация Майкрософт обновила поставщик облачных служб Azure версии 0.70.0. Поставщик облачных служб Azure — это основной компонент, совместно используемый подсистемой AKS Azure и AKS в Azure Stack Hub.

Чтобы использовать подсистему AKS 0.70.0 и более поздней версии:

  • Если вы впервые пытаетесь создать новый кластер Kubernetes: используйте пример модели API, предоставленной для соответствующей версии в подсистеме AKS и соответствующей таблице сопоставления изображений.

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

  • Если вы используете тома хранилища: убедитесь, что вы используете драйвер AzureDiskCSI . Версия 0.70.0 и выше поддерживает только драйверы CSI, а не устаревший поставщик хранилища в дереве. Чтобы обновить, следуйте инструкциям при обновлении при использовании томов хранилища.

Известные проблемы

  • Параллельное развертывание нескольких служб Kubernetes в одном кластере может привести к ошибке в конфигурации базовой подсистемы балансировки нагрузки. Рекомендуется развертывать одну службу одновременно.
  • Так как средство aks-engine — это общий репозиторий исходного кода в Azure и Azure Stack Hub, изучение множества заметок о выпуске и запросов на вытягивание может привести к тому, что средство поддерживает другие версии Kubernetes и платформы ОС за пределами перечисленных выше. Их можно игнорировать и использовать приведенную выше таблицу версий в качестве официального руководства по этому обновлению.
  • Ядро AKS версии 0.67.0 использует неправильный образ Windows при развертывании кластеров Windows. Чтобы устранить эту проблему, используйте версию 0.70.0.

Справочные материалы

Ниже приведен полный набор заметок о выпуске для Azure и Azure Stack Hub в сочетании:

Применяется к версии 0.67.0 ядра AKS.

В этой статье описывается содержимое обновления обработчика Azure Kubernetes Service (AKS) в Azure Stack Hub. Это обновление содержит улучшения и исправления для последнего выпуска обработчика AKS, предназначенной для платформы Azure Stack Hub. Эта статья не предназначена для документирования сведений о выпуске подсистемы AKS для глобальной платформы Azure.

Планирование обновлений

Команда ядра upgrade AKS полностью автоматизирует процесс обновления кластера. Она обрабатывает виртуальные машины (виртуальные машины), сети, хранилище, Kubernetes и задачи оркестрации. Перед применением обновления обязательно просмотрите сведения о заметке о выпуске.

Моменты, которые следует учитывать при обновлении

  • Вы используете правильные элементы Marketplace, AKS Base Ubuntu 16.04-LTS или 18.04 Image Distro или AKS Base Windows Server для вашей версии ядра AKS? Вы можете найти версии в разделе "Скачивание новых образов и подсистемы AKS".
  • Вы используете правильную спецификацию кластера (apimodel.json) и группу ресурсов для целевого кластера? Этот файл был создан в выходном каталоге при первоначальном развертывании кластера. См. параметры команды развертывания Развертывания кластера Kubernetes.
  • Вы используете надежный компьютер для запуска обработчика AKS и от которого выполняется обновление?
  • Если вы обновляете операционный кластер с активными рабочими нагрузками, вы можете применить обновление, не затрагивая их, если кластер находится под обычной нагрузкой. Однако в случае необходимости перенаправлять пользователей на него необходимо иметь кластер резервного копирования. Настоятельно рекомендуется использовать резервный кластер.
  • Если это возможно, выполняйте команду на виртуальной машине в среде Azure Stack Hub, чтобы снизить число сетевых прыжков и рисков сбоев подключения.
  • Убедитесь, что ваша подписка имеет достаточную квоту для завершения процесса. Этот процесс связан с выделением новых виртуальных машин. Результирующее количество виртуальных машин будет совпадать с исходным, но планируется создать несколько виртуальных машин во время процесса.
  • Не запланировано обновлений системы или других задач.
  • Настройте промежуточное обновление в кластере с теми же значениями параметров, что и у рабочего кластера, и проверьте в нем обновление перед тем, как запускать его в рабочем кластере.

Использование команды upgrade

Необходимо использовать aks-engine upgrade команду, как описано в разделе "Обновление кластера Kubernetes в Azure Stack Hub".

Прерывания обновления

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

Предполагаемое время обновления

Предполагаемое время обновления — 12–15 минут на виртуальную машину в кластере. Например, кластер с 20 узлами может занять около 5 часов для обновления.

Скачивание нового образа и обработчика AKS

Скачайте новые версии базового образа Ubuntu AKS и ядра AKS.

Как описано в документации по обработчику AKS для Azure Stack Hub, для развертывания кластера Kubernetes требуется:

  • Двоичный файл aks-engine (обязательный).
  • Дистрибутив образа AKS Base Ubuntu 16.04-LTS (устаревший — больше не используется, измените модель API на использование 18.04).
  • Дистрибутив образа AKS Base Ubuntu 18.04-LTS (требуется для агентов Linux).
  • Дистрибутив образов Windows Server базы AKS (требуется для агентов Windows).

Новые версии этих образов доступны в этом обновлении:

Обновление кластеров Kubernetes, созданных с помощью дистрибутива Ubuntu 16.04

Начиная с модуля AKS версии 0.67.0 дистрибутив Ubuntu 16.04 больше не поддерживается, так как ОС достигла его окончания. Чтобы обновить кластер, обязательно установите дистрибутив aks-ubuntu-18.04 ОС в входной модели API, который создается aks-engine deploy и передается в качестве входных данных aks-engine upgrade:

"masterProfile": {
    "distro": "aks-ubuntu-18.04"
},

"agentPoolProfiles": [{
    "distro": "aks-ubuntu-18.04"
}]

Сопоставление обработчика AKS и версии Azure Stack

Версия Azure Stack Hub Версия обработчика AKS
1910 0.43.0, 0.43.1
2002 0.48.0, 0.51.0
2005 0.48.0, 0.51.0, 0.55.0, 0.55.4
2008 0.55.4, 0.60.1
2102 0.60.1, 0.63.0, 0.67.0
2108 0.63.0, 0.67.0

Путь обновления версии Kubernetes в подсистеме AKS версии 0.67.0

Текущую версию и версию обновления для Azure Stack Hub можно найти в следующей таблице. Эта таблица относится к кластеру подсистемы AKS в Azure Stack Hub. Не используйте команду aks-engine get-versions , которая возвращает версии, поддерживаемые в глобальной среде Azure, а также в Azure Stack Hub.

Текущая версия Доступное обновление
1.15.12 1.16.14, 1.16.15
1.16.14 1.16.15, 1.17.17
1.17.11, 1.17.17 1.18.18
1.18.15, 1.18.18 1.19.10
1.19.10 1.19.15, 1.20.11
1.20.6 1.20.11

В JSON-файле модели API укажите значения выпуска и версии в orchestratorProfile разделе. Например, если вы планируете развернуть Kubernetes 1.17.17, необходимо задать следующие два значения (см. пример kubernetes-azurestack.json):

-   "orchestratorRelease": "1.17",
-   "orchestratorVersion": "1.17.17"

Подсистема AKS и соответствующее сопоставление изображений

Обработчик AKS Базовый образ AKS Версии Kubernetes Примеры модели API
Версия 0.43.1 Дистрибутив базового образа AKS для Ubuntu 16.04-LTS за октябрь 2019 г. (24.10.2019) 1.15.5, 1.15.4, 1.14.8, 1.14.7
Версия 0.48.0 Дистрибутив базового образа AKS для Ubuntu 16.04-LTS за май 2020 г. (2020.03.19) 1.15.10, 1.14.7
Версия 0.51.0 Дистрибутив образа AKS Base Ubuntu 16.04-LTS, май 2020 г. (2020.05.13), базовый образ Windows AKS (17763.1217.200513) 1.15.12, 1.16.8, 1.16.9 Linux, Windows
Версия 0.55.0 Дистрибутив образа AKS Base Ubuntu 16.04-LTS, август 2020 г. (2020.08.24), базовый образ Windows AKS (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
Версия 0.55.4 Дистрибутив образа AKS Base Ubuntu 16.04-LTS, сентябрь 2020 г. (2020.09.14), базовый образ Windows AKS (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
Версия 0.60.1 Дистрибутив образа AKS Base Ubuntu 16.04-LTS, январь 2021 г. (2021.01.28),
AkS Base Ubuntu 18.04-LTS Image Distro, 2021 Q1 (2021.01.28),
Базовый образ AKS для Windows (17763.1697.210129)		 1.16.14, 1.16.15, 1.17.17, 1.18.15 Linux, Windows
v0.63.0 Дистрибутив образа AKS Base Ubuntu 18.04-LTS, 2021 Q2 (2021.05.24), базовый образ Windows AKS (17763.1935.210520) 1.18.18, 1.19.10, 1.20.6 Примеры модели API (Linux, Windows)
v0.67.0 Дистрибутив образа AKS Base Ubuntu 18.04-LTS, 2021 Q3 (2021.09.27), базовый образ Windows AKS (17763.2213.210927) 1.19.15, 1.20.11 Примеры модели API (Linux, Windows)

Новые возможности

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

В числе новых функций:

  • Поддержка Kubernetes 1.19.15 и 1.20.11

Известные проблемы

  • Параллельное развертывание нескольких служб Kubernetes в одном кластере может привести к ошибке в конфигурации базовой подсистемы балансировки нагрузки. Рекомендуется развертывать одну службу одновременно.
  • Так как средство aks-engine — это общий репозиторий исходного кода в Azure и Azure Stack Hub, изучение множества заметок о выпуске и запросов на вытягивание может привести к тому, что средство поддерживает другие версии Kubernetes и платформы ОС за пределами перечисленных выше. Их можно игнорировать и использовать приведенную выше таблицу версий в качестве официального руководства по этому обновлению.

Справочные материалы

Ниже приведен полный набор заметок о выпуске для Azure и Azure Stack Hub в сочетании:

Применяется к версии 0.60.1 ядра AKS.

В этой статье описывается содержимое обновления обработчика Azure Kubernetes Service (AKS) в Azure Stack Hub. Это обновление содержит улучшения и исправления для последнего выпуска обработчика AKS, предназначенной для платформы Azure Stack Hub. Эта статья не предназначена для документирования сведений о выпуске подсистемы AKS для глобальной платформы Azure.

Планирование обновлений

Команда ядра upgrade AKS полностью автоматизирует процесс обновления кластера и обрабатывает виртуальные машины (виртуальные машины), сети, хранилище, Kubernetes и задачи оркестрации. Перед применением обновления обязательно просмотрите сведения о заметке о выпуске.

Моменты, которые следует учитывать при обновлении

  • Вы используете правильные элементы Marketplace, AKS Base Ubuntu 16.04-LTS или 18.04 Image Distro или AKS Base Windows Server для вашей версии ядра AKS? Вы можете найти версии в разделе "Скачивание новых образов и подсистемы AKS".
  • Вы используете правильную спецификацию кластера (apimodel.json) и группу ресурсов для целевого кластера? Этот файл был создан в выходном каталоге при первоначальном развертывании кластера. См. параметры команды развертывания Развертывания кластера Kubernetes.
  • Вы используете надежный компьютер для запуска обработчика AKS и от которого выполняется обновление?
  • Если вы обновляете операционный кластер с активными рабочими нагрузками, вы можете применить обновление, не затрагивая их, если кластер находится под обычной нагрузкой. Однако в случае необходимости перенаправлять пользователей на него необходимо иметь кластер резервного копирования. Настоятельно рекомендуется использовать резервный кластер.
  • Если это возможно, выполняйте команду на виртуальной машине в среде Azure Stack Hub, чтобы снизить число сетевых прыжков и рисков сбоев подключения.
  • Убедитесь, что ваша подписка имеет достаточную квоту для завершения процесса. Этот процесс связан с выделением новых виртуальных машин. Результирующее количество виртуальных машин будет совпадать с исходным, но планируется создать несколько виртуальных машин во время процесса.
  • Не запланировано обновлений системы или других задач.
  • Настройте промежуточное обновление в кластере с теми же значениями параметров, что и у рабочего кластера, и проверьте в нем обновление перед тем, как запускать его в рабочем кластере.

Использование команды upgrade

Необходимо использовать aks-engine upgrade команду, как описано в разделе "Обновление кластера Kubernetes в Azure Stack Hub".

Прерывания обновления

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

Предполагаемое время обновления

Предполагаемое время обновления — 12–15 минут на виртуальную машину в кластере. Например, кластер с 20 узлами может занять около 5 часов для обновления.

Скачивание нового образа и обработчика AKS

Скачайте новые версии базового образа Ubuntu AKS и ядра AKS.

Как описано в документации по подсистеме AKS в Azure Stack Hub, для развертывания кластера Kubernetes требуется:

  • Двоичный файл aks-engine (обязательный).
  • Дистрибутив образа AKS Base Ubuntu 16.04-LTS (устаревший — больше не используется, измените модель API на использование 18.04).
  • Дистрибутив образа AKS Base Ubuntu 18.04-LTS (требуется для агентов Linux).
  • Дистрибутив образов Windows Server базы AKS (требуется для агентов Windows).

Новые версии этих компонентов доступны в этом обновлении:

Сопоставление обработчика AKS и версии Azure Stack

Версия Azure Stack Hub Версия обработчика AKS
1910 0.43.0, 0.43.1
2002 0.48.0, 0.51.0
2005 0.48.0, 0.51.0, 0.55.0, 0.55.4
2008 0.55.4, 0.60.1

Путь обновления версии Kubernetes в подсистеме AKS версии 0.60.1

Текущую версию и версию обновления для Azure Stack Hub можно найти в следующей таблице. Эта таблица относится к кластеру подсистемы AKS в Azure Stack Hub. Не используйте команду aks-engine get-versions , которая возвращает версии, поддерживаемые в глобальной среде Azure, а также в Azure Stack Hub.

Текущая версия Доступное обновление
1.15.12 1.16.14, 1.16.15
1.16.14 1.16.15, 1.17.17
1.17.11 1.17.17, 1.18.15
1.17.17 1.18.15

В JSON-файле модели API укажите значения выпуска и версии в orchestratorProfile разделе. Например, если вы планируете развернуть Kubernetes 1.17.17, необходимо задать следующие два значения (см. пример kubernetes-azurestack.json):

-   "orchestratorRelease": "1.17",
-   "orchestratorVersion": "1.17.17"

Подсистема AKS и соответствующее сопоставление изображений

Обработчик AKS Базовый образ AKS Версии Kubernetes Примеры модели API
Версия 0.43.1 Дистрибутив базового образа AKS для Ubuntu 16.04-LTS за октябрь 2019 г. (24.10.2019) 1.15.5, 1.15.4, 1.14.8, 1.14.7
Версия 0.48.0 Дистрибутив базового образа AKS для Ubuntu 16.04-LTS за май 2020 г. (2020.03.19) 1.15.10, 1.14.7
Версия 0.51.0 Дистрибутив образа AKS Base Ubuntu 16.04-LTS, май 2020 г. (2020.05.13), базовый образ Windows AKS (17763.1217.200513) 1.15.12, 1.16.8, 1.16.9 Linux, Windows
Версия 0.55.0 Дистрибутив образа AKS Base Ubuntu 16.04-LTS, август 2020 г. (2020.08.24), базовый образ Windows AKS (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
Версия 0.55.4 Дистрибутив образа AKS Base Ubuntu 16.04-LTS, сентябрь 2020 г. (2020.09.14), базовый образ Windows AKS (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
Версия 0.60.1 Дистрибутив образа AKS Base Ubuntu 16.04-LTS, январь 2021 г. (2021.01.28),
AkS Base Ubuntu 18.04-LTS Image Distro, 2021 Q1 (2021.01.28),
Базовый образ AKS для Windows (17763.1697.210129)		 1.16.14, 1.16.15, 1.17.17, 1.18.15 Linux, Windows

Новые возможности

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

В числе новых функций:

  • Общая доступность Ubuntu 18.04.
  • Общедоступная предварительная версия смены сертификатов #4214.
  • T4 Nvidia GPU Private Preview #4259.
  • Частная предварительная версия интеграции Azure Active Directory.
  • Драйвер CSI для больших двоичных объектов Azure Private Preview #712.
  • Драйвер CSI Для дисков Azure общедоступная предварительная версия #712.
  • Общедоступная предварительная версия драйвера CSI NFS #712.
  • Поддержка Kubernetes 1. 17.17 #4188 и 1.18.15 #4187.

Известные проблемы

  • Параллельное развертывание нескольких служб Kubernetes в одном кластере может привести к ошибке в конфигурации базовой подсистемы балансировки нагрузки. Рекомендуется развертывать одну службу одновременно.
  • Так как средство aks-engine — это общий репозиторий исходного кода в Azure и Azure Stack Hub, изучение множества заметок о выпуске и запросов на вытягивание может привести к тому, что средство поддерживает другие версии Kubernetes и платформы ОС за пределами перечисленных выше. Их можно игнорировать и использовать приведенную выше таблицу версий в качестве официального руководства по этому обновлению.

Справочные материалы

Ниже приведен полный набор заметок о выпуске для Azure и Azure Stack Hub в сочетании:

Применяется к версии 0.55.4 ядра AKS.

В этой статье описывается содержимое обновления обработчика Azure Kubernetes Service (AKS) в Azure Stack Hub. Это обновление содержит улучшения и исправления для последнего выпуска обработчика AKS, предназначенной для платформы Azure Stack Hub. Эта статья не предназначена для документирования сведений о выпуске подсистемы AKS для глобальной платформы Azure.

Планирование обновлений

Команда ядра upgrade AKS полностью автоматизирует процесс обновления кластера и обрабатывает виртуальные машины (виртуальные машины), сети, хранилище, Kubernetes и задачи оркестрации. Перед применением обновления обязательно просмотрите сведения о заметке о выпуске.

Моменты, которые следует учитывать при обновлении

  • Вы используете правильный элемент Marketplace, AKS Base Ubuntu 16.04-LTS Image Distro for your version of AKS engine? Версии можно найти в разделе "Скачивание нового образа и подсистемы AKS".
  • Вы используете правильную спецификацию кластера (apimodel.json) и группу ресурсов для целевого кластера? Этот файл был создан в выходном каталоге при первоначальном развертывании кластера. См. параметры команды развертывания Развертывания кластера Kubernetes.
  • Вы используете надежный компьютер для запуска ядра AKS и от которого выполняется обновление?
  • Если вы обновляете операционный кластер с активными рабочими нагрузками, вы можете применить обновление, не затрагивая их, если кластер находится под обычной нагрузкой. Однако в случае необходимости перенаправлять пользователей на него необходимо иметь кластер резервного копирования. Настоятельно рекомендуется использовать резервный кластер.
  • Если это возможно, выполняйте команду на виртуальной машине в среде Azure Stack Hub, чтобы снизить число сетевых прыжков и рисков сбоев подключения.
  • Убедитесь, что ваша подписка имеет достаточную квоту для завершения процесса. Этот процесс связан с выделением новых виртуальных машин. Результирующее количество виртуальных машин будет совпадать с исходным, но планируется создать несколько виртуальных машин во время процесса.
  • Не запланировано обновлений системы или других задач.
  • Настройте промежуточное обновление в кластере с теми же значениями параметров, что и у рабочего кластера, и проверьте в нем обновление перед тем, как запускать его в рабочем кластере.

Использование команды upgrade

Необходимо использовать aks-engine upgrade команду, как описано в разделе "Обновление кластера Kubernetes в Azure Stack Hub".

Прерывания обновления

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

Предполагаемое время обновления

Предполагаемое время обновления — 12–15 минут на виртуальную машину в кластере. Например, кластер с 20 узлами может занять около 5 часов для обновления.

Скачивание нового образа и обработчика AKS

Скачайте новые версии обработчика AKS и базового образа Ubuntu для AKS.

Как описано в документации по подсистеме AKS в Azure Stack Hub, развертывание кластера Kubernetes требует двух основных компонентов:

  • Двоичный файл aks-engine (обязательный).
  • дистрибутив базового образа AKS Ubuntu 16.04-LTS.

Новые версии этих образов доступны в этом обновлении:

Сопоставление обработчика AKS и версии Azure Stack

Версия Azure Stack Hub Версия обработчика AKS
1910 0.43.0, 0.43.1
2002 0.48.0, 0.51.0
2005 0.48.0, 0.51.0, 0.55.0, 0.55.4

Путь обновления версий Kubernetes в подсистеме AKS версии 0.55.4

Текущую версию и версию обновления для Azure Stack Hub можно найти в следующей таблице. Эта таблица относится к кластеру подсистемы AKS в Azure Stack Hub. Не используйте команду aks-engine get-versions , которая возвращает версии, поддерживаемые в глобальной среде Azure, а также в Azure Stack Hub.

Текущая версия Доступное обновление
1.15.10 1.15.12
1.15.12, 1.16.8, 1.16.9 1.16.14
1.16.8, 1.16.9, 1.16.14 1.17.11

В JSON-файле модели API укажите значения выпуска и версии в orchestratorProfile разделе. Например, если вы планируете развернуть Kubernetes 1.17.17, необходимо задать следующие два значения (см. пример kubernetes-azurestack.json):

    -   "orchestratorRelease": "1.16",
    -   "orchestratorVersion": "1.16.14"

Подсистема AKS и соответствующее сопоставление изображений

Версии Kubernetes Примечания.
1.15.5, 1.15.4, 1.14.8, 1.14.7
1.15.10, 1.14.7
1.15.12, 1.16.8, 1.16.9 Примеры модели API (Linux, Windows)
1.15.12, 1.16.14, 1.17.11 Примеры модели API (Linux, Windows)
1.15.12, 1.16.14, 1.17.11 Примеры модели API (Linux, Windows)

Новые возможности

  • Обновление виртуального жесткого диска Linux Azure Stack до версии 2020.09.14 #3828
  • Добавляет поддержку K8s версии 1.17.11 в Azure Stack #3702
  • Добавляет поддержку K8s версии 1.16.14 в Azure Stack #3704
  • Обновление виртуального жесткого диска Linux до версии 2020.09.14 #3750
  • Обновление виртуального жесткого диска Windows до августа 3730 г.
  • Обновление метрики Kubernetes до версии 0.3.7 #3669
  • Обновляет версию Docker, чтобы устранить проблему смены журнала #3693
  • Обновление CoreDNS до версии 1.7.0 #3608
  • Использование пакетов moby 19.03.x #3549
  • Исправления стратегии обновления Azure-cni #3571

Известные проблемы

  • Параллельное развертывание нескольких служб Kubernetes в одном кластере может привести к ошибке в конфигурации базовой подсистемы балансировки нагрузки. Рекомендуется развертывать одну службу одновременно.
  • При запуске aks-engine get-versionsвыходные данные создают сведения, применимые к Azure и Azure Stack Hub. Однако нет явного способа определить, что соответствует Azure Stack Hub. Не используйте эту команду, чтобы определить, какие версии доступны для обновления. Используйте справочную таблицу обновления, описанную в предыдущем разделе.
  • Так как средство aks-engine — это общий репозиторий исходного кода в Azure и Azure Stack Hub, изучение множества заметок о выпуске и запросов на вытягивание может привести к тому, что средство поддерживает другие версии Kubernetes и платформы ОС за пределами перечисленных выше. Их можно игнорировать и использовать приведенную выше таблицу версий в качестве официального руководства по этому обновлению.

Справочные материалы

Это полный набор заметок о выпуске для Azure и Azure Stack Hub.

Применяется к версии 0.48.0 или более ранней версии ядра AKS.

В этой статье описывается содержимое обновления обработчика Azure Kubernetes Service (AKS) в Azure Stack Hub. Это обновление содержит улучшения и исправления для последнего выпуска обработчика AKS, предназначенной для платформы Azure Stack Hub. Эта статья не предназначена для документирования сведений о выпуске подсистемы AKS для глобальной платформы Azure.

Планирование обновлений

Команда ядра upgrade AKS полностью автоматизирует процесс обновления кластера и обрабатывает виртуальные машины (виртуальные машины), сети, хранилище, Kubernetes и задачи оркестрации. Перед применением обновления обязательно просмотрите сведения о заметке о выпуске.

Моменты, которые следует учитывать при обновлении

  • Вы используете правильный элемент Marketplace, AKS Base Ubuntu 16.04-LTS Image Distro for your version of AKS engine? Версии см. в разделе Загрузка нового базового образа Ubuntu для AKS и версии обработчика AKS.
  • Вы используете правильную спецификацию кластера (apimodel.json) и группу ресурсов для целевого кластера? Этот файл был создан в выходном каталоге при первоначальном развертывании кластера. См. параметры команды развертывания Развертывания кластера Kubernetes.
  • Вы используете надежный компьютер для запуска обработчика AKS и от которого выполняется обновление?
  • Если вы обновляете операционный кластер с активными рабочими нагрузками, вы можете применить обновление, не затрагивая их, если кластер находится под обычной нагрузкой. Однако в случае необходимости перенаправлять пользователей на него необходимо иметь кластер резервного копирования. Настоятельно рекомендуется использовать резервный кластер.
  • Если это возможно, выполняйте команду на виртуальной машине в среде Azure Stack Hub, чтобы снизить число сетевых прыжков и рисков сбоев подключения.
  • Убедитесь, что ваша подписка имеет достаточную квоту для завершения процесса. Этот процесс связан с выделением новых виртуальных машин. Результирующее количество виртуальных машин будет совпадать с исходным, но планируется создать несколько виртуальных машин во время процесса.
  • Не запланировано обновлений системы или других задач.
  • Настройте промежуточное обновление в кластере с теми же значениями параметров, что и у рабочего кластера, и проверьте в нем обновление перед тем, как запускать его в рабочем кластере.

Использование команды upgrade

Необходимо использовать aks-engine upgrade команду, как описано в разделе "Обновление кластера Kubernetes в Azure Stack Hub".

Прерывания обновления

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

Предполагаемое время обновления

Предполагаемое время обновления — 12–15 минут на виртуальную машину в кластере. Например, кластер с 20 узлами может занять около 5 часов для обновления.

Скачивание нового образа и обработчика AKS

Скачайте новые версии обработчика AKS и базового образа Ubuntu для AKS.

Как описано в документации по подсистеме AKS в Azure Stack Hub, развертывание кластера Kubernetes требует двух основных компонентов:

  • Двоичный файл aks-engine (обязательный).
  • Дистрибутив образа AKS base Ubuntu 16.04-LTS.

Новые версии этих компонентов доступны в этом обновлении:

Путь обновления версии Kubernetes

Текущую версию и версию обновления для Azure Stack Hub можно найти в следующей таблице. Эта таблица относится к кластеру подсистемы AKS в Azure Stack Hub. Не используйте команду aks-engine get-versions , которая возвращает версии, поддерживаемые в глобальной среде Azure, а также в Azure Stack Hub.

Текущая версия Доступное обновление
1.14.7 1.15.10
1.14.8 1.15.10
1.15.4 1.15.10
1.15.5 1.15.10

Новые возможности

  • Поддержка Kubernetes версии 1.15.10 (#2834). При развертывании нового кластера в файле модели API .json файл (также известный как файл определения кластера), укажите номер версии выпуска и дополнительный номер версии в следующем формате. Пример файла определения кластера см. в kubernetes-azurestack.json.

    • "orchestratorRelease": "1.15,

    • "orchestratorVersion": "1.15.10"

    Примечание.

    Если версия Kubernetes не указана явным образом в файле модели API .json, будет использоваться версия 1.15 (#2932), а orchestratorVersion по умолчанию — 1.15.11, что приведет к ошибке во время развертывания кластера.

  • При использовании aks-engine версии 0.43.1 параметры частоты по умолчанию для поставщика облачных служб для выполнения цикла управления и других задач не работают хорошо с ограничениями пороговых значений Azure Stack Hub Resource Manager для входящих запросов. Это обновление изменяет значения по умолчанию для Azure Stack Hub, чтобы уменьшить нагрузку повторных попыток в Azure Stack Hub Resource Manager (#2861).

  • Новый шаг проверки в aks-engine приведет к остановке выполнения или отображению предупреждений, если файл модели API .json содержит свойства, не поддерживаемые Azure Stack Hub (#2717).

  • При новой проверке подлинности модуль aks-engine проверяет доступность базового образа AKS, необходимого для выполнения версии aks-engine (#2342). Это произойдет после анализа модели API .json файла и перед вызовом Azure Stack Hub Resource Manager.

  • Новый параметр aks-engine "--control-plane-only" в команде upgrade позволяет пользователю обновлять операции, предназначенные только для главных Виртуальные машины (No 2635).

  • Выполняется обновление ядра Linux до версии 4.15.0-1071-azure для Ubuntu 16.04-LTS. Дополнительные сведения см. в статье "Пакет: linux-image-4.15.0-1071-azure (4.15.0-1071.76) [безопасность]".

  • Добавлены новые обновления hyperkube для поддержки Kubernetes версий 1.14.8 и 1.15.10.

  • Обновите kubectl, чтобы соответствовать версии Kubernetes для кластера. Этот компонент доступен на узлах уровня управления кластером Kubernetes, вы можете запустить его с помощью SSH в мастер.

  • Обновления надстройки Azure Container Monitor с последним выпуском за февраль 2020 г. (#2850).

  • coredns Обновление до версии 1.6.6 (#2555).

  • Обновление etcd до версии 3.3.18 (#2462).

  • Обновление moby до версии 3.0.11 (#2887).

  • В этом выпуске ядро AKS сокращает зависимость от k8s.gcr.io текущего использования официального Kubernetes MCR registry @ mcr.microsoft.com при создании образов (No 2722).

Известные проблемы

  • Параллельное развертывание нескольких служб Kubernetes в одном кластере может привести к ошибке в конфигурации базовой подсистемы балансировки нагрузки. Рекомендуется развертывать одну службу одновременно.
  • Запуск aks-engine get-versions создает информацию, применимую к Azure и Azure Stack Hub. Однако нет явного способа определить, что соответствует Azure Stack Hub. Не используйте эту команду, чтобы определить, какие версии доступны для обновления. Используйте справочную таблицу обновления, описанную в предыдущем разделе.
  • Так как средство aks-engine — это общий репозиторий исходного кода в Azure и Azure Stack Hub, изучение множества заметок о выпуске и запросов на вытягивание может привести к тому, что средство поддерживает другие версии Kubernetes и платформы ОС за пределами перечисленных выше. Их можно игнорировать и использовать приведенную выше таблицу версий в качестве официального руководства по этому обновлению.

Справочные материалы

Ниже приведен список исправленных ошибок и полный набор заметок о выпуске версии 0.44.0 до версии 0.48.0. Заметки о выпуске включают Azure и Azure Stack Hub.

Исправления ошибок

  • userAssignedIdentityId в Windows azure.json отсутствующие кавычки (No 2327)

  • Надстройки update config доступны только для обновления (No 2282)

  • Превышение времени ожидания для получения IP-адреса управления на узлах Windows (No 2284)

  • Добавление файла 1.0.28 Azure CNI .zip в VHD Windows (#2268)

  • Правильный порядок по умолчанию для параметра IPAddressCount (#2358)

  • Обновление для использования единого yaml omsagent для всех версий K8s, чтобы избежать ошибок вручную и простоты обслуживания (No 2692)

Заметки о выпуске

Это полный набор заметок о выпуске для Azure и Azure Stack Hub.

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