Homelab Rebuild 2026 — GitLab, una Seed VM e la quiete prima della tempesta Kubernetes

Illustrazione del rebuild dell'homelab con GitLab e una Seed VM

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

😌 Avviso onesto: questa puntata è la quiete prima della tempesta. GitLab e la Seed VM si sono rivelati piacevolmente facili — infrastruttura noiosa, fatta in modo noioso, di proposito. Lo dico esplicitamente perché il prossimo post è territorio Kubernetes — FluxCD, reconciliation loop GitOps e tutti i modi in cui un cluster può sembrare sano fino al momento in cui decisamente non lo è — e quella è stata una battaglia molto più grossa. Considera questo il respiro profondo prima del tuffo. 🤿 🦊 Ogni homelab arriva a un punto in cui “entro in SSH e lancio il comando a mano” smette di essere simpatico e comincia a essere un rischio. Questo post parla del momento in cui questo lab ha superato quella linea: mettere in piedi GitLab come unica fonte di verità, e costruire una Seed VM dedicata così che “gli strumenti per gestire l’infrastruttura” smettano di vivere su qualunque portatile mi capiti in mano. 💻➡️🗄️ Recupera la puntata precedente qui: Homelab Rebuild 2026: costruire il cluster Proxmox e fare il provisioning con Terraform.

Indice

🦊 GitLab: da una macchina bare metal a una vera VM

GitLab in realtà gira in questo homelab già da un po’ — solo non correttamente. L’istanza originale viveva direttamente sul bare metal di HP3 (Debian, nessun hypervisor sotto, niente snapshot, nessun backup degno di questo nome). Funzionante, ma esattamente il tipo di setup “temporaneo” che in silenzio diventa infrastruttura permanente da cui dipendono tutti. 😅 La soluzione: installare GitLab come si deve in una VM (HP1-gitlab01, 192.168.10.x, 12 GB di RAM, 120 GB di disco) tramite il pacchetto Omnibus standard — il repository apt ufficiale di GitLab, un pacchetto che contiene GitLab stesso, il suo PostgreSQL, Redis e NGINX integrati, configurati tramite un unico /etc/gitlab/gitlab.rb. È la via d’installazione noiosa e battuta, di proposito: è infrastruttura a cui voglio non pensare, non un progetto scientifico. Internamente è HTTP semplice, ancora senza TLS davanti — va bene per un’istanza solo LAN, anche se più avanti mi si è ritorto contro quando il bootstrap di FluxCD si è rifiutato di mandare credenziali su HTTP non cifrato (una storia per un altro post 👀). La parte davvero interessante non è stata l’installazione da zero — è stata portare i dati della vecchia istanza senza perdere la cronologia. Se n’è occupato lo strumento di backup/restore di GitLab stesso: un gitlab-backup create completo sulla vecchia macchina bare metal, l’archivio risultante più il file dei segreti dell’istanza (gitlab-secrets.json) copiati, poi gitlab-backup restore sulla nuova VM con una versione di GitLab corrispondente. Progetti, issue e — cosa fondamentale — ogni branch di ogni repo, compreso il branch internal di questo progetto (quello che contiene le credenziali vere, mai pushato sul mirror pubblico su GitHub) sono arrivati intatti. Ho fatto percorrere a Claude l’intera sequenza export → trasferimento → import → verifica e confermare che l’istanza migrata corrispondesse davvero a quella vecchia prima che HP3 venisse cancellato. 🔍✅ Una volta verificato, l’installazione Debian bare metal di HP3 è stata cancellata del tutto e ricostruita come terzo nodo Proxmox VE — il che significa che GitLab ora non è solo su una VM, è su una VM che sta nello stesso cluster Proxmox di tutto il resto, con snapshot e backup PBS come qualsiasi altro workload. Basta con l’atmosfera “speriamo che la macchina bare metal non muoia”. 🙏

🌱 Entra in scena la Seed VM

Con GitLab che custodisce la vera fonte di verità per Terraform e Ansible, la lacuna successiva era ovvia: da dove girano davvero terraform apply e ansible-playbook? “Dalla macchina che quel giorno ha gli strumenti installati” non è una risposta, è un rischio con l’impermeabile addosso. Quindi: HP1-seed01 (192.168.10.x) — una piccola e noiosa VM Ubuntu da 4 GB / 60 GB il cui unico compito è essere l’unico posto da cui si fanno le modifiche all’infrastruttura. Costruita interamente da un playbook Ansible (02_ansible/playbooks/seed01.yml), quindi ricostruibile da zero in pochi minuti, non “come mi ricordo di averla configurata l’ultima volta”. 🌱 Cosa ci finisce sopra:

  • 🔧 git — nessun pin di versione, nessun motivo per farne una questione
  • 🏗️ Terraform, fissato a una versione esatta (1.15.8) tramite il repo apt ufficiale di HashiCorp — le modifiche all’infrastruttura non dovrebbero mai prendersi in silenzio una nuova release di Terraform a metà di un apply
  • 📜 Ansible stesso, così la Seed VM potrà un giorno lanciare playbook contro il resto della flotta, se stessa compresa
  • ☸️ kubectl, fissato alla minor version del cluster RKE2 (al momento segue v1.36) tramite il repo apt ufficiale di Kubernetes
  • ⎈ Helm, fissato a una release esatta, scaricato direttamente da get.helm.sh

Due bei dettagli che vale la pena sottolineare. Primo, il playbook non si limita a piazzare un binario kubectl nudo e dichiarare finito — recupera il kubeconfig live direttamente dal primo nodo control plane del cluster, riscrive l’indirizzo di loopback con il vero IP di quel nodo e lo installa sia per l’account ubuntu sia per user3. kubectl get nodes funziona nell’istante in cui il playbook finisce, senza dover copiare e incollare un kubeconfig in giro. Secondo: ogni account riceve un alias k per kubectl collegato al completamento bash completo — così k get pods si completa con il tab esattamente come farebbe kubectl get pods. Piccola cosa, risparmia tasti per sempre. ⌨️ Le versioni stesse vivono in un unico posto (group_vars/all.yml) — alzi un numero, rilanci il playbook, e ogni strumento si aggiorna di pari passo con ciò di cui il cluster ha davvero bisogno. Basta momenti del tipo “aspetta, ma che minor version di kubectl sto usando?”.

🧠 Perché conta più di quanto sembri

Niente di tutto questo è glamour. Nessuno scrive un post intitolato “Ho installato kubectl” aspettandosi applausi. Ma è la differenza tra un homelab che è un museo di passi manuali una tantum che tra sei mesi avrò dimenticato, e uno in cui “ricostruire tutto da Git” è un’affermazione reale e testata invece che una speranza. GitLab ora è la vera fonte di verità; la Seed VM è il vero posto da cui si applicano le modifiche. Due VM noiose, ognuna con un solo compito, entrambe completamente riproducibili dal codice. 📦 Prossimamente: o il lato Kubernetes/FluxCD/Longhorn di questo cluster, oppure — se finalmente lo risolvo — il mistero ancora aperto del client Windows nel dominio la cui Group Policy a livello utente si rifiuta categoricamente di applicare anche una sola GPO, nonostante Active Directory risulti perfettamente sana da ogni angolazione da cui l’ho attaccata. Restate sintonizzati. 🕵️‍♂️


📚 Altro in questa serie: Homelab Rebuild 2026

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