Che cosa sono gli StatefulSet, i PersistentVolume/Claim, e come si eseguono workload stateful su Kubernetes?

Question

IT Interview Practice · Accepted Answer

I workload stateful (database, code, store in cluster) hanno bisogno di **identità stabile** e **storage durevole** — cose che un Deployment non fornisce. Uno **StatefulSet** dà ai Pod nomi stabili e un ciclo di vita ordinato; i **PersistentVolume (PV)** e i **PersistentVolumeClaim (PVC)** danno loro storage che sopravvive al Pod.

## Perché i Deployment non bastano

```text
Deployment Pods are INTERCHANGEABLE: random names (web-7f9-abc), any order, share
nothing per-Pod. That's perfect for stateless apps — but a database replica needs:
  → a STABLE network identity (so peers can find it: db-0, db-1, db-2)
  → its OWN durable disk that survives restarts/rescheduling
  → ORDERED, controlled startup/scaling (bring up db-0 before db-1)
StatefulSet provides exactly these.
```

## Garanzie dello StatefulSet

```text
Stable NAMES     → pod-0, pod-1, pod-2 (ordinal, not random)
Stable DNS       → db-0.db.default.svc... via a headless Service
Stable STORAGE   → each Pod gets its OWN PVC (db-0 keeps its disk across restarts)
Ordered ops      → create/scale up in order 0,1,2…; terminate in reverse
```

## Storage persistente: PV, PVC, StorageClass

```text
StorageClass → the "how to provision" template (e.g. AWS gp3, fast-ssd)
PVC          → a REQUEST for storage ("I need 20Gi, ReadWriteOnce")   ← app-facing
PV           → the ACTUAL provisioned volume bound to the PVC          ← cluster-facing
Dynamic provisioning: a PVC referencing a StorageClass auto-creates a matching PV.

App → PVC → (StorageClass provisions) → PV → real disk (EBS, PD, Ceph, NFS…)
```

## Uno StatefulSet con storage per-Pod

```yaml
apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: db
spec:
  serviceName: db            # headless Service for stable DNS
  replicas: 3
  selector:
    matchLabels: { app: db }
  template:
    metadata:
      labels: { app: db }
    spec:
      containers:
        - name: db
          image: postgres:16
          ports: [{ containerPort: 5432 }]
          volumeMounts:
            - name: data
              mountPath: /var/lib/postgresql/data
  volumeClaimTemplates:      # each Pod gets its OWN PVC/PV from this template
    - metadata:
        name: data
      spec:
        accessModes: [ReadWriteOnce]
        storageClassName: fast-ssd
        resources:
          requests: { storage: 20Gi }
```

```yaml
# The headless Service that gives stable per-Pod DNS (db-0.db, db-1.db, …)
apiVersion: v1
kind: Service
metadata: { name: db }
spec:
  clusterIP: None            # headless
  selector: { app: db }
  ports: [{ port: 5432 }]
```

## Access mode e avvertenze

```text
ReadWriteOnce (RWO)  → mounted read-write by ONE node (most block storage: EBS/PD)
ReadOnlyMany (ROX)   → read-only by many nodes
ReadWriteMany (RWX)  → read-write by many nodes (needs NFS/CephFS/EFS)
⚠ Deleting a StatefulSet does NOT delete its PVCs by default (data is preserved).
⚠ Reclaim policy (Retain/Delete) decides what happens to the PV when the PVC is removed.
⚠ Kubernetes gives identity+storage, but app-level clustering/replication is YOUR job
  (often via an Operator, e.g. for Postgres/Kafka).
```

```bash
kubectl get statefulset,pvc,pv
kubectl get pods -l app=db      # db-0, db-1, db-2 (stable, ordered)
```

## Perché è importante

Far girare correttamente i workload stateful è una delle parti più difficili di Kubernetes, quindi capire gli StatefulSet e lo storage persistente è una conoscenza di livello senior con vere conseguenze in produzione. L'intuizione centrale è *perché* i Deployment risultino insufficienti: i loro Pod sono intercambiabili (nomi casuali, ordine qualsiasi, nessuno stato per-Pod), il che è ideale per i service stateless ma sbagliato per database e store in cluster che hanno bisogno di **identità stabile** (così i peer possono trovare `db-0`, `db-1`, `db-2` via DNS), di un **proprio disco durevole** che sopravvive a riavvii e rescheduling, e di startup e scaling **ordinati e controllati**. Uno **StatefulSet** fornisce esattamente queste garanzie, e si accoppia con le astrazioni di storage: un **PersistentVolumeClaim** è la richiesta di storage lato applicazione, un **PersistentVolume** è il volume effettivamente provisionato, e una **StorageClass** abilita il provisioning dinamico — con i `volumeClaimTemplates` che danno a ogni Pod il proprio PVC/PV. Le avvertenze sono dove gli ingegneri senior si guadagnano il pane: gli **access mode** (RWO vs RWX e quali backend li supportano), il fatto che eliminare uno StatefulSet **preservi per default i suoi PVC**, la **reclaim policy** che governa il destino del PV e — cosa cruciale — che Kubernetes fornisce identità e storage ma la **replicazione e il clustering a livello applicativo restano una tua responsabilità**, spesso delegata a un Operator. Poiché la durabilità dei dati e il corretto comportamento stateful sono implacabili (gli errori significano perdita di dati o split-brain), padroneggiare StatefulSet, PV/PVC e le loro avvertenze è fondamentale per far girare database e altri sistemi stateful in modo affidabile su Kubernetes.

Perché i Deployment non bastano

Garanzie dello StatefulSet

Storage persistente: PV, PVC, StorageClass

Uno StatefulSet con storage per-Pod

Access mode e avvertenze

Perché è importante

Domande correlate