KVM con gestión web a través de Cockpit¶

En este artículo

• Funcionalidades de implementación
• Primeros pasos tras la implementación
• Acceso a la interfaz web de Cockpit
• Interfaz de Cockpit: Resumen de secciones
• Gestión del Sistema
• Creación e instalación de una VM invitada
• Comprobación y gestión básica de la VM
• Pedido de KVM con gestión web a través de Cockpit mediante la API

Funcionalidades de implementación¶

Rutas y archivos principales para KVM/Cockpit:

• Imágenes de VM y discos (almacenamiento por defecto): /var/lib/libvirt/images/
• Configuraciones de VM (libvirt): /etc/libvirt/qemu/
• Configuración de Socket y libvirtd: /etc/libvirt/libvirtd.conf, /var/run/libvirt/
• Configuración de Cockpit: /etc/cockpit/
• Certificados TLS de Cockpit (ws-certs): /etc/cockpit/ws-certs.d/
• Directorio Let's Encrypt para el FQDN de Cockpit: /etc/letsencrypt/live/<kvm_fqdn>/
• Logs de libvirt: journalctl -u libvirtd, /var/log/libvirt/
• Logs de Cockpit: journalctl -u cockpit -u cockpit.socket

Primeros pasos tras la implementación¶

Tras realizar el pago del pedido, se enviará una notificación de preparación del servidor a la dirección de correo electrónico proporcionada durante el registro. El correo contendrá la dirección IP del VPS/servidor, el usuario y contraseña de SSH, y un enlace al panel de gestión del servidor — Invapi.

Los clientes gestionan el equipo a través del panel de gestión del servidor y la API — Invapi. En la pestaña Configuration >> Tags para el servidor seleccionado, están disponibles los parámetros técnicos y los enlaces de servicio.

Los datos de autorización, que pueden encontrarse tanto en la pestaña Configuration >> Tags del panel de gestión del servidor como en el mensaje enviado por correo electrónico:

• Enlace para acceder a la interfaz web de Cockpit: en la etiqueta webpanel (puerto 9090, HTTPS)

Acceso a la interfaz web de Cockpit¶

Conexión al Panel¶

1. Abra un navegador en su máquina local (por ejemplo, Firefox en Ubuntu).
2. Navegue a una dirección como:
3. https://<IP_address>:9090 — cuando se accede por IP;
4. https://<kvm_fqdn>:9090 — cuando se accede por nombre de dominio desde la etiqueta webpanel.

Por defecto, Cockpit escucha en el puerto TCP 9090, que debe estar permitido en el firewall utilizado (UFW, firewalld, iptables, etc.).

Inicio de sesión y acceso administrativo¶

1. En la página de inicio de sesión, introduzca el nombre de usuario y la contraseña del servidor (normalmente la cuenta proporcionada en el correo electrónico o creada por el administrador).

1. Tras iniciar sesión, se abrirá la página de inicio de Cockpit con las métricas clave (carga de CPU, RAM, sistemas de archivos, tráfico de red).

Interfaz de Cockpit: Resumen de secciones¶

La interfaz de Cockpit tiene un menú de navegación simple y lógico a la izquierda. Cada sección gestiona un aspecto específico de la gestión del servidor y la virtualización.

Secciones del Sistema¶

Resumen (Panel de control)¶

La página principal del servidor ("Dashboard") muestra un resumen del estado del sistema:

• Health: Estado del sistema (errores, advertencias).
• Usage: Gráficos de uso de recursos en tiempo real (CPU, RAM, I/O de disco, Red).
• Información del sistema: Información del hardware, nombre de host, tiempo de actividad, versión del SO.
• Configuración: Acceso rápido para cambiar el nombre de host, la hora, unirse a un dominio y perfiles de rendimiento.

Registros¶

Interfaz para visualizar los logs del sistema (similar a journalctl):

• Permite filtrar los logs por fecha, severidad (Errors, Warnings, Notice) y servicios.
• Útil para diagnosticar errores de inicio de la VM o problemas de red sin utilizar la consola.

Almacenamiento¶

Gestión del subsistema de disco:

• Unidades: Lista de discos físicos. Puede crear tablas de particiones y formatear discos.
• Sistemas de archivos: Ver puntos de montaje y espacio utilizado.
• Montajes NFS: Conectar almacenamiento NFS remoto.
• Storage logs: Logs relacionados únicamente con el subsistema de disco.

Redes¶

Gestión de la interfaz de red del host:

• Interfaces: Lista de tarjetas de red. Aquí puede configurar direcciones IP (estáticas/DHCP), DNS y puertas de enlace.
  • Add Bridge / Add Bond / Add VLAN: Botones para crear puentes de red (Bridge), agregación de canales (Bonding) y VLAN. Esta es una sección críticamente importante para configurar la red de las máquinas virtuales (crear br0).
• Cortafuegos: Gestión básica de reglas del firewall (si firewalld está instalado).
• Registros de red: Logs de red.

Virtualización¶

Máquinas virtuales¶

Sección clave para gestionar el hipervisor KVM (requiere que el plugin cockpit-machines esté instalado).

• Lista de VM: Tabla de todas las máquinas virtuales con su estado (Running, Shut off) y características breves.
• Crear VM: Asistente para crear nuevas máquinas (subida de ISO, creación de disco).
• Vista de detalle de la VM: Al hacer clic en una máquina se abre su tarjeta con pestañas:
• Overview: Ajustes generales, inicio automático.
• Consola: Acceso a la pantalla de la VM (VNC/SPICE) directamente en el navegador.
• Discos: Añadir/eliminar discos virtuales.
• Interfaces de red: Vincular adaptadores de red a puentes o NAT.

