Homelab Rebuild 2026 — GitLab, uma Seed VM e a calmaria antes da tempestade Kubernetes

🌐 Também em: English · Deutsch · Français · Español · Italiano · Nederlands · Polski
😌 Aviso justo: este episódio é a calmaria antes da tempestade. O GitLab e a Seed VM acabaram sendo refrescantemente fáceis — infraestrutura chata, feita de um jeito chato, de propósito. Menciono isso explicitamente porque o próximo post é território Kubernetes — FluxCD, loops de reconciliação GitOps e todas as formas pelas quais um cluster pode parecer saudável até o exato momento em que definitivamente não está — e aquela foi uma briga bem maior. Considere isto o fôlego fundo antes do mergulho. 🤿 🦊 Todo homelab chega a um ponto em que “é só entrar por SSH e rodar o comando na mão” deixa de ser charmoso e passa a ser um passivo. Este post é sobre o momento em que este lab cruzou essa linha: subir o GitLab como fonte única da verdade e construir uma Seed VM dedicada, para que “as ferramentas para gerenciar a infraestrutura” parem de morar no notebook que eu por acaso estiver segurando. 💻➡️🗄️ Recupere o episódio anterior aqui: Homelab Rebuild 2026: construindo o cluster Proxmox e provisionando com Terraform.
Índice
🦊 GitLab: de uma máquina bare metal para uma VM de verdade
O GitLab na verdade já roda neste homelab há um tempo — só que não direito. A instância original morava direto no bare metal do HP3 (Debian, sem hypervisor por baixo, sem snapshots, sem backups dignos do nome). Funcional, mas exatamente o tipo de setup “temporário” que vira em silêncio infraestrutura permanente da qual todo mundo depende. 😅
A correção: instalar o GitLab direito como VM (HP1-gitlab01, 192.168.10.x, 12 GB de RAM, 120 GB de disco) pelo pacote Omnibus padrão — o repositório apt oficial do GitLab, um pacote contendo o próprio GitLab, seu PostgreSQL, Redis e NGINX embutidos, configurado por um único /etc/gitlab/gitlab.rb. É o caminho de instalação chato e batido de propósito: é infraestrutura em que eu quero não pensar, não um projeto de ciência. Internamente é HTTP puro, ainda sem TLS na frente — tudo bem para uma instância só na LAN, embora isso tenha voltado para me morder mais tarde, quando o bootstrap do FluxCD se recusou a mandar credenciais por HTTP sem criptografia (história para outro post 👀).
A parte realmente interessante não foi a instalação nova — foi trazer os dados da instância antiga sem perder histórico. As próprias ferramentas de backup/restore do GitLab deram conta: um gitlab-backup create completo na antiga máquina bare metal, o arquivo resultante mais o arquivo de secrets da instância (gitlab-secrets.json) copiados, depois gitlab-backup restore na nova VM com uma versão do GitLab correspondente. Projetos, issues e — crucialmente — todas as branches de todos os repos, incluindo a branch internal deste projeto (a que guarda credenciais de verdade, nunca enviada ao espelho público no GitHub), chegaram intactos. Pedi ao Claude que percorresse a sequência inteira de exportar → transferir → importar → verificar e confirmasse que a instância migrada realmente batia com a antiga antes de o HP3 ser apagado. 🔍✅
Depois de verificado, o Debian bare metal do HP3 foi apagado por completo e reconstruído como terceiro nó Proxmox VE — ou seja, o GitLab não está só numa VM agora, está numa VM no mesmo cluster Proxmox que todo o resto, com snapshots e backups no PBS como qualquer outra carga. Chega da energia “tomara que a máquina bare metal não morra”. 🙏
🌱 Entra a Seed VM
Com o GitLab guardando a verdadeira fonte da verdade para Terraform e Ansible, a próxima lacuna era óbvia: de onde terraform apply e ansible-playbook realmente rodam? “Da máquina que tiver as ferramentas instaladas naquele dia” não é uma resposta, é um passivo de sobretudo.
Então: HP1-seed01 (192.168.10.x) — uma VM Ubuntu pequena e chata de 4 GB / 60 GB cujo único trabalho é ser o lugar de onde as mudanças de infraestrutura são feitas. Totalmente construída por um playbook Ansible (02_ansible/playbooks/seed01.yml), então dá para reconstruí-la do zero em minutos, e não “do jeito que eu lembrar de como configurei da última vez”. 🌱
O que vai parar nela:
- 🔧 git — sem versão fixa, sem motivo para frescura
- 🏗️ Terraform, fixado numa versão exata (
1.15.8) pelo repositório apt oficial da HashiCorp — mudanças de infraestrutura nunca deveriam pegar silenciosamente uma nova release do Terraform no meio de um apply - 📜 o próprio Ansible, para que a seed VM possa no futuro rodar playbooks contra o resto da frota, inclusive ela mesma
- ☸️ kubectl, fixado na versão minor do cluster RKE2 (atualmente acompanhando
v1.36) pelo repositório apt oficial do Kubernetes - ⎈ Helm, fixado numa release exata, baixado direto de
get.helm.sh
Dois detalhes legais que valem destaque. Primeiro, o playbook não só joga um binário kubectl solto e dá por encerrado — ele busca o kubeconfig ao vivo direto do primeiro nó de control plane do cluster, reescreve o endereço de loopback para o IP real desse nó e o instala para as contas ubuntu e user3. kubectl get nodes funciona no segundo em que o playbook termina, sem ficar copiando e colando kubeconfig por aí. Segundo: toda conta ganha um alias k para kubectl com bash completion completo — então k get pods completa com tab exatamente como kubectl get pods faria. Coisa pequena, economiza teclas para sempre. ⌨️
As versões em si moram num lugar só (group_vars/all.yml) — muda um número, roda o playbook de novo, e toda ferramenta é atualizada em sincronia com o que o cluster realmente precisa. Chega de momentos “pera, qual versão minor do kubectl eu estou rodando mesmo?”.
🧠 Por que isso importa mais do que parece
Nada disso é glamoroso. Ninguém escreve um post chamado “instalei o kubectl” esperando aplausos. Mas é a diferença entre um homelab que é um museu de passos manuais avulsos que eu vou ter esquecido em seis meses e um em que “reconstruir tudo a partir do Git” é uma afirmação real e testada, e não uma esperança. O GitLab agora é a verdadeira fonte da verdade; a Seed VM é o verdadeiro lugar de onde as mudanças são aplicadas. Duas VMs chatas, cada uma fazendo exatamente um trabalho, ambas totalmente reproduzíveis a partir de código. 📦 Em breve: ou o lado Kubernetes/FluxCD/Longhorn deste cluster, ou — se eu finalmente desvendar — o mistério em andamento do cliente Windows ingressado no domínio cuja Group Policy de escopo de usuário se recusa terminantemente a aplicar uma única GPO, apesar de o próprio Active Directory parecer perfeitamente saudável por todos os ângulos que testei. Fique ligado. 🕵️♂️
📚 Mais nesta série: Homelab Rebuild 2026
- Homelab Rebuild 2026 — De homelab a mini datacenter
- Homelab Rebuild 2026 — Construindo o cluster Proxmox e provisionando com Terraform
- Homelab Rebuild 2026 — Active Directory, lavagem no Pi-hole e uma letra de unidade que se recusa a existir
- Homelab Rebuild 2026: esperar para ver - um crash de servidor, um advisory sem saída e meu novo suspeito principal
