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

Данное руководство описывает обновление платформы 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, портал самообслуживания Horizon или Портал администратора, создайте несколько ВМ с различными флейворами и выполните их live-миграцию.

Получение и подготовка пакета обновления

Пакет обновления KeyStack можно загрузить как вручную, так и автоматически, указав ссылку на файл.

  1. Откройте веб-интерфейс развернутого GitLab.

  2. Откройте проект project_k / services / upgrade.

  3. Создайте новый пайплайн: Build > Pipelines > Run Pipeline.

  4. В открывшемся окне укажите значение параметра UPGRADE_URL — URL архива с обновлением.

  5. Запустите задачу update.

  6. Дождитесь завершения выполнения операции.

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

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

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

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

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

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

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

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

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

Обновление LCM

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

Обновление LCM-узла осуществляется последовательно от более ранней версии к более новой. Если необходимо обновить узел на две и более версии, нужно пройти по цепочке обновлений в несколько этапов. Ниже приведены инструкции для каждого такого этапа, начиная с перехода с версии ks2024.1 на ks2024.2.

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

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

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

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

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

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

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

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

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

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

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

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

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

Обновление региона KeyStack может выполняться как с обновлением версий операционных систем узлов, так и без него. Обратитесь к соответствующим инструкциям для обновления региона с версии 2024.3+ до версии 2025.1.1:

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

  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. Проведите live-миграцию виртуальных машин.