Virtualization API

Компонент Virtualization API модуля virtualization управляет кастомными ресурсами следующих API-групп:

1. virtualization.deckhouse.io — основная группа, включает в себя следующие кастомные ресурсы:

   • VirtualMachine — ресурс, описывающий конфигурацию и статус виртуальной машины (ВМ);
   • VirtualMachineClass — ресурс, описывающий набор параметров для ресурсов VirtualMachine, таких как спецификации CPU и RAM, NodeSelector и Tolerations;
   • VirtualMachinePool — ресурс, декларативно управляющий группой одинаковых ВМ;
   • VirtualDisk — ресурс, описывающий желаемую конфигурацию диска ВМ;
   • VirtualImage — ресурс, описывающий:
     • образ диска ВМ, который может использоваться в качестве источника данных для новых ресурсов VirtualDisk;
     • установочный образ ISO, который может быть смонтирован в ресурс VirtualMachine напрямую.

   Полный список ресурсов основной API-группы приведён в документации модуля.

   Ресурсами основной группы управляет компонент virtualization-controller.

2. subresources.virtualization.deckhouse.io — группа субресурсов. Субресурсы — это дополнительные операции или действия, которые можно выполнять над основными ресурсами (например, VirtualMachine) через API Kubernetes. Они предоставляют интерфейсы для управления конкретными аспектами ресурсов, не затрагивая весь объект. Вместо привычного для Kubernetes декларативного ресурса они представляют собой эндпоинт для императивных операций.

   Группа включает в себя следующие субресурсы:

   • virtualmachines/console;
   • virtualmachines/vnc;
   • virtualmachines/portforward;
   • virtualmachines/addvolume;
   • virtualmachines/removevolume;
   • virtualmachines/freeze;
   • virtualmachines/unfreeze;
   • virtualmachines/addresourceclaim;
   • virtualmachines/removeresourceclaim.

   Субресурсами управляет компонент virtualization-api.

Компонент Virtualization API модуля для управления ВМ, дисками и образами ВМ использует в качестве бэкенда кастомные ресурсы KubeVirt.

Архитектура Virtualization API

Архитектура компонента Virtualization API модуля virtualization на уровне 2 модели C4 и его взаимодействия с другими компонентами Deckhouse Platform (DP) изображены на следующей диаграмме:

Компоненты Virtualization API

Virtualization API состоит из следующих компонентов:

1. Virtualization-api — Kubernetes Extension API Server, обслуживающий запросы к API-группе subresources.virtualization.deckhouse.io. В качестве бэкенда virtualization-api использует субресурсы из API-группы subresources.kubevirt.io. Virtualization-api обращается напрямую к эндпоинту компонента virt-api, который является Kubernetes Extension API Server и обслуживает запросы к аналогичным субресурсам из API-группы subresources.kubevirt.io. Состоит из контейнера virtualization-api.

2. Virtualization-controller — контроллер, выполняющий следующие операции:

   • Управляет кастомными ресурсами основной API-группы virtualization.deckhouse.io. Virtualization-controller не изменяет основную часть этих кастомных ресурсов: labels, annotations и spec. Virtualization-controller может вносить следующие изменения в кастомные ресурсы:

     • добавление и удаление finalizers в атрибуте metadata.finalizers;
     • добавление и удаление записей в атрибуте metadata.ownerReferences;
     • изменение субресурса status.

     В качестве бэкенда virtualization-controller использует кастомные ресурсы из API-группы kubevirt.io.

   • валидация ресурсов из API-группы virtualization.deckhouse.io с помощью механизма Validating Admission Controllers;
   • запуск подов dvcr-importer, dvcr-uploader, pvc-importer и др. для импорта и загрузки дисков и образов ВМ. Подробнее об импорте и загрузке образов и дисков ВМ описано в разделе «Импорт и загрузка образов и дисков ВМ»;
   • выполнение операций над ВМ посредством запросов к некоторым субресурсам API-группы subresources.virtualization.deckhouse.io, например virtualmachines/freeze и virtualmachines/unfreeze.

   Компонент содержит следующие контейнеры:

   • virtualization-controller — основной контейнер, реализующий контроллер и вебхук-сервер;
   • proxy (он же kube-api-rewriter) — сайдкар-контейнер, выполняющий модификацию проходящих через него запросов API, а именно переименование метаданных кастомных ресурсов. Это необходимо, поскольку компоненты KubeVirt используют API-группы вида *.kubevirt.io, а другие компоненты модуля virtualization используют аналогичные ресурсы, но с API-группой вида *.virtualization.deckhouse.io. Kube-api-rewriter является шлюзом, проксирующим запросы между контроллерами, управляющими ресурсами из разных API-групп, и Open Source-проектом;
   • kube-rbac-proxy — сайдкар-контейнер с авторизующим прокси на основе Kubernetes RBAC для организации защищённого доступа к метрикам контроллера и сайдкар-контейнера proxy. Является Open Source-проектом.

Взаимодействия компонента Virtualization API

Virtualization-api взаимодействует со следующими компонентами:

1. Kube-apiserver — читает список кастомных ресурсов VirtualMachine, которые нужны для обработки запросов к субресурсам.
2. Virt-api — отправляет запросы к субресурсам KubeVirt. Запросы проходят через аналогичный сайдкар-контейнер proxy, который переименовывает метаданные ресурсов из API-группы subresources.virtualization.deckhouse.io в метаданные API-группы subresources.kubevirt.io и проксирует их на эндпоинт virt-api (Kubernetes Extension API Server KubeVirt).

Virtualization-controller взаимодействует со следующими компонентами:

1. Kube-apiserver:

   • отправляет изменённые кастомные ресурсы модуля virtualization через сайдкар-контейнер proxy, который переименовывает метаданные из API-группы internal.virtualization.deckhouse.io в API-группу kubevirt.io;
   • выполняет авторизацию запросов на получение метрик.

С Virtualization API взаимодействуют следующие внешние компоненты:

1. Kube-apiserver:

   • пересылает запросы к субресурсам API-группы subresources.virtualization.deckhouse.io;
   • отправляет запросы на валидацию ресурсов API-группы virtualization.deckhouse.io.

2. Prometheus-main — собирает метрики компонентов.

Дополнительные ресурсы

• Документация модуля virtualization