Gestión del Sistema¶

Cuentas¶

Gestión de usuarios del servidor:

• Crear nuevos usuarios.
• Cambiar contraseñas, bloquear cuentas.
• Configurar claves SSH para los usuarios.
• Gestionar derechos de administrador (sudo).

Servicios¶

Capa gráfica sobre systemd:

• Services: Lista de todos los demonios (servicios). Puede iniciar, detener, reiniciar y habilitar/deshabilitar el inicio automático del servicio (por ejemplo, libvirtd, ssh, nginx).
• Targets / Sockets / Timers: Gestionar otras unidades de systemd.

Herramientas¶

Esta sección suele agrupar plugins adicionales.

• Aplicaciones: Gestor de aplicaciones de Cockpit (instalar módulos adicionales).
• Actualizaciones de software: Gestión de actualizaciones del sistema (análogo a apt update / dnf update). Muestra los parches de seguridad disponibles y permite instalarlos con un solo clic. Las actualizaciones automáticas pueden estar habilitadas.
• Terminal (Terminal)

Línea de comandos (shell) completa en el navegador:

• Proporciona acceso al servidor como el usuario actual.
• Permite ejecutar cualquier comando virsh, htop, vim, etc., si una interfaz gráfica es insuficiente.
• Funciona a través de websockets, admite copiar/pegar.

Creación e instalación de una VM invitada¶

Preparar la imagen ISO (Opcional)¶

Si planea utilizar su propia imagen ISO, súbela al servidor con antelación, por ejemplo, a /var/lib/libvirt/images/ o /tmp/. Si desea utilizar la descarga automática de distribuciones populares a través de Cockpit, puede omitir este paso.

Crear una nueva máquina virtual¶

1. En el menú izquierdo de Cockpit, vaya a la sección Máquinas virtuales.

2. Haga clic en el botón Create VM.

   

3. En el asistente que se abre, configure los parámetros:

4. Name: especifique un nombre único, por ejemplo, TestVM.
5. Installation Type: elija una de las opciones disponibles:
   • Download an OS: el método más sencillo. Seleccione un SO de la lista y Cockpit descargará la imagen necesaria.
   • Local install media: elija esta opción si ya ha subido su archivo ISO al servidor. En el campo que aparece, especifique la ruta del archivo (por ejemplo, /tmp/ubuntu-24.04.1-desktop-amd64.iso).
   • URL: permite especificar un enlace directo a una ISO para su descarga.
6. Operating System: al elegir Download an OS, la lista se completará automáticamente. Con una ISO local, el sistema intentará detectar el SO por sí mismo, o puede seleccionarlo manualmente de la lista.
7. Storage:
   • Size: especifique el tamaño del disco virtual (por ejemplo, 20 GiB). El disco se creará automáticamente.
8. Memory: especifique la cantidad de RAM a asignar (por ejemplo, 4 GiB).

9. Immediately start VM: deje marcada la casilla si desea iniciar la instalación inmediatamente, o desmárquela si necesita cambiar ajustes (por ejemplo, red) antes de comenzar.

10. Si se requieren ajustes adicionales (por ejemplo, seleccionar un puente de red), desmarque Immediately start VM y haga clic en Create.

Configuración adicional antes de la instalación¶

Si eligió crear sin inicio inmediato, se abrirá una página de la VM. Vaya a la pestaña Interfaces de red:

1. Asegúrese de que el campo Source esté configurado en:
2. o bien la interfaz puente br0, si la VM debe recibir una IP de la misma red que el host (recomendado para accesibilidad externa);
3. o bien la red NAT estándar defaultvirbr0, si es suficiente con el acceso a Internet de la VM sin visibilidad externa directa.
4. Haga clic en Add para iniciar la VM y comenzar la instalación.

Proceso de instalación en la Consola de la VM¶

1. En la lista de máquinas virtuales, seleccione la TestVM creada.
2. Haga clic en el botón Install.
3. Verá la pantalla de instalación del SO en la pestaña Consola. Siga las instrucciones del instalador (selección de idioma, particionado de disco, creación de usuario).

Una vez completada la instalación, la máquina virtual se reiniciará y estará lista para su uso.

Comprobación y gestión básica de la VM¶

Primer inicio y prueba de red¶

1. Asegúrese de que TestVM esté en estado Running.
2. Abra la consola de la VM en Cockpit e inicie sesión con el usuario creado durante la instalación.
3. Dentro del SO invitado, abra una terminal y compruebe la configuración de red:

ip addr

• Al usar el puente br0, la VM debería obtener una IP de su red física, por ejemplo, 192.168.0.x.

• Al usar la red NAT default, la dirección será típicamente de la red interna, por ejemplo, 192.168.122.x.

• Compruebe la conectividad a Internet:

ping 8.8.8.8

Operaciones diarias de la VM en Cockpit¶

Las acciones básicas están disponibles en la tarjeta de cada máquina virtual:

• Run — inicia una VM detenida.
• Shut Down — apaga el SO invitado de forma controlada (señal ACPI).
• Force shut down — apagado forzado (corte de energía).
• Reboot — reinicia la VM.
• Delete — elimina la VM (con la opción de eliminar los discos virtuales asociados).

A través de las pestañas Disks y Network Interfaces puede añadir dispositivos adicionales.

Pedido de KVM con gestión web a través de Cockpit mediante la API¶

Para instalar este software utilizando la API, siga estas instrucciones.