2022-01-29 23:43:22 +03:00
[Документация ](../../README-ru.md#документация ) → Установка → Kubernetes CSI
-----
[Read in English ](kubernetes.en.md )
# Kubernetes CSI
У Vitastor есть CSI-плагин для Kubernetes, поддерживающий RWO, а также блочные RWX, тома.
2023-06-22 01:16:00 +03:00
Для установки возьмите манифесты из директории [csi/deploy/ ](../../csi/deploy/ ), поместите
вашу конфигурацию подключения к Vitastor в [csi/deploy/001-csi-config-map.yaml ](../../csi/deploy/001-csi-config-map.yaml ),
настройте StorageClass в [csi/deploy/009-storage-class.yaml ](../../csi/deploy/009-storage-class.yaml )
2022-01-29 23:43:22 +03:00
и примените все `NNN-*.yaml` к вашей инсталляции Kubernetes.
```
for i in ./???-*.yaml; do kubectl apply -f $i; done
```
2023-11-05 01:05:26 +03:00
После этого вы сможете создавать PersistentVolume.
2023-12-02 13:47:51 +03:00
**Важно:** Лучше всего использовать ядро Linux версии не менее 5.15 с включёнными модулями
[VDUSE ](../usage/qemu.ru.md#vduse ) (vdpa, vduse, virtio-vdpa). Если в вашем дистрибутиве
они не собраны из коробки - соберите их сами, обещаю, что это стоит того ([инструкция](../usage/qemu.ru.md#vduse)) :-).
Когда VDUSE недоступно, CSI-плагин использует [NBD ](../usage/nbd.ru.md ) для подключения
дисков, а NBD медленнее и имеет проблему таймаута - если кластер остаётся недоступным
дольше, чем [nbd_timeout ](../config/client.ru.md#nbd_timeout ), NBD-устройство отключается
и ломает поды, использующие е г о .
2023-11-05 01:05:26 +03:00
## Возможности
CSI-плагин Vitastor поддерживает:
- Версии Kubernetes, начиная с 1.20 (или с 1.17 для более старых vitastor-csi < = 1.1.0)
- Файловые RWO (ReadWriteOnce) тома. Пример: [PVC ](../../csi/deploy/example-pvc.yaml ), [под ](../../csi/deploy/example-test-pod.yaml )
- Сырые блочные RWX (ReadWriteMany) тома. Пример: [PVC ](../../csi/deploy/example-pvc-block.yaml ), [под ](../../csi/deploy/example-test-pod-block.yaml )
- Расширение размера томов
- Снимки томов. Пример: [класс снимков ](../../csi/deploy/example-snapshot-class.yaml ), [снимок ](../../csi/deploy/example-snapshot.yaml ), [клон снимка ](../../csi/deploy/example-snapshot-clone.yaml )
2023-12-02 13:47:51 +03:00
- Способы подключения устройств [VDUSE ](../usage/qemu.ru.md#vduse ) (предпочитаемый) и [NBD ](../usage/nbd.ru.md )
- Обновление при использовании VDUSE - новые процессы-обработчики устройств успешно перезапускаются вместе с самими подами CSI
- Несколько кластеров через задание нескольких файлов конфигурации в ConfigMap.
2023-11-05 01:05:26 +03:00
Н е забывайте, что для использования снимков нужно сначала установить [контроллер снимков и CRD ](https://kubernetes-csi.github.io/docs/snapshot-controller.html#deployment ).