Заметки о выпуске обработчика 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 или 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 требуется один из следующих образов):
    • AKS Base Windows Server Image Containerd.
    • Docker базового образа Windows Server AKS.

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

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

Начиная с aks Engine версии 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 Engine версии 0.75.3 дистрибутив Ubuntu 18.04 больше не поддерживается, так как срок службы ОС истек. Для обработчика AKS версии 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 автоматически перезаписывает неподдерживаемое dockercontainerRuntime значение на 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*

Примечание

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

Обработчик AKS и соответствующее сопоставление изображений

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

Обработчик AKS Базовый образ AKS Версии Kubernetes Примеры моделей API
Версия 0.43.1 Дистрибутив образа AKS Base Ubuntu 16.04-LTS за октябрь 2019 г. (24.10.2019) 1.15.5, 1.15.4, 1.14.8, 1.14.7
Версия 0.48.0 Дистрибутив образа AKS Base 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, 2021 Q1 (2021.01.28),
Образ AKS Base Windows (17763.1697.210129)
1.16.14, 1.16.15, 1.17.17, 1.18.15 Linux, Windows
Версия 0.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)
Версия 0.67.0 Дистрибутив образа AKS Base Ubuntu 18.04-LTS, 3-й квартал 2021 г. (2021.09.27),базовый образ Windows AKS (17763.2213.210927) 1.19.15, 1.20.11 Примеры моделей API (Linux, Windows)
Версия 0.67.3 Дистрибутив образа AKS Base Ubuntu 18.04-LTS, 3-й квартал 2021 г. (2021.09.27),базовый образ Windows AKS (17763.2213.210927) 1.19.15, 1.20.11 Примеры моделей API (Linux, Windows)
Версия 0.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)
Версия 0.71.0 Дистрибутив образа AKS Base Ubuntu 18.04-LTS, 3-й квартал 2022 г. (2022.08.12),базовый образ Windows AKS (17763.3232.220805) 1.22.7*, 1.23.6* Примеры моделей API (Linux, Windows)
Версия 0.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)
версия 0.75.3 Дистрибутив образа AKS Base Ubuntu 20.04-LTS (2023.032.2), Docker образа AKS Base Windows Server 2019 (17763.3887.20230332), контейнер образа AKS Base Windows Server 2019 (17763.3887.20230332) 1.23.15*, 1.24.9** Примеры моделей API (Linux, Windows)
Версия 0.76.0 Дистрибутив образа AKS Base Ubuntu 20.04-LTS (2023.116.3),образ AKS Base Windows Server 2019 Containerd (17763.4252.20231163) 1.24.11**, 1.25.7** Примеры моделей API (Linux, Windows)
версия 0.77.0 Дистрибутив образа AKS Base Ubuntu 20.04-LTS (2023.206.1), образ AKS Base Windows Server 2019 Containerd (17763.4645.20232061) 1.25.7**, 1.26.6** Примеры моделей API (Linux, Windows)
версия 0.78.0 Дистрибутив образа AKS Base Ubuntu 20.04-LTS (2023.242.3),образ AKS Base Windows Server 2019 Containerd (17763.4737.20232423) 1.25.13**, 1.26.8** Примеры моделей API (Linux, Windows)
версия 0.79.0 Дистрибутив образа AKS Base Ubuntu 20.04-LTS (2023.296.1) и образ AKS Base Windows Server 2019 Containerd (17763.4974.20232961) 1.26.9**, 1.27.6** Примеры моделей API (Linux, Windows)
Версия 0.80.2 Дистрибутив образа AKS Base Ubuntu 20.04-LTS (2024.032.1),образ AKS Base Windows Server 2019 Containerd (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

Новые возможности 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 в качестве базового образа Linux предлагается Ubuntu 20.04 LTS. Начиная с этого выпуска 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 — это основной компонент, совместно используемый azure AKS и обработчиком AKS в Azure Stack Hub.

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

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

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

Ссылка

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

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

В этой статье описывается содержимое обновления обработчика 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 или 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

Скачайте новые версии базового образа AKS Ubuntu и обработчика 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 Engine версии 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 Base Ubuntu 16.04-LTS за октябрь 2019 г. (24.10.2019) 1.15.5, 1.15.4, 1.14.8, 1.14.7
Версия 0.48.0 Дистрибутив образа AKS Base 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, 2021 Q1 (2021.01.28),
Образ AKS Base Windows (17763.1697.210129)
1.16.14, 1.16.15, 1.17.17, 1.18.15 Linux, Windows
Версия 0.63.0 Дистрибутив образа AKS Base Ubuntu 18.04-LTS, 2021 квартал 2021 г. (2021.05.24),базовый образ Windows AKS (17763.1935.210520) 1.18.18, 1.19.10, 1.20.6 Примеры моделей API (Linux, Windows)
Версия 0.67.0 Дистрибутив образа AKS Base Ubuntu 18.04-LTS, 2021 квартал 2021 г. (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.

Применяется к обработчику AKS версии 0.60.1.

В этой статье описывается содержимое обновления обработчика 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 или 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 Base Ubuntu 16.04-LTS за октябрь 2019 г. (24.10.2019) 1.15.5, 1.15.4, 1.14.8, 1.14.7
Версия 0.48.0 Дистрибутив образа AKS Base 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, 2021 Q1 (2021.01.28),
Образ AKS Base Windows (17763.1697.210129)
1.16.14, 1.16.15, 1.17.17, 1.18.15 Linux, Windows

Новое

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

Новые функции:

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

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

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

Ссылка

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

Применяется к обработчику AKS версии 0.55.4.

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

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

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

Вопросы обновления

  • Вы используете правильный элемент Marketplace— дистрибутив образа AKS Base Ubuntu 16.04-LTS для вашей версии обработчика 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 требуется два main компонента:

  • Двоичный файл 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 для устранения проблемы с сменой журнала No 3693
  • Обновление CoreDNS до версии 1.7.0 #3608
  • Использование пакетов moby 19.03.x #3549
  • Исправления стратегии обновления azure-cni No 3571

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

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

Справочник

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

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

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

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

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

Вопросы обновления

  • Вы используете правильный элемент Marketplace— дистрибутив образа AKS Base Ubuntu 16.04-LTS для вашей версии обработчика AKS? Версии см. в разделе Загрузка нового базового образа 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 требуется два main компонента:

  • Двоичный файл 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 (No 2834). При развертывании нового кластера в модели API .json файле (также известном как файл определения кластера) укажите как номер версии выпуска, так и дополнительный номер версии в следующем формате. Пример файла определения кластера см. в разделе kubernetes-azurestack.json.

    • "orchestratorRelease": "1.15,

    • "orchestratorVersion": "1.15.10"

    Примечание

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

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

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

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

  • Новый параметр aks-engine "--control-plane-only" в команде upgrade позволяет пользователю обновлять операции только для master Виртуальные машины (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 в master.

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

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

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

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

  • В этом выпуске aks engine сокращает зависимость, 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).

  • Добавление файла .zip Azure CNI версии 1.0.28 в виртуальный жесткий диск Windows (No 2268).

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

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

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

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

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