Обновление до версии 2.1 в Kubernetes

Обновление до версии 2.1 в Kubernetes#

Платформу Astra Automation версии 2.0-upd2, развернутую в кластере Kubernetes, можно обновить до версии 2.1 без повторного развертывания. Обновление выполняют операторы платформы. После установки операторов новой версии и обновления манифеста приложения они переводят все компоненты на образы новой версии.

В ходе обновления операторы выполняют следующие действия:

  • переводят компоненты платформы – Platform Gateway, Automation Controller, Private Automation Hub, Event-Driven Automation – на образы новой версии;

  • развертывают новый компонент Automation Dashboard;

  • импортируют в Private Automation Hub контент новой версии, то есть коллекции, образы среды исполнения (Execution Environment) и среды принятия решений (Decision Environment).

Инструкция описывает обновление из установочного пакета для кластера без доступа в интернет (файл aa-kubernetes-bundle-<version>-offline.tar.gz). Образы контейнеров новой версии доставляет на рабочие узлы кластера сценарий Ansible из состава пакета, поэтому отдельный реестр образов не требуется.

Процедура не зависит от дистрибутива Kubernetes. Необходимы только доступ к узлам кластера по SSH и среда выполнения контейнеров containerd. Отличия для отдельных дистрибутивов представлены в описании особенностей дистрибутивов.

Важно

Обновляйте только работоспособную платформу. Перед обновлением убедитесь, что платформа версии 2.0-upd2 находится в состоянии Successful и отвечает по API, как описано в инструкции по подготовке.

Порядок обновления#

Обновление состоит из следующих стадий:

  1. Подготовка к обновлению.

  2. Размещение образов.

  3. Обновление операторов.

  4. Обновление манифеста приложения.

  5. Контроль и проверка обновления.

  6. Очистка после обновления.

Предупреждение

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

Если после обновления платформа не функционирует нормально (см. проверки после обновления), выполните откат обновления. Перед началом работ ознакомьтесь со списком известных проблем.

Обновление кластера с доступом в интернет#

Если кластер имеет доступ к реестру registry.astra.ru, обновление упрощается с учетом следующих особенностей:

  • используйте облегченный установочный пакет aa-kubernetes-bundle-<version>.tar.gz;

  • пропустите стадию размещения образов, так как служба containerd загрузит образы новой версии из реестра автоматически;

  • примените манифесты операторов без изменений, как описано в стадии обновления операторов;

  • процедура развертывания загружает образы через интернет без использования блоков offline_content_loader, ee_images и decision_environments в манифесте, однако если эти блоки были использованы при первоначальном развертывании платформы, то обновите их, как описано в стадии обновления манифеста.

Ожидаемые результаты, которые зависят от способа доставки контента Private Automation Hub, отмечены отдельно в стадиях контроля и проверки и очистки.