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]>
32 lines
1.6 KiB
Markdown
32 lines
1.6 KiB
Markdown
# external-snapshotter (CSI snapshot control plane)
|
|
|
|
Installs the cluster-singleton [kubernetes-csi/external-snapshotter](https://github.com/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 `StorageProfile`s 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).
|