Meu primeiro cluster Kubernetes no homelab

Ilustração: um homem no leme de uma nave espacial com circuitos verdes brilhantes; uma segunda figura está desfocada

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

Hoje montei um cluster Kubernetes no meu homelab – abreviado K8s 😁.

Já tive algum contato profissional com Kubernetes, mas eu queria rodar uma instalação do Nextcloud dentro do Kubernetes para testes no meu homelab 🌐. Além disso, queria dedicar um tempo pessoal para me aprofundar nessa tecnologia 💻. Kubernetes e Docker em geral são inegavelmente tecnologia do futuro 🚀. A ideia de buscar a certificação CKAD (Certified Kubernetes Application Developer) também me atrai muito, e encontrei este curso na Udemy para começar: Curso de CKAD na Udemy 🎓.


Índice

🤔 Afinal, o que é Kubernetes?

Em resumo, Kubernetes é uma plataforma open source para automatizar o deploy, o escalonamento e o gerenciamento de aplicações em contêineres. Ele permite que as aplicações rodem de forma consistente em vários servidores, usando os recursos de forma eficiente ⚡. Principais vantagens? Escalabilidade, tolerância a falhas e gerenciamento simplificado de sistemas complexos 😎.

Curiosidade: o Kubernetes foi desenvolvido originalmente pelo Google e chamado internamente de Borg 👾.

O logo do Kubernetes é um timão de navio ⚓, simbolizando o controle de paisagens complexas de contêineres. Curiosamente, ele tem exatamente sete raios – uma referência à personagem Seven of Nine do universo Borg 👽. Esse pequeno easter egg inspirou a imagem destacada deste post 🎨.


🛠️ Meu setup

Hoje gerei rapidinho um playbook Ansible com o Claude.AI 🤖 que instalou um cluster Kubernetes em 6 VMs no meu homelab 🏠. Em cada um dos 3 servidores físicos agora rodo 2 VMs – um Master e um Worker. Isso serve como configuração inicial do cluster, e no futuro talvez eu adicione mais nós Worker para tarefas dedicadas, por exemplo storage com Longhorn 🗄️.

Observação: link para download do playbook: aqui ⬇️ Licença MIT, sem garantia – revise você mesmo antes de usar.

( Não estou totalmente satisfeito com essa abordagem – o ideal seria um repositório Git aberto 🐙, mas ainda não configurei isso 😅. )


⚠️ Primeiros tropeços

Antes de o cluster rodar redondo, esbarrei em alguns problemas 🤯:

  • No início, aloquei só 1 núcleo de CPU para o nó master no Proxmox – o Kubernetes na verdade precisa de vários núcleos 🧠.
  • O Ansible instalou o iptables só no master, não nos nós worker, o que impediu a pilha de rede de subir direito 🌐❌.

Depois de corrigir isso, o cluster subiu 🟢 e pude começar a fazer deploy de pods 🐳.

Execução do playbook Ansible fazendo o deploy do cluster Kubernetes

Saída do kubectl get nodes mostrando os nós do cluster do homelab como Ready

Saída do kubectl com os pods kube-system em execução


🔮 Próximos passos

Em seguida, pretendo fazer o deploy do Nextcloud dentro do Kubernetes e testar como storage, backups e atualizações se comportam num ambiente em cluster 💾. É um jeito prático de aprender Kubernetes, Docker e gerenciamento de rede num homelab 🖥️ – sem arriscar sistemas de produção 🚫⚡.


📝 Observação: a nave estelar e o tripulante na imagem destacada estão desfocados de propósito – eles pertencem a uma certa franquia. Resistir é inútil, desfocar não.

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