Installare Longhorn su un cluster homelab a 3 nodi

Illustrazione: un uomo che cavalca un toro attraverso un homelab

🌐 Anche in: English · Deutsch · Français · Español · Português · Nederlands · Polski

Se fai girare un piccolo homelab Kubernetes e vuoi storage persistente con ridondanza, Longhorn è una scelta eccellente. 🚀

Longhorn è un sistema di storage a blocchi distribuito, leggero e cloud-native per Kubernetes. Ti permette di creare volumi ad alta disponibilità, replicare i dati su più nodi e gestire volumi persistenti senza dipendere da appliance di storage esterne. Per homelab o cluster edge è perfetto, perché gira interamente dentro Kubernetes ed è facile da gestire tramite un’interfaccia web.

Prima di cominciare, su ogni server Proxmox ho creato una piccola VM aggiuntiva con 50 GB di disco apposta per i volumi Longhorn. Poi ho lanciato il mio playbook Ansible per configurare queste tre VM come worker node Kubernetes. 💻

Nel mio setup volevo uno storage ridondante e affidabile per piccoli workload e ambienti di test, ma senza sovraccaricare i dischi limitati delle VM. La soluzione ottimale sarebbe collegare lo storage Longhorn ai worker tramite una partizione aggiuntiva dedicata. Siccome faccio girare solo piccole app di test come WordPress o Nextcloud e non mi serve un’affidabilità da produzione, ho deciso di usare la partizione root per Longhorn, tenendo d’occhio con attenzione l’occupazione del disco tramite la GUI di Longhorn per non superare lo spazio disponibile. 🎯


Indice

1. Installare Helm

Se Helm non è ancora installato sul tuo sistema, puoi installarlo con Bash e curl:

curl -fsSL -o get_helm.sh https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3
chmod 700 get_helm.sh
./get_helm.sh
helm version

2. Aggiungere il repository Helm di Longhorn

Aggiungi il repo Helm ufficiale di Longhorn:

helm repo add longhorn https://charts.longhorn.io
helm repo update

Così puoi scaricare e installare facilmente i chart di Longhorn.


3. Etichettare i worker node

Prima dell’installazione, etichetta i worker node così che Longhorn venga distribuito solo lì:

kubectl label node vm16 longhorn=true
kubectl label node vm26 longhorn=true
kubectl label node vm36 longhorn=true

4. Preparare il chart Helm in locale

Per personalizzare l’installazione, scarica il chart in locale:

helm fetch longhorn/longhorn --untar
cd longhorn

Così puoi modificare values.yaml prima del deploy.


5. Adattare values.yaml

Modifiche importanti in values.yaml:

  • Namespace: longhorn-system – isola le risorse di Longhorn.
  • ReplicaCount: 2 – garantisce ridondanza per gli engine di Longhorn.
  • Storage Path: /var/lib/longhorn – per i test si usa la partizione root; in produzione si consiglia un disco dedicato.
  • NodeSelector: longhorn=true – fa sì che i pod vengano schedulati solo sui nodi etichettati.
  • UI NodePort: lasciato al default – per l’accesso nell’homelab.

6. Creare il namespace

kubectl create namespace longhorn-system

7. Installare Longhorn con Helm

helm install longhorn ./longhorn --namespace longhorn-system -f values.yaml

Helm distribuirà Longhorn con le impostazioni del tuo values.yaml personalizzato.

Output di kubectl dei pod di Longhorn nel namespace longhorn-system


8. Controllare il NodePort per la UI

kubectl get svc -n longhorn-system
kubectl get svc output showing the Longhorn UI NodePort

Accedi alla UI da qualsiasi worker node:

http://<worker-node-ip>:30964

9. Gestire i limiti del disco

Siccome le mie VM non hanno dischi aggiuntivi, ho limitato lo storage di Longhorn a una parte del filesystem root tramite la GUI di Longhorn. Questo evita di riempire il disco per sbaglio. In produzione usa un disco o una partizione dedicata per i volumi Longhorn.


10. Aggiornare / cambiare i valori

helm upgrade longhorn ./longhorn --namespace longhorn-system -f values.yaml

Aggiungi --install se la release potrebbe non esistere. Helm allora installerà o aggiornerà in modo sicuro.


✅ Risultato

  • Longhorn gira nel suo namespace longhorn-system
  • La UI è accessibile tramite NodePort
  • Percorso di storage e limiti del disco rispettati
  • Componenti solo sui nodi etichettati
  • Aggiornamento e sostituzione dei valori funzionano senza reinstallare

Questo setup è ideale per piccoli homelab: offre volumi persistenti ad alta disponibilità in Kubernetes, una UI amichevole e pieno controllo sull’uso dello storage. 🎉


E infine, nel mio prossimo post del blog WordPress, installerò un’app di test in cui sfrutterò Longhorn con i PersistentVolumeClaim (PVC), mostrando come le applicazioni possono usare direttamente i volumi gestiti da Longhorn come storage persistente. 🖖

Interfaccia web di Longhorn con i volumi del cluster a tre nodi

Alcuni testi e immagini di questo sito sono creati con l’aiuto dell’IA o generati dall’IA. Dettagli