Руководство по обновлению

Данное руководство описывает обновление платформы KeyStack, включая обновление кодовой базы LCM-узла, операционных систем узлов, компонентов региона.

Проверка платформы перед обновлением

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

Проверка работоспособности региона позволяет убедиться, что виртуальные машины создаются и доступны по сети, что подтверждает работоспособность цепочки сервисов (MariaDB, HAProxy, Cinder, Nova, Neutron, Glance).

  1. Подключитесь к интерфейсу OpenStack CLI.

  2. Проверьте сетевую доступность всех узлов облака с помощью команды ping.

  3. Выполните команду openstack compute service list для проверки состояния вычислительных сервисов. Убедитесь, что все сервисы находятся в состоянии up.

  4. Выполните команду openstack volume service list для проверки состояния службы томов. Убедитесь, что все сервисы находятся в состоянии up.

  5. Выполните команду openstack server list для проверки состояния виртуальных машин.

  6. Используя Портал администратора или OpenStack CLI, а при использовании Ubuntu — также портал самообслуживания Horizon, создайте несколько ВМ с различными флейворами и выполните их живую миграцию.

  7. Сверьте текущую конфигурацию региона (globals.d/*.yml и кастомные конфигурационные файлы сервисов) с эталонной конфигурацией версии, на которую выполняется обновление. Это позволяет заранее выявить отсутствующие или устаревшие параметры, которые могут привести к ошибкам после обновления.

Резервное копирование LCM перед обновлением

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

  1. Зайдите на LCM-узел по SSH.

  2. Проверьте наличие резервных копий по пути /installer/backup/.

При необходимости выполните резервное копирование LCM-узла:

  1. Зайдите в веб-интерфейс GitLab.

  2. Перейдите в репозиторий project_k / services / backup.

  3. Создайте и запустите новый пайплайн: Build > Pipelines > New pipeline.

  4. Оставьте ветку по умолчанию, соответствующую установленному релизу.

  5. Дождитесь выполнения пайплайна.

Установка пакетов обновления

Обновление LCM

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

Обновление LCM-узла осуществляется последовательно от более ранней версии к более новой. Ниже приведена инструкция по обновлению LCM-узла до версии 2026.2.1.

Установка LCM

После обновления LCM-узла необходимо установить новый LCM. Воспользуйтесь инструкцией по установке: Установка KeyStack LCM.

Миграция со старой версии LCM

Если у вас уже развёрнут LCM предыдущей версии, для перехода на новую версию LCM воспользуйтесь инструкцией по миграции:

Важно

Если регион обновляется вместе с миграцией на новый LCM, обновление региона (Обновление региона KeyStack ks2025.1.x → ks2026.2.1 вместе с ОС узлов) разделяется миграцией на две части:

  1. Перед миграцией на новый LCM — на старом LCM выполните разделы инструкции по обновлению региона с начала и до раздела Настройка GitLab (не включая его).

  2. После миграции на новый LCM — продолжите обновление региона с раздела Настройка GitLab и далее до конца инструкции.

Переключение региона на новый LCM

После миграции LCM на новую версию переключите каждый регион, обслуживаемый этим LCM, на новый LCM (k0s).

Резервное копирование региона перед обновлением

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

  1. Зайдите на LCM-узел по SSH.

  2. Проверьте наличие резервных копий по пути /installer/backup/.

При необходимости выполните резервное копирование данных региона, находящихся в базе данных MariaDB:

  1. Зайдите в веб-интерфейс GitLab.

  2. Перейдите в репозиторий вашего региона project_k / deployments / <имя региона>.

  3. Создайте и запустите новый пайплайн: Build > Pipelines > New pipeline.

  4. Оставьте ветку по умолчанию, соответствующую установленному релизу.

  5. Вручную запустите задачу backup-db на этапе deploy.

  6. Дождитесь выполнения пайплайна.

Для настройки расписания резервного копирования базы данных OpenStack обратитесь к разделу Резервное копирование базы данных OpenStack.

Примечание

Начиная с версии 2026.1 переменная BACKUP = true для планирования резервного копирования базы данных OpenStack заменена переменной SCHEDULE_TASK = backup-db. Если ранее было настроено расписание с переменной BACKUP = true, обновите его: замените переменную на SCHEDULE_TASK со значением backup-db.

Для настройки расписания резервного копирования LCM-узла обратитесь к разделу schedule-lcm-backup.

Обновление региона KeyStack

Обновление региона может выполняться независимо от обновления LCM-узла.

Обновление версии продукта KeyStack в регионе позволяет установить новую версию на всех узлах региона. Процесс выполняется последовательно: сначала по одному обновляются Control-узлы, а затем по одному или по несколько обновляются Compute-узлы. При этом на время обновления выполняется миграция нагрузки (виртуальных машин) с обновляемых Compute-узлов.

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

Примечание

При обновлении региона вместе с миграцией на новый LCM разделы инструкции с начала и до раздела Настройка GitLab (не включая его) должны быть выполнены на старом LCM ещё до миграции. На новом LCM обновление региона продолжается с раздела Настройка GitLab.

Автоматизированное обновление

Шаги по автоматизированному обновлению версий KeyStack и ОС на всем регионе, контроллерах и гипервизорах описаны в разделе:

Проверка работоспособности после обновления

  1. Проверьте версии контейнеров.

  2. Проверьте состояние Controller-узлов.

  3. Проверьте состояние сервисов командой OpenStack CLI: openstack compute service list.

  4. Проверьте состояние сетевых агентов командой OpenStack CLI: openstack network agent list.

  5. Проверьте состояние службы томов командой OpenStack CLI: openstack volume service list.

  6. Проверьте состояние виртуальных машин командой OpenStack CLI: openstack server list.

  7. Проверьте лог на наличие ошибок.

  8. Создайте несколько виртуальных машин с различными флейворами.

  9. Проведите живую миграцию виртуальных машин.