Instalando o Longhorn num cluster de homelab com 3 nós

Ilustração: um homem montado num touro atravessando um homelab

🌐 Também em: English · Deutsch · Français · Español · Italiano · Nederlands · Polski

Se você roda um pequeno homelab Kubernetes e quer storage persistente com redundância, o Longhorn é uma excelente escolha. 🚀

O Longhorn é um sistema de storage distribuído em blocos, leve e cloud-native, para Kubernetes. Ele permite criar volumes de alta disponibilidade, replicar dados entre vários nós e gerenciar volumes persistentes sem depender de appliances de storage externos. Para homelabs ou clusters de borda ele é perfeito, porque roda inteiramente dentro do Kubernetes e é fácil de gerenciar por uma UI web.

Antes de começar, criei em cada servidor Proxmox uma pequena VM adicional com 50 GB de disco especificamente para volumes do Longhorn. Depois rodei meu playbook Ansible para configurar essas três VMs como worker nodes do Kubernetes. 💻

No meu setup, eu queria storage redundante e confiável para workloads pequenos e ambientes de teste, mas sem sobrecarregar os discos limitados das VMs. A solução ideal seria anexar o storage do Longhorn aos workers usando uma partição adicional dedicada. Como só rodo apps de teste pequenos, como WordPress ou Nextcloud, e não preciso de confiabilidade de nível de produção, decidi usar a partição raiz para o Longhorn, monitorando com cuidado o uso de disco pela GUI do Longhorn para não ultrapassar o espaço disponível. 🎯


Índice

1. Instalar o Helm

Se o Helm ainda não estiver instalado no seu sistema, você pode instalá-lo via 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. Adicionar o repositório Helm do Longhorn

Adicione o repositório Helm oficial do Longhorn:

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

Assim você consegue buscar e instalar os charts do Longhorn com facilidade.


3. Rotular os worker nodes

Antes da instalação, coloque labels nos worker nodes para que o Longhorn seja implantado só neles:

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

4. Preparar o Helm chart localmente

Para personalizar a instalação, baixe o chart localmente:

helm fetch longhorn/longhorn --untar
cd longhorn

Assim você pode editar o values.yaml antes do deploy.


5. Ajustar o values.yaml

Mudanças importantes no values.yaml:

  • Namespace: longhorn-system – isola os recursos do Longhorn.
  • ReplicaCount: 2 – garante redundância para as engines do Longhorn.
  • Storage Path: /var/lib/longhorn – a partição raiz é usada para testes; em produção, recomenda-se um disco dedicado.
  • NodeSelector: longhorn=true – garante que os pods só sejam agendados nos nós rotulados.
  • UI NodePort: deixado no padrão – para acesso no homelab.

6. Criar o namespace

kubectl create namespace longhorn-system

7. Instalar o Longhorn via Helm

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

O Helm vai implantar o Longhorn com as configurações do seu values.yaml personalizado.

Saída do kubectl com os pods do Longhorn no namespace longhorn-system


8. Verificar o NodePort da UI

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

Acesse a UI a partir de qualquer worker node:

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

9. Gerenciar limites de disco

Como minhas VMs não têm discos extras, limitei o storage do Longhorn a uma parte do sistema de arquivos raiz pela GUI do Longhorn. Isso evita lotar o disco sem querer. Em produção, use um disco ou partição dedicada para os volumes do Longhorn.


10. Atualizar / alterar valores

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

Adicione --install se o release talvez ainda não exista. O Helm então instala ou atualiza com segurança.


✅ Resultado

  • O Longhorn roda no seu próprio namespace longhorn-system
  • A UI está acessível via NodePort
  • Caminho de storage e limites de disco respeitados
  • Componentes só nos nós rotulados
  • Upgrade e troca de valores funcionam sem reinstalar

Este setup é ideal para homelabs pequenos e oferece volumes persistentes de alta disponibilidade no Kubernetes, uma UI amigável e controle total sobre o uso de storage. 🎉


E por fim, no meu próximo post do blog WordPress, vou instalar um app de teste em que vou aproveitar o Longhorn com PersistentVolumeClaims (PVCs), mostrando como aplicações podem usar diretamente os volumes gerenciados pelo Longhorn como storage persistente. 🖖

UI web do Longhorn com os volumes do cluster de três nós

Alguns textos e imagens deste site foram criados com a ajuda de IA ou gerados por IA. Detalhes