Homelab Infrastructure

Infraestrutura de homelab distribuída entre ambiente local (Proxmox) e Oracle Cloud, automatizada com Terraform e Ansible.

Arquitetura

Local (Proxmox VE)

• DNS/DHCP VM (Technitium)
• Gaming VM (PufferPanel)
• Rede: 192.168.100.0/24

Oracle Cloud (Free Tier)

• Tailscale Exit Node (Oracle Linux)
• Ubuntu Server ARM (4 vCPU / 24GB RAM)
• Rede: 10.0.0.0/16

Toda comunicação entre ambientes via Tailscale VPN.

📖 Diagrama completo e detalhes

Hardware Local

HP Elite Mini G9

• CPU: Intel Core i5-12500
• RAM: 40GB (32GB + 8GB)
• Storage: 256GB SSD
• Network: Ethernet Gigabit
• OS: Proxmox VE 8.x

Ferramentas

• Terraform 1.5+ - Provisionamento de infraestrutura
• Ansible 2.18+ - Gerenciamento de configuração
• Proxmox VE - Virtualização local
• Oracle Cloud (Free Tier) - Compute cloud
• Tailscale - VPN mesh network

Pré-requisitos

• Proxmox VE configurado
• Terraform e Ansible instalados
• Chaves SSH configuradas
• (Opcional) Oracle Cloud Account
• (Opcional) Tailscale Account

Quick Start

# 1. Instalar dependências
make setup

# 2. Configurar Terraform
cd terraform/local
cp terraform.tfvars.example terraform.tfvars
vim terraform.tfvars

# 3. Deploy
make local-init
make local-apply
make local-deploy

📖 Guia completo

Comandos

make help           # Ver todos os comandos
make status         # Status da infraestrutura

# Local
make local-apply    # Deploy infraestrutura
make local-deploy   # Configurar serviços

# Oracle Cloud
make oracle-apply   # Deploy infraestrutura
make oracle-deploy  # Configurar serviços

Recursos

Local (Proxmox)

• DNS VM: 192.168.100.200 - Technitium UI
• Gaming VM: 192.168.100.201 - PufferPanel

Oracle Cloud

• Exit Node (Oracle Linux)

AWS

• Route53: DNS público para serviços
• S3: Backend remoto do Terraform (state)

Documentação

• Arquitetura - Diagrama e componentes
• Quick Start - Guia de deploy rápido
• Terraform - Infraestrutura como código
  • Backend S3 - State remoto
  • AWS Route53 - DNS público
• Ansible - Playbooks e configuração
• Nginx Reverse Proxy - Proxy reverso

Licença

MIT License

---

Mantido por: Gabriel Rocha