csi-xen-orchestra-driver

Warning

Under active development.

CSI Driver for Xen-orchestra-managed xcp-ng environments.

Requirements

• Xen Orchestra (XO)
• Kubernetes Cluster (1.30+):
  • with xenorchestra-cloud-controller-manager
• Kubernetes Nodes:
  • with xe-guest-utils installed

Compatibility

The CSI driver has been tested with the following versions:

Driver Version	Kubernetes Versions	Xen Orchestra Versions
v0.2.x	1.30+ (tested up to 1.34)	5.106.2+
v0.1.x	1.30	5.106.2+

Note

While tested with Talos, the driver should be compatible with other Kubernetes distributions. If you encounter issues with other distributions, please report them.

Features

• Dynamic provisioning (create disks on demand via PVCs)
• Migration of disks between storage repositories (see: Disk Migrations)
• Static provisioning (use an existing VDI by UUID)
• Offline volume expansion
• Topology aware (pool, and optionally host)

Documentation

Start here

• Getting started

How to use the driver

• selecting Storage Repositories
• feature Disk Migrations
• pre existing Static volumes
• considerations when using Local Storage

Configuration

• StorageClass parameters
• Driver configuration (flags, authentication)

Operational notes

• Disk creation leakage and mitigations

Development

• Development

Contributing

Contributions are welcome.

TODO/Roadmap

• Prometheus metrics
• Kubernetes Support Matrix (and test up to latest kubernetes)
• Investigate what happens when running without cloud-controller-manager and degrade gracefully