Сsi-external-provisioner#

Сsi-external-provisioner - компонент управляет динамическим выделением томов CSI. Обеспечивает создание, монтирование и удаление томов CSI по запросу. Компонент предоставляет API для создания, удаления и монтирования томов и запускается в DropApp Plus в виде pod.

Последовательность выполнения#

Рекомендуемые флаги приведены в таблице.

Таблица. Рекомендуемые флаги Сsi-external-provisioner

Сsi-external-provisioner может работать в одном pod с другими внешними контроллерами CSI, такими как Сsi-external-attacher, Сsi-external-snapshotter и Сsi-external-resizer.

Сsi-external-provisioner не масштабируется с большим количеством реплик. Только один экземпляр Сsi-external-provisioner избирается в качестве главного процесса и работает. Новый главный процесс переизбирается через 15 секунд после завершения работы старого процесса.

Внешний поставщик можно использовать для создания объектов CSIStorageCapacity, которые содержат информацию о емкости хранилища, доступной через драйвер. Затем планировщик DropApp Plus использует эту информацию при выборе узлов для модулей с несвязанными томами, ожидающими первого потребителя.

Все объекты CSIStorageCapacity, созданные экземпляром Сsi-external-provisioner, имеют определенные метки:

• csi.storage.k8s.io/drivername имя драйвера CSI;

• csi.storage.k8s.io/managed-by Сsi-external-provisioner для централизованного предоставления, Сsi-external-provisioner для распределенного предоставления.

Они создаются в пространстве имен, указанном в переменной среды.

Каждый экземпляр Сsi-external-provisioner управляет именно теми объектами с метками, которые соответствуют экземпляру.

При необходимости все объекты CSIStorageCapacity, созданные экземпляром Сsi-external-provisioner, могут иметь владельца. Это гарантирует автоматическое удаление объектов при удалении драйвера CSI. Владелец определяется переменными среды POD_NAME/NAMESPACE и параметром --capacity-ownerref-level.

Если владение отключено, администратор хранилища отвечает за удаление потерянных объектов CSIStorageCapacity, и для очистки потерянных объектов драйвера можно использовать следующую команду:

oc delete csistoragecapacities -l csi.storage.k8s.io/drivername=my-csi.example.com

Следуйте последовательности действий, чтобы настроить поддержку емкости.

1. Установите переменные среды POD_NAME и NAMESPACE:

   env:
   - name: NAMESPACE
     valueFrom:
     fieldRef:
     fieldPath: metadata.namespace
   - name: POD_NAME
     valueFrom:
     fieldRef:
     fieldPath: metadata.name
   

2. Примените манифест:

   kind: Deployment
   apiVersion: apps/v1
   metadata:
     name: csi-provisioner
   spec:
     replicas: 3
     selector:
       matchLabels:
         app: csi-provisioner
     template:
       metadata:
         labels:
           app: csi-provisioner
       spec:
         serviceAccount: csi-provisioner
         containers:
           - name: csi-provisioner
             image: dappregistry/1.2/csi-provisioner:v3.3.0
             args:
               - "--csi-address=$(ADDRESS)"
               - "--leader-election"
               - "--http-endpoint=:8080"
             env:
               - name: ADDRESS
                 value: /var/lib/csi/sockets/pluginproxy/mock.socket
             imagePullPolicy: "IfNotPresent"
             volumeMounts:
               - name: socket-dir
                 mountPath: /var/lib/csi/sockets/pluginproxy/
             ports:
               - containerPort: 8080
                 name: http-endpoint
                 protocol: TCP
             livenessProbe:
               failureThreshold: 1
               httpGet:
                 path: /healthz/leader-election
                 port: http-endpoint
               initialDelaySeconds: 10
               timeoutSeconds: 10
               periodSeconds: 20
           - name: mock-driver
             image: quay.io/k8scsi/mock-driver:canary
             env:
               - name: CSI_ENDPOINT
                 value: /var/lib/csi/sockets/pluginproxy/mock.socket
             volumeMounts:
               - name: socket-dir
                 mountPath: /var/lib/csi/sockets/pluginproxy/
         volumes:
           - name: socket-dir
             emptyDir:
   

3. Добавьте в командную строку флаг --enable-capacity.

4. Добавьте StorageCapacity: true в информационный объект CSIDriver.

5. Если Сsi-external-provisioner не развернут StatefulSet, настройте при помощи флага --capacity-ownerref-level какими объектами будет происходить управление CSIStorageCapacity.

6. Настройте частоту опроса драйвера для обнаружения измененной емкости с помощью флага --capacity-poll-interval.

7. Настройте количество рабочих потоков, используемых параллельно с помощью флага --capacity-threads.

8. Включите создание информации также для классов хранения, которые используют немедленную привязку тома с файлом --capacity-for-immediate-binding.

Результат#

Сsi-external-provisioner настроен и готов к использованию.