Модуль csi-s3 предназначен для управления томами на основе S3-хранилищ. Модуль использует geeseFS — файловую систему FUSE на основе S3. Модуль позволяет создавать StorageClass в Kubernetes с помощью ресурса S3StorageClass.
Подробнее с описанием модуля можно ознакомиться в разделе документации модуля.
Архитектура модуля
Для упрощения схемы приняты следующие допущения:
- На схеме показано, что контейнеры разных подов взаимодействуют друг с другом напрямую. Фактически они взаимодействуют через соответствующие сервисы Kubernetes (внутренние балансировщики). Названия сервисов не указываются, если они очевидны из контекста. В остальных случаях название сервиса указано над стрелкой.
- Поды могут быть запущены в нескольких репликах, однако на схеме все поды изображены в одной реплике.
Архитектура модуля csi-s3 на уровне 2 модели C4 и его взаимодействия с другими компонентами Deckhouse Kubernetes Platform (DKP) изображены на следующей диаграмме:

Компоненты модуля
Модуль состоит из следующих компонентов:
-
Controller — контроллер, обслуживающий кастомный ресурс S3StorageClass. Ресурс S3StorageClass определяет конфигурацию для создаваемого Kubernetes StorageClass, использующего provisioner
ru.yandex.s3.csi.Состоит из следующих контейнеров:
- controller — основной контейнер;
- webhooks — сайдкар-контейнер, реализующий вебхук-сервер для проверки кастомного ресурса ModuleConfig.
-
CSI-драйвер (s3) — реализация CSI-драйвера, использующего provisioner
ru.yandex.s3.csi. С архитектурой CSI-драйвераcsi-s3можно ознакомиться на странице описания CSI-драйвера.
Взаимодействия модуля
Модуль взаимодействует со следующими компонентами:
-
Kube-apiserver:
- мониторинг ресурсов PersistentVolume, PersistentVolumeClaim, VolumeAttachment, Secret и StorageClass;
- работа с кастомными ресурсами S3StorageClass и ModuleConfig;
- создание ресурсов StorageClass и Secret.
-
S3-хранилище — создание и удаление томов, подключение и отключение томов от узлов.
С модулем взаимодействуют следующие внешние компоненты:
- Kube-apiserver — валидация кастомных ресурсов ModuleConfig.