Red e inventario

Horizon conoce cada dirección de cada red, los nombres que apuntan a ella, el dispositivo que la usa y el stack que la tiene reservada. Todo se lee libremente; cambiarlo requiere el rol operator.

Red

Network muestra el mapa de una red, un bloque /24 cada vez, con una casilla por dirección. Cada casilla indica su tipo y color, su nombre y unas marcas de lo que hay en ella: un dispositivo, un stack, un servidor de Horizon, un dispositivo que comparte carpetas, una nota o un bloqueo. Una tarjeta resume la red (CIDR, gateway, pool DHCP, dominios y ocupación) y una leyenda permite filtrar por tipo.

Al abrir una dirección se ve todo lo que Horizon sabe de ella: IP y tipo, MAC, nombres, el stack que la reserva, el dispositivo y servidores que hay en ella, las notas y el estado de su publicación en cada Pi-hole.

Nombres

Una dirección tiene un nombre principal (un subdominio de uno de los dominios de la red) y cualquier número de alias.

• El nombre principal se publica en los Pi-hole del dominio como host y como reserva DHCP según su MAC. Por eso, al dar nombre a una dirección también se pide su MAC (con un botón para generar una).
• Cada alias es un CNAME hacia el nombre principal: un subdominio del propio nombre (test.hori28.dev.horizon.moon.cat), del dominio, o cualquier hostname.
• Cada nombre llega a los Pi-hole antes de guardarse: si un Pi-hole lo rechaza, no queda nada a medias.

información

Esto sustituye la gestión manual de IPs y DNS en Pi-hole: crear el registro en Horizon es lo que hace que una VM nueva reciba su IP por DHCP y resuelva por nombre.

Reservas

Una dirección con nombre pasa por tres estados:

Estado	Cuándo
available	Libre para cualquier stack
reserved	Asignada a un stack, aunque sea un borrador
in use	Su stack está desplegado

Una dirección reservada o en uso no se puede borrar, y el aviso indica qué stack la tiene. Eliminar el stack la libera. Las direcciones con un tipo que bloquea la asignación, el gateway, el broadcast y el pool DHCP nunca se ofrecen a un stack.

Anotaciones

Una dirección se puede marcar con un tipo, un nombre y notas en Markdown. Con Ctrl/⌘-click y Shift-click se seleccionan varias para editarlas juntas. Clear borra todo lo guardado en una dirección (anotación, MAC y nombres, retirándolos primero de Pi-hole) siempre que nada la use.

Inventario

Inventory lista cada dispositivo de la red: servidores físicos, virtuales, NAS, routers, ... Cada uno tiene categoría, estado, entorno, etiquetas, CPU, memoria y discos, y se puede filtrar por cualquiera de ellos.

• Cada dispositivo pertenece a una red y se alcanza mediante una dirección: un registro con nombre que enlaza, o su propia IP y MAC.
• Guarda su sistema operativo, CPU, núcleos, memoria, discos y cualquier otra pieza (GPU, tarjetas de red, ...), además de fabricante, modelo, fecha y precio de compra, un logo y adjuntos (enlaces a manuales, facturas o runbooks).
• Un dispositivo puede indicar en qué otro se ejecuta (Runs on), de forma que un host lista lo que corre en él.

Dispositivos de stacks

Cada VM de un stack crea (o enlaza) su propio dispositivo, del tipo Virtual server, que se ejecuta en el dispositivo de su servidor Proxmox. Mientras el stack la mantenga, su red, dirección, entorno, sistema operativo y hardware los define el stack y aparecen bloqueados. Al eliminar el stack el dispositivo se mantiene y vuelve a ser editable.

Hosts de Proxmox

Un servidor Proxmox entra en el inventario al registrarse. Su dispositivo muestra además los datos que reporta el nodo (CPU, sockets, núcleos, memoria, versiones de Proxmox y kernel), que se actualizan con Refresh facts.

Carpetas compartidas

Shared folders documenta lo que los dispositivos publican: el nombre, el dispositivo que la sirve, su ruta, su tipo (NFS, SMB, S3, ...), etiquetas y notas. Horizon no cambia nada en el servidor; es un registro.

• Acceso: la lista de direcciones que pueden usarla, cada una en solo lectura o lectura y escritura. Una carpeta también puede ser pública en uno de los dos modos.
• Montajes: qué dispositivo la monta y dónde. Solo se puede montar desde una dirección con acceso.
• Stacks: una plantilla puede pedir una carpeta (por ejemplo, el NFS de las copias de seguridad). El formulario solo ofrece las carpetas a las que la dirección de la VM tiene acceso en el modo necesario, y al terminar registra el montaje en el dispositivo de la VM.

consejo

Antes de desplegar algo que guarda copias de seguridad (como PostgreSQL), da acceso de escritura a la dirección de la VM en la carpeta NFS. Si no, Horizon no la ofrecerá.

Para que un dispositivo pueda publicar carpetas, se activa la opción shares folders en su ficha.