Saltar a contenido

ADR-007: Dominio interno .sc sin sufijo de nodo

Fecha: 2026-05-12 Estado: aceptado

Decisión: Todos los servicios internos de SmallCountry usarán el dominio .sc sin sufijo de nodo (.sc.ra, .sc.horus). El sufijo de nodo solo se usará en contextos de administración donde sea necesario distinguir físicamente entre máquinas (SSH, Proxmox UI, IPMI, métricas por nodo).

Contexto: El diseño inicial usaba .sc.ra en las fichas de servicio y roles, atando cada URL al nodo Ra. Esto crea un problema de acoplamiento: si un servicio migra de Ra a Horus, todas las URLs que usan los usuarios se rompen. Los principios inmutables ya usan .sc consistentemente (docs.sc), pero el resto de la documentación no se actualizó, generando una inconsistencia entre la doctrina y la implementación documentada.

Alternativas consideradas:

Alternativa Ventaja Por qué se descartó
.sc.<nodo> (actual) Identifica el nodo inmediatamente Acopla servicios al hardware; migrar un LXC rompe todas las URLs de usuario
.sc.<nodo> automático Transparencia de ubicación Requiere lógica adicional en DNS/proxy para enrutar; añade complejidad innecesaria
.sc sin sufijo Movilidad total entre nodos No indica ubicación física, pero eso no es relevante para usuarios

Consecuencias:

✅ Los servicios pueden migrar entre nodos sin que los usuarios cambien de URL
✅ Las URLs son más cortas y memorables (inicio.sc vs inicio.sc.ra)
✅ Consistencia con los principios (ya usan .sc)
✅ Pi-hole resuelve servicio.sc a la IP correcta independientemente del nodo donde esté alojado
❌ Para administración, hay que recordar en qué nodo está cada servicio
→ Mitigación: el inventario de servicios documenta nodo + LXC para cada servicio
❌ Requiere reescribir ~255 referencias en 60 archivos
→ Se ejecutó como reemplazo masivo al aprobar este ADR

Referencias:

← Índice de ADRs