Sobre o projeto

Homelab-Ops é uma arquitetura de referência documentada para executar uma plataforma Kubernetes auto-hospedada em um único mini PC Intel i5 (16GB de RAM, 256GB NVMe, 1TB SATA) sob Proxmox VE 8, com recursos de nuvem de suporte na Oracle Cloud Infrastructure e no Google Cloud Platform. Principais capacidades descritas no README: - Rede: túneis Anycast do Cloudflare Zero Trust (cloudflared) fornecem ingress QUIC somente de saída, evitando encaminhamento de portas atrás de CGNAT; o Traefik lida com o roteamento dentro do cluster. Uma malha efêmera do Tailscale é usada para acesso administrativo e runners de CI. - Entrega GitOps: Flux CD v2 com Kustomize reconcilia as camadas de plataforma e de aplicações a partir do Git, com dependências ordenadas (plataforma antes das aplicações). Mozilla SOPS com Age criptografa segredos no Git, descriptografados dentro do cluster. - Armazenamento e dados: armazenamento em dois níveis separa o NVMe para o SO, o estado do K3s e o PostgreSQL de um disco SATA de 1TB para documentos e mídia. O operador CloudNativePG gerencia o ciclo de vida do PostgreSQL, failover e arquivamento de WAL. - Resiliência: uma VM independente na OCI executa o Uptime Kuma para verificações de integridade fora de banda; o estado do Terraform é armazenado no object storage da OCI com bloqueio remoto; backups Restic criptografados noturnos seguem a regra 3-2-1. - Frota de aplicações: cloudflared, CloudNativePG, Homepage, Prometheus/Grafana, kwatch, documentação MkDocs, n8n, um microsserviço gerador de PDF, Paperless-ngx, BookOrbit, Audiobookshelf, Miniflux, Linkding e Ryot/wger. - Documentação: 16 ADRs, sete manuais de fases de execução e guias de engenharia cobrindo configuração e recuperação do Proxmox, modularização do Terraform, hidratação de segredos, otimização do K3s e depuração de WAN. O repositório é principalmente um projeto de infraestrutura como código e documentação (Terraform, Ansible, manifestos Kubernetes) em vez de uma aplicação empacotada. É adequado para engenheiros de plataforma e operadores de homelab que buscam um exemplo prático de GitOps, ingress zero-trust e resiliência em nuvem híbrida em hardware limitado.