Руководство по установке

Данное руководство описывает установку облачной платформы KeyStack на физической инфраструктуре заказчика.

Целевая аудитория

Системные администраторы, которые разворачивают и настраивают KeyStack на целевой инфраструктуре.

К системным администраторам предъявляются требования:

  • Навыки системного администрирования Linux.

  • Навыки организации и настройки сетевой связности между узлами.

  • Понимание принципа работы сервисов OpenStack.

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

Варианты поставки

Доступные варианты поставки исходного дистрибутива продукта KeyStack:

  • через интернет по ссылке от вендора, которую можно получить у менеджера вашего аккаунта;

  • в отдельном архиве (если инфраструктура развернута в закрытом контуре).

Состав дистрибутива

Установочный файл включает в себя:

  • архив docker-образов компонентов LCM, включая Nexus, Vault, GitLab, NetBox, Nginx;

  • необходимые системные пакеты (deb/rpm), для развертывания LCM без доступа к интернет;

  • образ операционной системы (qcow2) для автоматизированной установки на baremetal-узлы;

  • скрипты инсталляции и развертывания LCM.

Зависимости и лицензии

Требования к инфраструктуре

Продукт должен разворачиваться на нескольких физических узлах (серверах). Для управления облачной инфраструктурой используются узлы нескольких типов:

  • LCM (seed node) — главный узел управления сервисной инфраструктурой Продукта. На нем хранится кодовая база основных компонентов и базовая конфигурация узлов остальных типов. С этого узла начинается развертывание Продукта и управление его жизненным циклом.

  • Controller — узел с управляющими модулями вычислительных ресурсов, сетевых агентов и вспомогательными службами. В некоторых случаях может совмещать роль узла Network.

  • Compute — узел с гипервизором KVM, управляет виртуальными машинами (ВМ) основной инфраструктуры. Для обеспечения сетевой связности ВМ используется агент сетевой службы.

  • Storage — узел с дисками блочных хранилищ. Блочные хранилища используются для организации индивидуального и/или совместного дискового пространства для ВМ.

  • Network — узел с компонентами программно-определяемых сетей.

Ознакомьтесь с аппаратными и программными требованиями к узлам:

Подготовка серверной инфраструктуры

Перед установкой KeyStack подготовьте серверную инфраструктуру:

Установка и настройка LCM-узла

KeyStack LCM (Lifecycle Manager) обеспечивает жизненный цикл облака. Он также используется в качестве seed node — с него происходит установка и настройка всех остальных узлов в составе облака. Установите дистрибутив KeyStack на LCM-узел:

Если на этапах установки LCM возникают ошибки запуска подов, обратитесь к разделу Диагностика и устранение неполадок LCM Руководства администратора.

Развёртывание базовой инфраструктуры на baremetal-узлах

Подготовьте baremetal-серверы и выполните установку ОС и базовую конфигурацию.

Создание региона

Создайте один или несколько регионов, для каждого региона разверните сетевое окружение:

Обратитесь к соответствующим разделам Руководства администратора для создания флейворов, шаблонов, образов и типов томов:

Использование CLI

Для управления KeyStack через командную строку используйте KOC. Если необходимая операция не поддерживается KOC, используйте OpenStack CLI.

Настройка механизма фильтрации трафика

После развёртывания региона настройте правила фильтрации трафика для обеспечения безопасности сетевого взаимодействия:

Подключение и настройка СХД

Платформа KeyStack поддерживает подключение дополнительных систем хранения данных следующих типов:

  • iSCSI,

  • Fibre Channel,

  • NFS.

Выполните подключение и настройку СХД:

Настройка бэкенда Neutron

На данный момент для Neutron доступен только бэкенд OVS. Для его настройки используйте инструкцию:

Настройка Портала администратора для нескольких регионов

Портал администратора устанавливается и включается по умолчанию при стандартном развёртывании региона (переменная enable_adminui: "yes" в файле globals.d/REGION.yml) и не требует дополнительной настройки. Если необходимо использовать Портал администратора для управления несколькими регионами, обратитесь к инструкции:

Порядок подключения к Порталу администратора описан в разделе Подключение к Порталу администратора Руководства администратора.

Настройка развёртывания KeyVRM

В конфигурации региона KeyVRM включён по умолчанию. Убедитесь, что сервис развёрнут и подключён к Порталу администратора, затем выполните первичную настройку:

Подключение мониторинга и аудита

Мониторинг региона включает сбор метрик, оповещения и анализ журналов. Аудит CADF фиксирует события в сервисах региона и использует тот же сборщик журналов и хранилище OpenSearch.

Включите компоненты мониторинга и аудит региона по единой инструкции:

После развёртывания используйте статью Журналы и аудит региона для настройки хранения журналов, уведомлений Keystone и отправки событий во внешние системы.

Аудит LCM и отправка журналов его компонентов настраиваются отдельно. См. статью Отправка событий аудита во внешние системы.

Включение ролевой модели в KeyStack

Для подключения ролевой модели на существующем LCM после обновления до версии 2026.2.1 или при установке версии 2026.2.1 без ролевой модели воспользуйтесь инструкцией:

Описание ролей KeyStack и их прав доступа приведено в разделе Ролевая модель KeyStack.

Проверка работоспособности системы

Для проверки работоспособности региона KeyStack выполните следующие шаги: