Back to Hub

cargo.ayedo.cloud/ayedo/k8s/hcloud-csi 1.0.1 k8sapp MIT

Container Storage Interface driver for Hetzner Cloud Volumes — provides persistent block storage for Kubernetes via ReadWriteOnce volumes

polycrate block pull cargo.ayedo.cloud/ayedo/k8s/hcloud-csi:1.0.1

Hetzner Cloud CSI Driver

Installs the Container Storage Interface driver for Hetzner Cloud via static manifests. Provides persistent block storage (ReadWriteOnce) for Kubernetes using Hetzner Cloud Volumes.

  • Upstream — hetznercloud/csi-driver
  • License — MIT
  • app_version — 2.20.0
  • Kubernetes — >= 1.32 (tested: 1.33, 1.34, 1.35)
  • Implementation — Static Kubernetes manifests (no Helm)

Prerequisites

  • A Hetzner Cloud API token
  • Kubernetes >= 1.32 with CSI support enabled
  • The hcloud-ccm block should be installed first (cloud controller manager)

Configuration

  • token ("") — Hetzner Cloud API token (required)
  • namespace (kube-system) — Target namespace
  • storageclass.name (hcloud-volumes) — StorageClass name
  • storageclass.is_default (true) — Set as default StorageClass
  • storageclass.volume_binding_mode (WaitForFirstConsumer) — Volume binding mode
  • storageclass.reclaim_policy (Delete) — Reclaim policy
  • storageclass.allow_volume_expansion (true) — Allow volume expansion
  • images.driver (2.20.0) — hcloud-csi-driver version
  • images.csi_attacher (4.11.0) — CSI attacher sidecar version
  • images.csi_resizer (2.1.0) — CSI resizer sidecar version
  • images.csi_provisioner (6.1.1) — CSI provisioner sidecar version
  • images.csi_node_driver_registrar (2.16.0) — Node driver registrar version
  • images.livenessprobe (2.18.0) — Liveness probe sidecar version

Actions

install

Deploys the CSI driver as a controller Deployment + node DaemonSet with proper RBAC, StorageClass, and CSIDriver resource.

blocks:
  - name: csi
    from: cargo.ayedo.cloud/ayedo/k8s/hcloud-csi
    kubeconfig:
      from: k8s
    inventory:
      from: vpc
    config:
      token: "HetznerCloudToken"
      storageclass:
        name: hcloud-volumes
        is_default: true

uninstall

Removes the Hetzner Cloud CSI Driver from the cluster.

polycrate run csi uninstall

Warning: Uninstalling does not delete the Secret to prevent accidental token loss. Existing PersistentVolumes are not affected.

Deployed Resources

  • Secret/hcloud — API token
  • CSIDriver/csi.hetzner.cloud — CSI driver registration
  • StorageClass/hcloud-volumes — Default storage class
  • ServiceAccount/hcloud-csi-controller
  • ClusterRole/hcloud-csi-controller — Least-privilege RBAC
  • ClusterRoleBinding/hcloud-csi-controller
  • Deployment/hcloud-csi-controller — Controller with CSI sidecars
  • DaemonSet/hcloud-csi-node — Node plugin on every cloud node
  • Service/hcloud-csi-controller-metrics — Prometheus metrics (port 9189)
  • Service/hcloud-csi-node-metrics — Node metrics (port 9189)

Migration from < 1.0.0

This is a breaking change. The block config structure has changed completely:

  • is_default_class — storageclass.is_default
  • volume_binding_mode — storageclass.volume_binding_mode
  • resource_prefix — removed
  • k8s_worker_kubelet_conf_dir — removed (hardcoded to /var/lib/kubelet)
  • force_install — removed
  • v1_6_0.images.* — images.*
  • v2_2_0.images.* — images.*
  • v2_3_2.images.* — images.*

Upgrade procedure:

  1. polycrate run csi uninstall (with old block version)
  2. Update block to 1.0.0 (polycrate block pull cargo.ayedo.cloud/ayedo/k8s/hcloud-csi)
  3. Update workspace.poly config to match new schema
  4. polycrate run csi install