Files
home-network-k3s-impl/platform/external-snapshotter/README.md
T
jakman85andClaude Opus 4.8 3586769460 feat(storage): CSI snapshots + smart-clone + migratable RWX for KubeVirt live-migration
Adds the VM/CDI storage tier approved by the PM (RWX for live-migration):

- platform/external-snapshotter (NEW, controllers pass): the cluster-singleton
  snapshot.storage.k8s.io control plane (CRDs + snapshot-controller in
  kube-system), pinned v8.2.0 (Kubernetes deps aligned to 1.31 since v8.1.0;
  this cluster is k3s v1.31.5). These CRDs were absent — only snapshots.longhorn.io
  and kubevirt.io snapshot CRDs existed.
- platform/longhorn/volumesnapshotclass.yaml (NEW, platform-config): the
  driver.longhorn.io VolumeSnapshotClass (type: snap, in-cluster).
- platform/kubevirt/cdi-storageprofiles.yaml (NEW, platform-config): StorageProfile
  longhorn -> cloneStrategy: snapshot; StorageProfile longhorn-vm -> snapshot clone
  + claimPropertySets RWX/Block. Non-degraded default virt class clears
  CDIDefaultStorageClassDegraded.
- platform/longhorn/storageclasses.yaml: NEW longhorn-vm StorageClass —
  migratable: "true" (Longhorn's KubeVirt-live-migration knob; RWX/Block-only on
  1.7.3), is-default-virt-class (NOT the k8s default; longhorn stays RWO default).
- platform/kubevirt/kubevirt-cr.yaml: comment only — LiveMigration is GA on v1.9
  (no feature gate); no cluster-wide evictionStrategy (would wedge RWO-disk drains);
  live-migration stays per-VM opt-in on a longhorn-vm disk.

Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-08-26 12:06:15 -05:00

1.6 KiB

external-snapshotter (CSI snapshot control plane)

Installs the cluster-singleton kubernetes-csi/external-snapshotter:

  • the snapshot.storage.k8s.io CRDs — VolumeSnapshot, VolumeSnapshotContent, VolumeSnapshotClass (v1, GA);
  • the snapshot-controller Deployment (into kube-system, the upstream default) that reconciles those objects against any CSI driver's CreateSnapshot/DeleteSnapshot.

Neither k3s nor the Longhorn chart ships this. It is a prerequisite for:

  1. VolumeSnapshotClass (driver.longhorn.io) — see ../longhorn/volumesnapshotclass.yaml (applied by platform-config).
  2. CDI snapshot smart-clone — the CDI StorageProfiles set cloneStrategy: snapshot (see ../kubevirt/cdi-storageprofiles.yaml); CDI clones VM disks by taking a CSI VolumeSnapshot instead of a slow host-assisted byte copy.
  3. Clearing the CDIDefaultStorageClassDegraded alert — a default virtualization StorageClass must support both smart-clone and ReadWriteMany.

Wiring

  • Pass: platform (controllers). Registers the CRDs.
  • The VolumeSnapshotClass / StorageProfile CRs that consume the CRDs live in the platform-config pass (dependsOn: platform), per the controllers/configs split.

Version

Pinned to v8.2.0 (Renovate-maintained). The v8.x line aligned to Kubernetes 1.31 at v8.1.0; this cluster is k3s v1.31.5. The snapshot-controller image is re-pinned to the same tag via the kustomization images transformer (the upstream setup manifest lags on the image tag).