Руководство по установке¶
Данное руководство описывает установку облачной платформы KeyStack на физической инфраструктуре заказчика.
Целевая аудитория¶
Системные администраторы, которые разворачивают и настраивают KeyStack на целевой инфраструктуре.
К системным администраторам предъявляются требования:
Варианты поставки¶
Доступные варианты поставки исходного дистрибутива продукта KeyStack:
через интернет по ссылке от вендора, которую можно получить у менеджера вашего аккаунта;
в отдельном архиве (если инфраструктура развернута в закрытом контуре).
Состав дистрибутива¶
Установочный файл включает в себя:
Зависимости и лицензии¶
Требования к инфраструктуре¶
Продукт должен разворачиваться на нескольких физических узлах (серверах). Для управления облачной инфраструктурой используются узлы нескольких типов:
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 поддерживает подключение дополнительных систем хранения данных следующих типов:
Fibre Channel,
NFS.
Выполните подключение и настройку СХД:
Настройка бэкенда Neutron¶
На данный момент для Neutron доступен только бэкенд OVS. Для его настройки используйте инструкцию:
Настройка Портала администратора для нескольких регионов¶
Портал администратора устанавливается и включается по умолчанию при стандартном развёртывании региона (переменная enable_adminui: "yes" в файле globals.d/REGION.yml) и не требует дополнительной настройки. Если необходимо использовать Портал администратора для управления несколькими регионами, обратитесь к инструкции:
Порядок подключения к Порталу администратора описан в разделе Подключение к Порталу администратора Руководства администратора.
Настройка развёртывания KeyVRM¶
В конфигурации региона KeyVRM включён по умолчанию. Убедитесь, что сервис развёрнут и подключён к Порталу администратора, затем выполните первичную настройку:
Подключение сервисов мониторинга и аудита¶
Мониторинг в KeyStack реализован на основе сервисов OpenSearch, Cloud Auditing Data Federation, VictoriaMetrics и Grafana. Если ролевая модель выключена или сервисы настроены без интеграции с Порталом администратора, вы можете получить доступ к веб-интерфейсам этих сервисов по следующим ссылкам:
OpenSearch —
https://cloud.itkey.com:5601/;VictoriaMetrics —
https://cloud.itkey.com:8481/select/0/vmui;Alertmanager —
https://cloud.itkey.com:9093/;Grafana —
https://cloud.itkey.com:3000/.
При включенной ролевой модели доступ к OpenSearch и Grafana предоставляется через Портал администратора без повторной аутентификации. Пользователь с ролью admin получает административный доступ к OpenSearch и права Grafana Editor. Пользователи с ролями security_auditor и reader получают доступ только на чтение. Пользователи с ролями member, operator_vm, app_operator и os_operator не получают доступ к OpenSearch и Grafana.
По умолчанию все перечисленные компоненты разворачиваются для каждого региона. Если этого не произошло или требуется дополнительная настройка, обратитесь к разделу:
Для настройки сервиса аудита обратитесь к разделу:
Для проведения миграции данных из Prometheus в VictoriaMetrics обратитесь к разделу:
Для настройки аудита LCM и отправки журналов его компонентов во внешние системы обратитесь к разделу:
Включение ролевой модели в KeyStack¶
Для подключения ролевой модели на существующем LCM после обновления до версии 2026.2.1 или при установке версии 2026.2.1 без ролевой модели воспользуйтесь инструкцией:
Описание ролей KeyStack и их прав доступа приведено в разделе Ролевая модель KeyStack.
Проверка работоспособности системы¶
Для проверки работоспособности региона KeyStack выполните следующие шаги: