oVirt и подобные провайдеры
Конфигурация провайдеров на базе oVirt API.
Назначение
Инфраструктурный провайдер Cluster API на базе oVirt API позволяет создавать узлы Kubernetes-кластеров как виртуальные машины в oVirt и совместимых продуктах (zVirt, HostVM и др.). Конфигурация подключения и объектов виртуализации задаётся в экземпляре провайдера в интерфейсе «Штурвал».
Для настройки провайдера необходимо, чтобы соответствующий сервис в кластере управления был включён и находился в режиме управления Авто. Подробности по назначению и параметрам сервиса — на странице Провайдер oVirt (shturval-capov).
Сводная таблица инфраструктурных CR oVirt (OVirt*) в терминах Cluster API: раздел Кастомные ресурсы жизненного цикла узлов — oVirt.
- oVirt
- zVirt
- HostVM
- РЕД Виртуализация
- ROSA Virtualization
Настройки конфигурации для всех oVirt-подобных провайдеров идентичны.
Соответствие полей в платформах виртуализации
Поля в форме конфигурации провайдера соответствуют сущностям платформы виртуализации. Где искать:
| Поле в платформе «Штурвал» | oVirt | zVirt | HostVM | РЕД Виртуализация | ROSA Virtualization |
|---|---|---|---|---|---|
| URL Engine | https://<host>/ovirt-engine/api. Админ-портал oVirt |
Аналогично oVirt. Админ-портал zVirt | Аналогично oVirt. Админ-портал HostVM | https://<host>/ovirt-engine/api. Админ-портал РЕД Виртуализации |
Консоль OpenShift, API виртуализации |
| Datacenter | Центр обработки данных (Data Center). Дерево: Центр обработки данных | Центр обработки данных | Центр обработки данных | Центр обработки данных (Data Center). Админ-портал | Логический центр данных (при использовании OpenShift Virtualization) |
| Кластер (Clusters) | Кластер внутри центра обработки данных | Кластер | Кластер | Кластер (Cluster). Админ-портал → Центр обработки данных → Кластеры | Кластер виртуализации |
| Профиль VNIC | Сеть → Профиль vNIC (формат сеть/профиль, например ovirtmgmt/ovirtmgmt) |
Сеть → Профиль vNIC | Сеть → Профиль vNIC | Сеть → Профиль vNIC (vNIC Profile) | Профиль сетевого интерфейса |
Подготовка в платформе виртуализации
Убедитесь, что выполняются требования ниже (они же должны быть соблюдены до добавления экземпляра провайдера в «Штурвал»).
Версия API. На стороне виртуализации для oVirt используйте oVirt Engine API не ниже 4.4 (в том числе для zVirt 4.4).
Учётная запись и сервисная роль. Нужна созданная учётная запись и сервисная роль с разрешениями на:
- вход в систему;
- управление сетевыми устройствами;
- провиженинг шаблонов;
- все действия по перезагрузке, созданию, провиженингу и миграции виртуальных машин;
- все действия по созданию дисков.
Объекты в виртуализации. Должны быть подготовлены виртуальный датацентр (Datacenter) и кластер(ы) внутри него, а также сеть с профилем vNIC (для выбора в форме провайдера). В сети должен работать DHCP.
Шаблоны ВМ. Для добавления шаблонов в экземпляр провайдера нужны уже созданные шаблоны виртуальных машин в виртуализации. Их подготовка для платформы описана в общей инструкции: Шаблон виртуальной машины для узлов кластера.
В шаблоне ВМ должен быть диск с включённым флагом Bootable. Проверьте и включите флаг в свойствах диска до добавления шаблона в платформу, чтобы ВМ могла использовать этот диск для запуска операционной системы.
Если вы впервые работаете с провайдерами инфраструктуры в «Штурвале», имеет смысл прочитать обзор Как устроена работа с провайдерами в платформе.
Создание экземпляра
Перейдите в Провайдеры → Конфигурация провайдеров. В блоке Сервисы провайдеров проверьте, включён ли Провайдер oVirt, zVirt, HostVM, РЕД Виртуализация, ROSA Virtualization. Если сервис отключён, нажмите на переключатель и дождитесь запуска. Затем нажмите Добавить экземпляр провайдера → выберите нужный тип («+ oVirt», «+ zVirt», «+ HostVM», «+ РЕД Виртуализация», «+ ROSA Virtualization»).
Переключатель сервиса переводит связанные SSC провайдера в режим auto: сначала CRD-чарт, затем основной чарт провайдера. Дождитесь, пока сервис перейдёт в состояние готовности.
Иллюстрация: Создание экземпляра
Форма конфигурации провайдера oVirt
Поля конфигурации
| Поле | Обязательность | Описание |
|---|---|---|
| Название экземпляра | Да | Уникальное имя для идентификации экземпляра в платформе. |
| URL Engine | Да | Полный адрес API Engine провайдера. Формат: https://ovirt.company.domain/ovirt-engine/api. URL должен заканчиваться на /api. |
| Имя пользователя | Да | Учётная запись с указанием домена (например, admin@internal). |
| Пароль | Да | Пароль учётной записи для подключения к Engine. |
| Проверка сертификата | Нет | При корпоративном или самоподписном CA рекомендуется настроить доверие к сертификату на стороне инфраструктуры либо выполнить проверку цепочки доверия; при необходимости проверку TLS в форме можно отключить. |
| Datacenter | Да | Виртуальный датацентр oVirt. Выберите из списка после успешной проверки подключения. |
| Кластер (Clusters) | Да | Кластер oVirt, в котором будут создаваться ВМ. |
| Профиль VNIC | Да | Сетевой профиль (например, ovirtmgmt/ovirtmgmt). Определяет сеть для сетевых интерфейсов ВМ. В сети должен работать DHCP. |
| Разрешить CSI | Нет | Если включено, при создании кластера с этим экземпляром провайдера можно будет включить интеграцию oVirt CSI для Persistent Volumes. |
| Storage domain | Нет | Имя домена хранения (Storage Domain) в oVirt, где будут создаваться диски виртуальных машин. Потребуется включить [featureGates.disk-clone] в Провайдере oVirt (shturval-capov) (/ru2/cluster-admin/services/platform-services/cluster-services/shturval-capov/#перемещение-диска-в-storage-domain) |
| CSIStorageDomainName | Да | Имя домена хранения (Storage Domain) для CSI |
| Пул IP-адресов | Нет | Привязка пула позволяет при конфигурировании кластера назначить адрес API-серверу и VIP Ingress из свободных адресов выбранного пула. Добавление и настройка пулов в платформе — на странице Пулы IP-адресов. |
После ввода учётных данных нажмите Проверить подключение.
- Если проверка успешна, станут доступны выпадающие списки (Datacenter, Clusters, Профиль VNIC).
- Если проверка не прошла, проверьте URL Engine, учётные данные и параметры TLS и повторите попытку подключения.
Шаблоны ВМ
Добавьте шаблоны ВМ для нужных версий Kubernetes. Для одной версии — один шаблон. Шаблоны готовятся единым способом для всех провайдеров.
В блоке Шаблоны виртуальных машин нажмите + для добавления шаблона. В боковом окне выберите имя (как в виртуализации) и версию Kubernetes. Версия Штурвала заполнится автоматически и будет доступна только для просмотра.
Чтобы обновить версию Kubernetes на узлах кластера после развёртывания, следуйте инструкции Узлы и шаблоны ВМ.
Добавление шаблона ВМ
Устранение неполадок
В случае поднятия на RHV шаблона ВМ с ОС Astra Linux 1.8 с ядром 6.6 загрузка ВМ может останавливаться в случайном месте. Это происходит из‑за проблем с драйвером qxl. Для решения необходимо в шаблоне ВМ изменить тип видеокарты (консоли) на VGA (именно после создания шаблона, из ВМ в шаблон эта настройка не переходит).
Скриншот настройки VGA
