Administrar invitados KVM con virsh: listar, iniciar, shutdown frente a destroy, y autostart

Objetivo

Inspeccionar, iniciar, detener y configurar el autostart de invitados KVM gestionados por libvirt, usando virsh, sin corromper la definición persistente del dominio.

Requisitos previos

Root o pertenencia al grupo libvirt en el host hipervisor; el servicio libvirtd (o virtqemud, activado por socket) en ejecución. Ejecutado como root, virsh se conecta a qemu:///system; ejecutado como un usuario ordinario, usa por defecto el qemu:///session privado de ese usuario (a menos que LIBVIRT_DEFAULT_URI o la configuración del cliente indiquen otra cosa), que no muestra los invitados del sistema. Pasar -c qemu:///system explícitamente y confirmar con virsh uri.

Pasos

1. Listar invitados: virsh list --all muestra todos los dominios definidos y su estado (running, shut off, paused). virsh list solo, muestra únicamente los que están en ejecución.
2. Inspeccionar un invitado: virsh dominfo <name> imprime el estado, el número de CPU, la memoria, el indicador de autostart y la persistencia. virsh domstate <name> imprime solo el estado.
3. Iniciar un invitado definido pero detenido: virsh start <name>.
4. Detención ordenada: virsh shutdown <name> pide al sistema operativo invitado que se apague y retorna de inmediato; el éxito no está garantizado y puede tardar un tiempo variable. Con QEMU, el hipervisor elige el método (normalmente un evento de botón de encendido ACPI, que el sistema operativo invitado debe manejar); --mode agent usa en su lugar el agente invitado de QEMU, si hay uno ejecutándose en el invitado. Sondear virsh domstate <name> hasta que informe shut off.
5. Detención forzosa: virsh destroy <name> termina el dominio de inmediato sin dar al sistema operativo invitado ninguna oportunidad de reaccionar, equivalente a desconectar el cable de alimentación; las escrituras del invitado no volcadas pueden perderse. Usarlo solo cuando shutdown no se completa en una espera razonable. No elimina ningún disco, y un dominio persistente puede volver a iniciarse; un dominio transitorio desaparece al detenerse, junto con los metadatos de sus instantáneas.
6. Habilitar o deshabilitar el inicio en el arranque de un dominio persistente: virsh autostart <name> (libvirt inicia el invitado cuando arranca el host) y virsh autostart --disable <name> para quitarlo.
7. Acceso a consola: virsh console <name> se conecta a una consola serie definida en el XML del invitado (requiere un dispositivo <console type='pty'> y un getty configurado dentro del invitado); salir con Ctrl+].
8. Las definiciones de dominio viven como XML bajo /etc/libvirt/qemu/<name>.xml; no editar estos archivos a mano, ya que libvirt no recoge esas ediciones. Usar virsh edit <name>, que abre la definición persistente (inactiva) en $VISUAL/$EDITOR, la comprueba en busca de errores y redefine el dominio al guardar; para un invitado en ejecución, el cambio solo surte efecto en su siguiente arranque. Respaldar primero con virsh dumpxml --inactive <name> > <name>.xml; virsh dumpxml <name> muestra la definición en ejecución.

Resultado esperado

virsh dominfo <name> refleja de inmediato el nuevo estado o la nueva configuración de autostart; virsh list --all muestra shut off después de un destroy o una vez que un shutdown se ha completado (no necesariamente cuando virsh shutdown retorna).

Límites y base de verificación

El comportamiento depende de que el sistema operativo invitado reaccione a la solicitud de apagado; un invitado que no maneja el evento de botón de encendido ACPI (por ejemplo, una imagen mínima sin nada escuchándolo, o un invitado Windows cuya política de botón de encendido está configurada para no hacer nada) no responderá y necesitará un apagado desde dentro del invitado, --mode agent, o destroy. Este módulo no cubre la instalación de libvirt ni la configuración de redes o pools de almacenamiento más allá de lo citado.