homelab

Proxmox + k3s + GitOps · Documentación de referencia del homelab: hardware, red y servicios, todo como código.

⚡ en vivo 3 nodos k3s · Argo CD

Qué es

Documentación de referencia de toda la infraestructura del homelab: el hardware (NUC Proxmox y NAS), la red (UniFi), el cluster Kubernetes (k3s) gestionado por GitOps y el catálogo de servicios que corre encima. Todo se define como código: las VMs con Terraform (IaC) y las aplicaciones con Argo CD (GitOps).

Secciones

🧭 Arquitectura

Visión general, capas y aislamiento de Proxmox.

🖥️ Hardware

NUC "Luka" y nodos k3s (kobe/kyrie/kawhi).

🕸️ Red

LAN 192.168.20.x, MetalLB, Traefik y Cloudflare.

📦 Servicios

Catálogo de servicios.

🔧 Runbooks

Procedimientos de mantenimiento.

⚖️ Decisiones

ADRs: stack, RAM, docs y secretos.

Estado

Infraestructura bootstrapada y operativa: cluster k3s de 3 nodos (VLAN 20), MetalLB (L2), Traefik v3 + Gateway API, Argo CD, Sealed Secrets, cert-manager, Longhorn, CloudNativePG, Kured, ARC (runners self-hosted), Ansible CI (plan/apply), observabilidad (kube-prometheus-stack, Loki, Alloy, grafana-operator) y Cloudflare como IaC. Argo CD en https://argocd.local.gorkarevilla.com. Primeras aplicaciones: pgAdmin, Vaultwarden (https://passwords.gorkarevilla.com), Homepage (https://homepage.gorkarevilla.com) y Authentik (https://auth.gorkarevilla.com).

Repositorio

gorkarevilla/homelab