Topología de red

La vista de topología es un grafo de estado deseado editable superpuesto con el estado libvirt descubierto en runtime. Mantener esas dos capas distintas evita confundir una tarjeta en el lienzo con infraestructura desplegada.

Modelo de grafo

Element	Desired state	Runtime evidence
VM node	Name, resources, disks, boot variant, position	Domain ID/name, power state, interfaces, deployment result
Network node	Logical name, type, subnet, position	Libvirt network name, bridge, active state, DHCP state
Edge	Intended VM-to-network attachment	Interface/MAC attached to the expected runtime network

Los nodos pueden estar planned, provisioning, running, stopped o failed. Usa el estado en texto y detalles de despliegue; el color es una pista secundaria y puede cambiar con el tema de la UI.

Opciones de red

Las redes NAT proporcionan salida guest mediante una red libvirt gestionada cuando el host y la política lo permiten.
Las redes aisladas proporcionan conectividad VM a VM sin ruta externa.
Comportamiento adicional de bridge o internet directo es específico del operador y despliegue; no se infiere por dibujar un borde.

Para direccionamiento estático, la subred autorada, gateway, direcciones reservadas, rango DHCP, reservas MAC y configuración del guest deben coincidir. Un borde del grafo solo no configura una dirección dentro de un guest arbitrario.

Edición y despliegue

Selecciona el alcance correcto de proyecto/compilación antes de editar.
Añade nodos VM y red y conecta sus handles.
Selecciona imagen de arranque y recursos para cada VM.
Guarda la topología y confirma que la revisión del servidor avanza.
Despliega nodos y espera datos de overlay en runtime.
Verifica cada borde deseado contra las interfaces reales de la VM.

La topología de proyecto se persiste en el servidor con comprobaciones de revisión. La UI también usa cachés locales y guardados con debounce; espera a que termine el guardado antes de cambiar de alcance o cerrar la página. Un error de guardado significa que el lienzo aún no es durable.

Ejemplo de comprobaciones de aceptación

Para una topología cliente/API:


client -- isolated-lan -- api
                     \
                      nat-egress (only if required)

Verifica todo lo siguiente:

ambos dominios existen y están en ejecución;
ambos tienen una interfaz en la misma red aislada en runtime;
resolución nombre/dirección mapea api al guest previsto;
una aserción http_responds del lado cliente alcanza el endpoint de salud de la API;
la red aislada no tiene ruta externa no intencionada;
cualquier borde NAT existe solo donde la receta exige salida.

Refresco y exportación

El estado en runtime se refresca desde el inventario del backend y puede retrasarse brevemente tras una solicitud de ciclo de vida. Refresca manualmente al validar una transición. Algunas vistas de topología exponen exportación JSON para documentación; un grafo exportado es dato de estado deseado, no copia de seguridad de discos VM ni prueba de que el runtime coincidió.

Consulta Crear VM y Aserciones personalizadas.