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

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

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

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

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

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

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

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

Вам потребуется использовать команду обновления обработчика AKS, как описано в следующей статье об обновлении кластера Kubernetes в Azure Stack Hub.

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

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

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

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

Инструкции по использованию обработчика AKS 0.70.0

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

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

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

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

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

Скачивание нового образа и обработчика 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 AKS (требуется для агентов Windows)

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

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

Обновление кластеров 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, 0.67.3, 0.70.0

Путь обновления версии Kubernetes в обработчике AKS версии 0.70.0

Текущую версию и версию обновления можно найти в следующей таблице для Azure Stack Hub. Не выполняйте команду aks-engine get-versions, так как она также включает версии, поддерживаемые глобальной платформой Azure. К кластеру обработчика AKS в 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 1.21.11
1.21.10 1.22.7

В файле 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 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 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 Ubuntu 16.04-LTS, сентябрь 2020 г. (2020.09.14), базовый образ Windows AKS (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
V0.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 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 Ubuntu 18.04-LTS, 2021 Q3 (2021.09.27),базовый образ Windows AKS (17763.2213.210927) 1.19.15, 1.20.11 Примеры модели API (Linux, Windows)
Версия 0.67.3 Дистрибутив базового образа AKS Ubuntu 18.04-LTS, 2021 Q3 (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 г. (07.04.2022)
Образ AKS Base Windows (17763.2565.220408)
1.21.10, 1.22.7 Примеры модели API (Linux, Windows)

Новое

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

  • Добавлена поддержка Kubernetes версии 1.21.10 (No 4840)
  • Добавлена поддержка Kubernetes версии 1.22.7 (No 4838)
  • Дополнительные функции можно найти в версии 0.70.0.

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

  • Параллельное развертывание нескольких служб 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.

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

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

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

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

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

Вам потребуется использовать команду обновления обработчика AKS, как описано в следующей статье об обновлении кластера Kubernetes в Azure Stack Hub.

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

Иногда обновление кластера может прерываться из-за непредвиденных факторов. Прерывание может произойти, когда обработчик AKS сообщает об ошибке или что-то происходит с процессом его выполнения. Изучите причину прерывания, устраните ее и отправьте еще раз ту же команду обновления, чтобы продолжить процесс его выполнения. Команда 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 AKS (требуется для агентов Windows)

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

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

Обновление кластеров 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-engine get-versions, так как она также включает версии, поддерживаемые глобальной платформой Azure. К кластеру обработчика AKS в 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 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 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 Ubuntu 16.04-LTS, сентябрь 2020 г. (2020.09.14), базовый образ Windows AKS (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
V0.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 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 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.

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

Команда обновления обработчика 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, как описано в следующей статье об обновлении кластера Kubernetes в Azure Stack Hub.

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

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

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

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

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

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

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

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

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

Сопоставление обработчика 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-engine get-versions, так как она также включает версии, поддерживаемые глобальной платформой Azure. К кластеру обработчика AKS в 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), базовый образ AKS Windows (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
V0.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 No 4259
  • закрытая предварительная версия интеграции Azure Active Directory
  • CSI Driver for Azure Blobs Private Preview #712
  • Общедоступная предварительная версия дисков Azure драйвера CSI No 712
  • Общедоступная предварительная версия драйвера CSI NFS No 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.

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

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

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

  • Верен ли элемент marketplace (дистрибутив базового образа AKS Ubuntu 16,04-LTS), используемый для вашей версии обработчика AKS? Версии можно найти в разделе "Скачивание нового образа и обработчика AKS".

  • Используете ли вы правильную спецификацию кластера (apimodel.json) и группу ресурсов для целевого кластера? Этот файл был создан в выходном каталоге при первоначальном развертывании кластера. Параметры команды deploy см. в разделе Развертывание кластера Kubernetes.

  • Вы используете надежный компьютер для запуска обработчика AKS и с которого выполняется обновление?

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

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

  • Убедитесь, что ваша подписка имеет достаточную квоту для завершения процесса. Этот процесс связан с выделением новых виртуальных машин. Результирующее число виртуальных машин будет таким же, как изначально, однако следует запланировать создание нескольких дополнительных виртуальных машин в ходе этого процесса.

  • Не запланировано обновлений системы или других задач.

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

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

Вам потребуется использовать команду upgrade обработчика AKS, как описано в статье Обновление кластера Kubernetes в Azure Stack Hub.

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

Иногда обновление кластера может прерываться из-за непредвиденных факторов. Прерывание может произойти, когда обработчик AKS сообщает об ошибке или что-то происходит с процессом его выполнения. Изучите причину прерывания, устраните ее и отправьте еще раз ту же команду обновления, чтобы продолжить процесс его выполнения. Команда 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-engine get-versions, так как она также включает версии, поддерживаемые глобальной платформой Azure. К кластеру обработчика AKS в 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.16.14, необходимо задать следующие два значения (см. пример 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.

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

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

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

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

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

  • Верен ли элемент marketplace (дистрибутив базового образа AKS Ubuntu 16,04-LTS), используемый для вашей версии обработчика AKS? Версии см. в разделе Загрузка нового базового образа Ubuntu для AKS и версии обработчика AKS.

  • Верна ли спецификация кластера (apimodel.json) и группа ресурсов для целевого кластера? Этот файл был создан в выходном каталоге при первоначальном развертывании кластера. Параметры команды "deploy" см. в разделе Развертывание кластера Kubernetes.

  • Вы используете надежный компьютер для запуска обработчика AKS и с которого выполняется обновление?

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

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

  • Убедитесь, что ваша подписка имеет достаточную квоту для завершения процесса. Этот процесс связан с выделением новых виртуальных машин. Результирующее число виртуальных машин будет таким же, как изначально, однако следует запланировать создание нескольких дополнительных виртуальных машин в ходе этого процесса.

  • Не запланировано обновлений системы или других задач.

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

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

Вам потребуется использовать команду "upgrade" обработчика AKS, как описано в следующей статье: Обновление кластера Kubernetes в Azure Stack Hub.

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

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

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

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

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

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

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

  • двоичный файл aks-engine;
  • дистрибутив базового образа AKS Ubuntu 16.04-LTS.

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

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

Текущую версию и версию обновления можно найти в следующей таблице для Azure Stack Hub. Не выполняйте команду get-versions для aks-engine, так как она также включает версии, поддерживаемые глобальной платформой Azure. К кластеру обработчика AKS в 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). При развертывании нового кластера обязательно укажите в json-файле модели API (файл определения кластера k.s. ) номер версии выпуска, а также дополнительный номер версии. Пример см. здесь 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 приведет к остановке выполнения или отображению предупреждений, если json-файл модели API содержит свойства, не поддерживаемые Azure Stack Hub (No 2717).

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

  • Новый параметр 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 г. (No 2850).

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

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

  • Обновление moby до версии 3.0.11 (No 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 в окнах azure.json отсутствуют кавычки (No 2327)

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

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

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

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

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

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

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

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