Доступно в редакциях: 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 (информация представлена на английском языке):
-
VMware vSphere Cloud provider v1.33.1, v1.34.0, v1.35.1, v1.35.1, v1.37.0
License: Apache License 2.0
Cloud Controller Manager for VMware vSphere.
-
VMware vSphere CSI driver v3.7.1, v3.7.1, v3.7.1, v3.7.1, v3.7.3
License: Apache License 2.0
CSI driver for VMware vSphere.
-
VMware vSphere Terraform provider 2.0.2
License: Mozilla Public License 2.0
Terraform provider for VMware vSphere.
-
VMware vSphere Cluster API provider v1.15.3
License: Apache License 2.0
Infrastructure provider for Kubernetes Cluster API in VMware vSphere.