Доступно в редакциях:  Ultimate/EE, SE+

Входит в расширения: Интеграция с провайдерами для частной инфраструктуры

Стадия жизненного цикла модуля: General Availability

Модуль cloud-provider-vsphere обеспечивает интеграцию Deckhouse Platform с VMware vSphere. Он предоставляет возможность модулю node-manager использовать ресурсы vSphere при заказе узлов для NodeGroup.

Функции модуля cloud-provider-vsphere:

  • Управление ресурсами vSphere через cloud-controller-manager:
    • создаёт сетевые маршруты для сети PodNetwork на стороне vSphere;
    • актуализирует метаданные виртуальных машин и узлов Kubernetes и удаляет из Kubernetes узлы, которых больше нет в vSphere.
  • Заказ дисков через CSI на datastore. По умолчанию используются CNS-тома с изменением размера на лету. Режим First-Class Disk (FCD) доступен как legacy и настраивается параметром compatibilityFlag.
  • Заказ базовой инфраструктуры и CloudPermanent-узлов с помощью Terraform/OpenTofu-провайдера terraform-provider-vsphere.
  • Заказ CloudEphemeral-узлов через Machine Controller Manager (MCM). Параметры виртуальных машин задаются в ресурсе VsphereInstanceClass.
  • Регистрация в модуле node-manager, чтобы VsphereInstanceClass можно было указывать при описании NodeGroup.
  • Автоматическое включение CNI для новых кластеров. По умолчанию используется cni-cilium.

Модуль переводит управление CloudEphemeral-узлами с Machine Controller Manager (MCM) на Cluster API (CAPI). Существующие NodeGroup продолжают работать через MCM, новые по умолчанию создаются через CAPI. Порядок перевода существующих групп описан в разделе «Как мигрировать группы узлов на Cluster API (CAPI)».

Узлы под управлением CAPI

Требование к vSphere

В кластере vSphere, в котором создаются CAPI-узлы, должен быть включён DRS. При клонировании виртуальной машины модуль не указывает конкретный хост, поэтому хост внутри кластера выбирает vSphere. Без DRS выбор не выполняется, и узлы группы не создаются.

То же требование действует для master-узлов и CloudPermanent-узлов, которые создаёт Terraform. Группы узлов под управлением MCM работали и в кластере без DRS.

Остальные требования к окружению перечислены в разделе «Подключение и авторизация в VMware vSphere».

Теги vCenter

На каждую созданную виртуальную машину модуль назначает тег deckhouse-cluster-name/<CLUSTER_UUID>, как это делал и MCM. Тег deckhouse-node-role/<NODE_GROUP>-<ZONE>, который MCM назначал дополнительно, под управлением CAPI не назначается. Чтобы отобрать узлы одной группы, используйте лейбл node.deckhouse.io/group.

Размещение виртуальных машин

Модуль учитывает оба параметра размещения ресурса VsphereInstanceClass, resourcePool и datastore. Если в инстанс-классе задан хотя бы один из них, виртуальные машины группы создаются в указанном пуле ресурсов и на указанном хранилище во всех зонах, в которых работает группа. Незаданный параметр принимает значение по умолчанию, определённое для кластера при установке.

Внешние компоненты

Список стороннего программного обеспечения, используемого в модуле cloud-provider-vsphere (информация представлена на английском языке):