2. Catálogo de comandos CLI para auditoría

Este módulo proporciona una referencia rápida de los comandos esenciales de línea de comandos en NorTK VM para administradores que requieren auditar el estado del hipervisor, inspeccionar dominios o diseñar scripts de automatización como alternativa o complemento a las interfaces gráficas.

2.1. Gestión de máquinas virtuales con virsh

La herramienta virsh es la interfaz de línea de comandos estándar para interactuar con libvirt y el hipervisor KVM.

Comando CLI	Función operativa
`virsh list --all`	Lista todas las máquinas virtuales indicando su ID, nombre y estado.
`virsh dominfo <dominio>`	Muestra información detallada de vCPUs, memoria asignada, UUID y estado de seguridad.
`virsh start <dominio>`	Enciende una máquina virtual inactiva.
`virsh shutdown <dominio>`	Envía una solicitud de apagado limpio vía ACPI/QEMU Guest Agent.
`virsh reboot <dominio>`	Reinicia el sistema operativo huésped de forma ordenada.
`virsh reset <dominio>`	Ejecuta un reinicio forzado directo por hardware sin esperar al sistema operativo.
`virsh destroy <dominio>`	Apagado forzado inmediato (equivalente a corte de energía).
`virsh autostart <dominio>`	Configura el dominio para que inicie automáticamente al arrancar el host.
`virsh autostart --disable <dominio>`	Deshabilita el arranque automático del dominio.
`virsh dumpxml <dominio>`	Exporta la definición completa del hardware y configuración de la VM en formato XML.
`virsh edit <dominio>`	Abre la definición XML del dominio en el editor predeterminado con validación de sintaxis.

2.2. Inspección de redes virtuales e interfaces

Comando CLI	Función operativa
`virsh net-list --all`	Muestra todas las redes virtuales configuradas en libvirt y su estado.
`virsh net-info <red>`	Despliega detalles de conmutación, puente asociado y modo de reenvío (NAT/Enrutado).
`virsh domifaddr <dominio>`	Consulta al agente invitado y reporta las direcciones IP asignadas y direcciones MAC.
`virsh domiflist <dominio>`	Enumera las tarjetas de red virtuales, puentes de conexión y modelos de controlador.

2.3. Auditoría de pools y volúmenes de almacenamiento

Comando CLI	Función operativa
`virsh pool-list --all`	Lista todos los pools de almacenamiento y su estado de autoinicio.
`virsh pool-info <pool>`	Reporta la capacidad total, espacio asignado y espacio libre en el pool.
`virsh vol-list <pool>`	Enumera todos los volúmenes de disco alojados en un pool específico.
`virsh vol-info <volumen> --pool <pool>`	Muestra el tamaño aparente (virtual) y el consumo físico real del archivo de disco.

2.4. Diagnóstico de imágenes de disco con qemu-img

Comando CLI	Función operativa
`qemu-img info <archivo.qcow2>`	Muestra formato, tamaño virtual, tamaño en disco físico, clúster y árbol de instantáneas.
`qemu-img check <archivo.qcow2>`	Verifica la integridad estructural de las tablas de metadatos y detecta fugas de clústeres.
`qemu-img resize <archivo.qcow2> +10G`	Incrementa el tamaño virtual del disco en frío con la máquina virtual apagada.
`virsh blockresize <dominio> <ruta-o-dev> <tamaño>`	Incrementa el tamaño virtual del disco en caliente con el dominio en ejecución.
`qemu-img convert -O qcow2 <origen.vmdk> <destino.qcow2>`	Convierte una imagen de disco de formato VMware VMDK hacia el formato nativo QCOW2.

2.5. Matriz de equivalencia CLI frente a PowerCLI de VMware

Para asistir en la transición a operadores habituados a la automatización mediante VMware PowerCLI:

Comando VMware PowerCLI	Comando equivalente en NorTK VM	Ámbito
`Get-VM`	`virsh list --all`	Cómputo
`Start-VM -VM <nombre>`	`virsh start <nombre>`	Cómputo
`Stop-VM -VM <nombre> -Confirm:$false`	`virsh shutdown <nombre>`	Cómputo
`Restart-VMGuest -VM <nombre>`	`virsh reboot <nombre>`	Cómputo
`Get-VMGuestNetworkInterface -VM <nombre>`	`virsh domifaddr <nombre>`	Redes
`Get-Datastore`	`virsh pool-list --all`	Almacenamiento
`New-Snapshot -VM <nombre> -Name <snap>`	`virsh snapshot-create-as <nombre> <snap>`	Respaldo