| title | The storage-foundation module |
|---|---|
| description | Enables snapshot support and volume cloning for compatible CSI drivers in a Kubernetes cluster. |
This module enables snapshot support for compatible CSI-drivers in the Kubernetes cluster.
Deckhouse Kubernetes Platform CSI-drivers that support snapshots:
- cloud-provider-openstack
- cloud-provider-vsphere
- cloud-provider-aws
- cloud-provider-azure
- cloud-provider-gcp
- sds-local-volume
- sds-replicated-volume
- csi-ceph
- csi-nfs
- csi-hpe
- csi-huawei
- csi-yadro-tatlin-unified
The module also enables secure HTTP-based export and import of persistent volume contents. It creates a namespaced DataExport or DataImport resource in the target namespace, which references the volume to be exported via the targetRef field. The supported target types include PersistentVolumeClaim and VolumeSnapshot.
The data server is built on the standard Go file server and supports both filesystem and block-level volume work modes. User authentication is handled through Kubernetes RBAC, with support for partial content transfer using HTTP Range headers.
-
ttl: Time-to-live duration after the last server access (file download or directory listing). When the TTL expires, the exporter pod is automatically deleted and the PVC is released back to the original PV. TheDataExportresource'sReadycondition is set tofalsewith reasonExpired. -
publish: When set totrue, enables external cluster access to the exporter pod. A public URL is generated in the resource'sstatus.publicURLfield with the format:https://api.<public-domain>/<namespace>/<kindShort>/<name>/.
For usage examples (the d8 utility, raw manifests, and the HTTP API reference), see the usage documentation.