URLs y accesos de los productos¶

Dónde está cada herramienta del HomeLab, cómo se entra y con qué credenciales. Todas las direcciones *.homelab.local solo resuelven dentro de la LAN, porque las sirve el DNS (sistema de nombres de dominio) del propio HomeLab: BIND en deborah, 192.168.20.5. Si tu equipo no usa ese DNS, agrega las entradas a tu archivo hosts (ver Resumen del HomeLab).

Accesos principales

Argo CD

GitOps · inicio de sesión con GitHub

argocd.homelab.local

Incus UI

Instancias, redes y balanceadores · SSO o TLS

incus.homelab.local:8443

Longhorn Por túnel

Almacenamiento replicado · sin login

kubectl port-forward → 127.0.0.1:8080

Documentación

Esta guía

homelab.symintelligent.com

Resumen¶

Producto	Dirección	Acceso
Argo CD (GitOps)	`https://argocd.homelab.local`	GitHub, con SSO (inicio de sesión único) a través de Dex
Dex (SSO)	`https://argocd.homelab.local/api/dex` (emisor OIDC)	Sin interfaz propia: lo usan Argo CD, Incus UI y vCluster
Incus UI	`https://incus.homelab.local:8443/ui/`	SSO (GitHub, vía Dex) o certificado TLS
SSH a los servidores	`ssh devops@<servidor>.homelab.local` (`invincible`, `oliver`, `deborah`)	Identidad de GitHub vía Dex, con `opkssh`: Entrar por SSH a los servidores
Longhorn UI	No está publicada: `kubectl port-forward` y `http://127.0.0.1:8080`	Sin login
vCluster Platform	`https://vcluster.homelab.local`	SSO (vía Dex). Se activa en la Fase 5; sin ella la URL responde 404
Documentación	`https://homelab.symintelligent.com`	Pública
API de Kubernetes	`https://192.168.20.5:6443` (`deborah`)	`kubeconfig`
Gateway (Kong)	`192.168.23.200`	— (recibe el tráfico de `argocd`, `vcluster` y `api`)
DNS (BIND)	`192.168.20.5`	— (zonas `homelab.local` y `mco.local`)

Cada nombre tiene su registro en BIND

La zona homelab.local apunta argocd, vcluster y api a la IP del Gateway (192.168.23.200), incus al líder del clúster (invincible, 192.168.20.6) y cada servidor (invincible, oliver, deborah) a su propia IP. No hay comodín: un nombre nuevo no resuelve hasta que se añade su registro. Solo existe la ruta de Argo CD; por eso vcluster.homelab.local resuelve pero responde 404.

Argo CD¶

La interfaz de GitOps. Pide iniciar sesión con GitHub (Dex); solo entran los miembros del team devops de la organización symintel.

Ver captura: inicio de sesión de Argo CD

Pantalla de inicio de sesión de Argo CD con el botón «Log in via GitHub»

Dentro, la aplicación raíz homelab-root agrupa todas las demás (vista de árbol):

Ver captura: árbol de homelab-root

Árbol de la aplicación homelab-root en Argo CD, con las aplicaciones arc-controller, arc-runners, argocd y argocd-route sincronizadas y sanas

Más sobre el catálogo y los problemas frecuentes: GitOps — catálogo y troubleshooting.

Incus UI¶

La interfaz web del clúster de Incus. Está en el nodo invincible (el líder), puerto 8443; cada nodo expone además su propia API en ese puerto. Ofrece dos formas de entrar:

Ver captura: acceso a Incus UI

Pantalla de acceso de Incus UI con las opciones «Login with SSO» y «Login with TLS»

Login with SSO: GitHub a través de Dex (OIDC, estándar de inicio de sesión). Ver Clúster Incus — OIDC vía Dex.
Login with TLS: con un certificado de cliente instalado en el navegador.

Los balanceadores de red están en Networks → ovn-lan → pestaña «Load balancers» (ver Balanceo de carga y OVN).

Longhorn UI¶

El almacenamiento replicado tiene su propio panel, sin pantalla de login y sin ruta en el Gateway: es un Service interno. Se abre con un túnel temporal desde tu equipo:

export KUBECONFIG=~/.kube/homelab-k3s.yaml
kubectl -n longhorn-system port-forward svc/longhorn-frontend 8080:80
# y abre http://127.0.0.1:8080  (Ctrl+C para cerrar el túnel)

Ver captura: panel de Longhorn

Panel de Longhorn v1.13.0 con 1 volumen, 471 Gi de almacenamiento programable y 3 nodos

Más sobre las clases de almacenamiento: Storage.

vCluster Platform¶

Su dirección es https://vcluster.homelab.local, pero no se despliega por defecto: su Application está comentada en gitops/bootstrap/root-appset.yaml y no hay HTTPRoute, así que hasta activarla en la Fase 5 la URL responde 404.

Sin interfaz propia¶

Estas piezas no tienen UI; se revisan con kubectl o con Argo CD:

Producto	Cómo mirarlo
MetalLB (IP de los `LoadBalancer`)	`kubectl get ipaddresspool,l2advertisement -n metallb-system`; pool `192.168.23.200–.220`
Calico (red de los pods)	`kubectl get tigerastatus` y `kubectl get installation default`
Kong (Gateway)	`kubectl get gateway,httproute -A`
cert-manager (certificados)	`kubectl get clusterissuer,certificate -A`
OVN (red virtual de Incus)	`incus network list` y `ovn-nbctl lb-list` en un nodo
ARC (runners de GitHub Actions)	`kubectl get pods -n arc-runners`

Otros enlaces¶

Qué	Dónde
Código (Ansible, OpenTofu, documentación)	`symintel/homelab`
Manifiestos GitOps	`symintel/gitops`
Pipelines reutilizables	`symintel/core-pipelines`
Documentación completa en texto plano (para IA)	`llms-full.txt`
Cuaderno de estudio con IA	Aprende con IA

Comprobar que responden¶

for u in https://argocd.homelab.local/ https://incus.homelab.local:8443/ui/; do
  echo "$u -> $(curl -sk -o /dev/null -w '%{http_code}' --max-time 6 $u)"
done
dig @192.168.20.5 argocd.homelab.local +short     # debe dar 192.168.23.200

Si una URL no abre, empieza por el DNS (dig) y por el Gateway (curl -k https://192.168.23.200); la tabla de resolución de problemas de GitOps cubre los casos más comunes.