Instalacja Longhorna na trzywęzłowym klastrze w homelabie

Ilustracja: mężczyzna jadący na byku przez homelab

🌐 Także w: English · Deutsch · Français · Español · Italiano · Português · Nederlands

Jeśli prowadzisz mały homelab z Kubernetesem i chcesz mieć trwały storage z redundancją, Longhorn to świetny wybór. 🚀

Longhorn to lekki, cloud-native, rozproszony system storage blokowego dla Kubernetesa. Pozwala tworzyć wolumeny o wysokiej dostępności, replikować dane między wieloma węzłami i zarządzać trwałymi wolumenami bez polegania na zewnętrznych macierzach. Do homelabów czy klastrów brzegowych nadaje się idealnie, bo działa w całości wewnątrz Kubernetesa i łatwo nim zarządzać przez interfejs WWW.

Zanim zacząłem, na każdym serwerze Proxmox utworzyłem małą dodatkową maszynę wirtualną z dyskiem 50 GB specjalnie na wolumeny Longhorna. Potem uruchomiłem swój playbook Ansible, żeby skonfigurować te trzy VM jako worker nodes Kubernetesa. 💻

W moim setupie chciałem redundantnego, niezawodnego storage dla małych obciążeń i środowisk testowych, ale bez przeciążania ograniczonych dysków VM. Optymalnym rozwiązaniem byłoby podpięcie storage Longhorna do workerów przez osobną, dedykowaną partycję. Ponieważ uruchamiam tylko małe aplikacje testowe, takie jak WordPress czy Nextcloud, i nie potrzebuję niezawodności na poziomie produkcyjnym, zdecydowałem się użyć dla Longhorna partycji root, uważnie monitorując zajętość dysku w GUI Longhorna, żeby nie przekroczyć dostępnego miejsca. 🎯


Spis treści

1. Instalacja Helma

Jeśli Helm nie jest jeszcze zainstalowany w twoim systemie, możesz go zainstalować przez Bash i 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. Dodanie repozytorium Helm Longhorna

Dodaj oficjalne repozytorium Helm Longhorna:

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

Dzięki temu łatwo pobierzesz i zainstalujesz charty Longhorna.


3. Oznaczenie worker nodes etykietami

Przed instalacją nadaj worker nodes etykiety, żeby Longhorn był wdrażany tylko na nich:

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

4. Lokalne przygotowanie Helm charta

Aby dostosować instalację, pobierz chart lokalnie:

helm fetch longhorn/longhorn --untar
cd longhorn

Dzięki temu możesz edytować values.yaml przed wdrożeniem.


5. Dostosowanie values.yaml

Ważne zmiany w values.yaml:

  • Namespace: longhorn-system – izoluje zasoby Longhorna.
  • ReplicaCount: 2 – zapewnia redundancję silników Longhorna.
  • Storage Path: /var/lib/longhorn – do testów używana jest partycja root; na produkcji zalecany jest osobny dysk.
  • NodeSelector: longhorn=true – gwarantuje, że pody będą planowane tylko na oznaczonych węzłach.
  • UI NodePort: pozostawiony domyślny – do dostępu w homelabie.

6. Utworzenie przestrzeni nazw

kubectl create namespace longhorn-system

7. Instalacja Longhorna przez Helma

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

Helm wdroży Longhorna z ustawieniami z twojego dostosowanego values.yaml.

Wynik kubectl z podami Longhorna w przestrzeni nazw longhorn-system


8. Sprawdzenie NodePortu dla UI

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

Otwórz UI z dowolnego worker node’a:

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

9. Zarządzanie limitami dysku

Ponieważ moje VM nie mają dodatkowych dysków, ograniczyłem storage Longhorna do części głównego systemu plików przez GUI Longhorna. To zapobiega przypadkowemu zapełnieniu dysku. Na produkcji używaj osobnego dysku lub partycji na wolumeny Longhorna.


10. Aktualizacja / zmiana wartości

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

Dodaj --install, jeśli release może jeszcze nie istnieć. Helm wtedy bezpiecznie zainstaluje albo zaktualizuje.


✅ Wynik

  • Longhorn działa we własnej przestrzeni nazw longhorn-system
  • UI jest dostępne przez NodePort
  • Ścieżka storage i limity dysku są respektowane
  • Komponenty tylko na oznaczonych węzłach
  • Aktualizacja i podmiana wartości działają bez reinstalacji

Ten setup jest idealny dla małych homelabów: daje trwałe wolumeny o wysokiej dostępności w Kubernetesie, przyjazne UI i pełną kontrolę nad zużyciem storage. 🎉


I na koniec: w moim następnym wpisie na blogu WordPress zainstaluję aplikację testową, w której wykorzystam Longhorna z PersistentVolumeClaims (PVC), pokazując, jak aplikacje mogą bezpośrednio używać wolumenów zarządzanych przez Longhorna jako trwałego storage. 🖖

Interfejs WWW Longhorna z wolumenami trzywęzłowego klastra

Część tekstów i obrazów na tej stronie powstała z pomocą AI lub została wygenerowana przez AI. Szczegóły