Модуль CSI vSphere (shturval-capvs-csi)

О сервисе #

Назначение #

shturval-capvs-csi — модуль CSI vSphere. Позволяет подключать диски из VMware vSphere как PersistentVolume по запросу через StorageClass при использовании кластеров на базе vSphere.

Где настраивать #

Сервисы и репозитории → Установленные сервисы → shturval-capvs-csi → Управлять.

Настройка классов хранилища: StorageClasses (классы хранилища). Для кластеров на vSphere после установки провайдера shturval-capvs при создании кластера с интеграцией CSI модуль может быть установлен автоматически.

Установка чарта в кластер #

Если при создании кластера с провайдером vSphere была включена интеграция CSI, модуль устанавливается автоматически. Для ручной установки перейдите в Сервисы и репозитории → Доступные чарты, найдите чарт shturval-capvs-csi и нажмите Установить.

В блоке Спецификация сервиса укажите в качестве customvalues:

global:
  config:
    global:
      insecure-flag: true
      cluster-id: <ваше значение>
    storageclass:
      expansion: true
      datastoreurl: <ваше значение>
    vcenter:
      <имя vCenter>:
        server: <ваше значение>
        user: <ваше значение>
        password: <ваше значение>
        datacenters:
          - <ваше значение>

После установки в кластер будет добавлен StorageClass vsphere-csi. Для использования его по умолчанию удалите аннотацию storageclass.kubernetes.io/is-default-class: "true" у StorageClass local-path (Хранилище → StorageClasses → local-path → Лейблы и аннотации).

Учётная запись vCenter #

Для изменения учётных данных vCenter примените ShturvalServicePatch (см. Как управлять CustomValues сервисов):

apiVersion: ops.shturval.tech/v1beta2
kind: ShturvalServicePatch
metadata:
  name: <имя ресурса>
spec:
  shturvalServiceConfigName: shturval-capvs-csi
  customvalues:
    global:
      config:
        vcenter:
          <имя vCenter>:
            user: <ваше значение>
            password: <ваше значение>

Использование vSphereCSI в кластере с провайдером Shturval v2 #

Использование vSphere CSI в кластере с провайдером Shturval v2 возможно только с хостами, развёрнутыми на платформе виртуализации vSphere.

Установка при создании кластера #

На каждом хосте перед началом инсталляции (для клиентского кластера — перед добавлением хостов в провайдер) выполните:

1. Включите параметр disk.EnableUUID в клиенте vSphere: Edit Settings → VM Options → Advanced → Edit Configuration → установите disk.EnableUUID = True.
2. Обновите версию аппаратного обеспечения VM до версии 15 или выше: Actions → Compatibility → Upgrade VM Compatibility.
3. Добавьте VMware Paravirtual SCSI storage controller: Edit Settings → Virtual Hardware → Add New Device → SCSI Controller → тип VMware Paravirtual.

Установка в развёрнутом кластере #

Если кластер уже развёрнут с провайдером Shturval v2 на хостах vSphere:

1. Выполните те же настройки ВМ (disk.EnableUUID, аппаратная версия, SCSI-контроллер) для каждого узла.
2. Последовательно выполните drain узла, перезагрузите ВМ, затем uncordon; дождитесь возврата нагрузки перед переходом к следующему узлу.
3. При наличии старой установки vSphere CSI — удалите её.
4. Установите новый vSphere CSI в неймспейс shturval-capvs-csi с customvalues из раздела выше.

После установки StorageClass создаётся как default. При необходимости снимите флаг default с одного из StorageClass (local-path или vsphere-csi).

Как развернуть этот сервис — Как развернуть новый сервис.