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

En este artículo

• Funcionalidades de implementación
• Primeros pasos después del despliegue
• Acceso a la interfaz web de Cockpit
• Interfaz de Cockpit: descripción general de las secciones
• Gestión del sistema
• Creación e instalación de VM invitada
• Verificación y gestión básica de 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 y discos de VM (almacenamiento predeterminado): /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 de Let's Encrypt para FQDN de Cockpit: /etc/letsencrypt/live/<kvm_fqdn>/
• Registros de libvirt: journalctl -u libvirtd, /var/log/libvirt/
• Registros de Cockpit: journalctl -u cockpit -u cockpit.socket

Primeros pasos después del despliegue¶

Tras pagar el pedido, se enviará una notificación de que el servidor está listo a la dirección de correo electrónico proporcionada durante el registro. El correo electrónico contendrá la dirección IP del VPS/servidor, el inicio de sesión y la 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 del servidor seleccionado, están disponibles los parámetros técnicos y los enlaces del servicio.

Los datos de autorización, que se pueden encontrar ya sea en la pestaña Configuration >> Tags del panel de gestión del servidor o 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 — al acceder por IP;
4. https://<kvm_fqdn>:9090 — al acceder por nombre de dominio desde la etiqueta webpanel.

De forma predeterminada, Cockpit escucha en el puerto TCP 9090, que debe estar permitido en el firewall en uso (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 abre 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: descripción general de las secciones¶

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

Secciones del sistema¶

Overview (Panel de control)¶

La página principal del servidor ("Panel de control") 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, E/S de disco, red).
• System information: Información del hardware, nombre del host, tiempo de actividad, versión del SO.
• Configuration: Acceso rápido para cambiar el nombre del host, la hora, unirse a un dominio y los perfiles de rendimiento.

Logs¶

Interfaz para ver los registros del sistema (similar a journalctl):

• Permite filtrar registros por fecha, gravedad (Errores, Advertencias, Aviso) y servicios.
• Útil para diagnosticar errores de inicio de VM o problemas de red sin usar la consola.

Storage¶

Gestión del subsistema de discos:

• Drives: Lista de discos físicos. Puede crear tablas de particiones y formatear discos.
• Filesystems: Ver puntos de montaje y espacio utilizado.
• NFS mounts: Conectar almacenamiento NFS remoto.
• Storage logs: Registros relacionados únicamente con el subsistema de discos.

Networking¶

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).
• Firewall: Gestión básica de reglas de firewall (si firewalld está instalado).
• Network logs: Registros de red.

Virtualización¶

Virtual Machines¶

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

• VM List: Tabla de todas las máquinas virtuales con su estado (Running, Shut off) y características breves.
• Create VM: Asistente para crear nuevas máquinas (carga de ISO, creación de disco).
• VM Detail view: Al hacer clic en una máquina, se abre su tarjeta con pestañas:
• Overview: Configuración general, inicio automático.
• Console: Acceso a la pantalla de la VM (VNC/SPICE) directamente en el navegador.
• Disks: Añadir/eliminar discos virtuales.
• Network Interfaces: Vincular adaptadores de red a puentes o NAT.

Gestión del sistema¶

Accounts¶

Gestión de usuarios del servidor:

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

Services¶

Capa gráfica sobre systemd:

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

Tools¶

Esta sección suele agrupar plugins adicionales.

• Applications: Gestor de aplicaciones de Cockpit (instalar módulos adicionales).
• Software Updates: 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 completa (shell) en el navegador:

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

Creación e instalación de VM invitada¶

Preparación de la imagen ISO (opcional)¶

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

Creación de una nueva máquina virtual¶

1. En el menú izquierdo de Cockpit, vaya a la sección Virtual Machines.

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

   

3. En el asistente que se abre, establezca 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 requerida.
   • Local install media: elija esta opción si ya ha cargado su archivo ISO en el servidor. En el campo que aparece, especifique la ruta al archivo (por ejemplo, /tmp/ubuntu-24.04.1-desktop-amd64.iso).
   • URL: permite especificar un enlace directo a un ISO para descargar.
6. Operating System: al elegir Download an OS, la lista se rellenará automáticamente. Con un ISO local, el sistema intentará detectar el SO automáticamente, 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 la marca de verificación si desea iniciar la instalación inmediatamente, o desmárquela si necesita cambiar la configuración (por ejemplo, la red) antes de iniciar.

10. Si se requieren configuraciones 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 VM. Vaya a la pestaña Network Interfaces:

1. Asegúrese de que el campo Source esté configurado en:
2. la interfaz de puente br0, si la VM debe obtener una IP de la misma red que el host (recomendado para accesibilidad externa);
3. o la red NAT estándar defaultvirbr0, si el acceso a Internet de la VM sin visibilidad externa directa es suficiente.
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 Console. Siga las instrucciones del instalador (selección de idioma, particionado de disco, creación de usuario).

Tras completar la instalación, la máquina virtual se reiniciará y estará lista para usar.

Verificación y gestión básica de VM¶

Primer inicio y prueba de red¶

1. Asegúrese de que TestVM esté en el 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 verifique la configuración de red:

ip addr

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

• Al usar la red NAT default, la dirección suele ser de la red interna, por ejemplo, 192.168.122.x.

• Verifique la conectividad a Internet:

ping 8.8.8.8

Operaciones diarias de VM en Cockpit¶

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

• Run — iniciar una VM detenida.
• Shut Down — apagar correctamente el SO invitado (señal ACPI).
• Force shut down — apagado forzado (apagado).
• Reboot — reiniciar la VM.
• Delete — eliminar 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 mediante la API, siga estas instrucciones.

Parte del contenido de esta página fue creado o traducido con IA.