Bitácora

Registro de cambios y evolución del Manual de Administración de NorTK VM.

El formato se basa en Keep a Changelog, y este proyecto se adhiere a Semantic Versioning.

[Sin publicar]

Agregado

  • Módulo 01 (Concepto): Introducción y arquitectura de NorTK VM (KVM, QEMU, controladores VirtIO, libvirt y aislamiento multinivel con sVirt/SELinux).

  • Módulo 02 (Concepto): Correspondencia conceptual con VMware vSphere (matriz comparativa, datastores frente a pools, vSwitches frente a puentes Linux/OVS, VMware Tools frente a QEMU Guest Agent y vMotion frente a Live Migration con TLS).

  • Módulo 03 (Concepto): Interfaces de administración Cockpit y virt-manager (casos de uso, ámbito obligatorio de sesión del sistema qemu:///system y modelo de permisos con PolicyKit y grupo libvirt).

  • Módulo 04 (Procedimiento): Administración de pools y volúmenes de almacenamiento bajo el contrato de cinco bloques adaptado a GUI y comandos complementarios con virsh y qemu-img.

  • Módulo 05 (Procedimiento): Configuración de redes virtuales y puentes de red corporativos (Linux Bridge) vinculados a interfaces físicas con validación determinista.

  • Módulo 06 (Procedimiento): Aprovisionamiento de máquinas virtuales con arquitectura moderna UEFI/Q35, buses paravirtualizados y activación obligatoria de qemu-guest-agent.

  • Módulo 07 (Procedimiento): Operación cotidiana y acceso a consolas gráficas (VNC/SPICE) y consolas serie de terminal desde Cockpit y virt-manager.

  • Módulo 08 (Procedimiento): Gestión de instantáneas diferenciales (snapshots) en caliente sobre discos QCOW2 con congelamiento de sistemas de archivos (fsfreeze) y advertencia sobre políticas de respaldo.

  • Módulo 09 (Ensamblaje): Migración completa de máquinas virtuales desde hipervisores VMware ESXi y plantillas OVA/OVF hacia NorTK VM utilizando virt-v2v e inyección de controladores VirtIO.

  • Módulo 10 (Concepto y Referencia): Optimización de recursos y rendimiento (modelo de CPU host-passthrough, asignación elástica con VirtIO ballooning, compactación de memoria con KSM y políticas de caché de disco).

  • Módulo 11 (Referencia): Resolución de problemas y catálogo de mensajes de error bajo la anatomía de cuatro partes de IBM (bloqueos de SELinux, sockets de libvirt, filtrado br_netfilter y autoinicio).

  • Módulo 12 (Referencia): Catálogo exhaustivo de comandos CLI para auditoría (inspección de dominios, redes, pools y discos con virsh y qemu-img) y matriz de equivalencia frente a VMware PowerCLI.

  • Habilidad operativa local y compartida en .agents/skills/nortk-vm-doc/SKILL.md, eliminando referencias a configuraciones personales de entorno.

  • Catálogo inicial de 12 figuras de interfaz gráfica en source/_static/images/ cubriendo la doble vía Cockpit y virt-manager.

  • Generación formal del manual completo en PDF de 63 páginas en build/nortk-vm-manual-v0.1.0.pdf mediante LaTeX y Sphinx.

  • Inicialización del proyecto de documentación en Sphinx con soporte en idioma español para NorTK VM en docs/nortk-vm.

  • Integración del tema corporativo NorTK con sphinx_rtd_theme, hoja de estilos nortk.css y logotipo vectorial SVG.

  • Automatización de ciclo de vida en GNUmakefile con soporte para dev (servidor con recarga en vivo), html, dirhtml, latexpdf, lint (con rstcheck) y fix (con crstlint).

  • Hook de Git para pre-push en .githooks/pre-push para auditoría estática estricta previa a envíos remotos.

  • Documentos maestros README.rst, CHANGELOG.rst y CONTRIBUTING.rst en la raíz del proyecto.

  • Integración de la Bitácora y la guía de contribución en el árbol de navegación de Sphinx mediante enlaces simbólicos canónicos.

  • Directivas de ingeniería y formalización de excepciones metodológicas en GEMINI.md para el desarrollo asistido.

  • Módulo normativo en source/normativa/excepciones-guia-estilo.rst integrado en el árbol de navegación de Sphinx, codificando las cinco adaptaciones para Cockpit, virt-manager y usuarios en transición desde VMware.

Modificado

  • Auditoría adversarial y remediación exhaustiva bajo el protocolo Crucible Protocol: * Restricción de qemu-img resize a operaciones en frío e incorporación de virsh blockresize para ampliación de disco en caliente en catalogo-de-comandos-cli-para-auditoria.rst. * Supresión de la bandera incompatible --disk-only en la creación de instantáneas para asegurar funcionalidad completa con virsh snapshot-revert en gestion-de-instantaneas-y-respaldos.rst. * Validación explícita de firmware (BIOS tradicional con MBR frente a UEFI/OVMF con GPT) y advertencia operativa sobre controladores VirtIO e imágenes initramfs en migracion-de-maquinas-virtuales-desde-vmware.rst. * Restricción de seguridad de red en despliegues con virt-install vinculando el visor gráfico VNC estrictamente a 127.0.0.1 e incorporación del canal VirtIO serie org.qemu.guest_agent.0. * Adición de salidas de terminal esperadas (bloques code-block:: text) en todos los apéndices CLI procedimentales (aprovisionamiento, consolas, instantáneas, almacenamiento, redes y migración). * Inclusión de advertencias operativas críticas: combinación de escape Ctrl + ] para consolas serie interactivas (virsh console), riesgo de interrupción de enlace SSH al asociar interfaces a puentes de red y necesidad de virsh pool-refresh al incorporar volúmenes externos. * Corrección de la verificación de autoinicio en resolucion-de-problemas-y-trampas-operativas.rst empleando virsh dominfo y virsh list --all --autostart. * Sustitución de terminología obsoleta de SPICE por VNC y consolas serie nativas en interfaces y operación de máquinas virtuales. * Formalización técnica del mecanismo de asignación elástica en memory ballooning, erradicando metáforas informales. * Parametrización mediante variables de entorno (host, puerto, credenciales y rutas relativas) en el script de automatización de Cockpit scripts/capture_all_cockpit.py. * Depuración de dependencias en requirements.txt eliminando la librería huérfana weasyprint. * Normalización tipográfica de encabezados de tablas a minúscula inicial (sentence case) en español, concordancia de género gramatical y resolución de marcado en línea anidado.

  • Incorporación del flujo de integración continua para despliegue automatizado en GitHub Pages en .github/workflows/pages.yml.

  • Refactorización integral de la herramienta de captura automatizada en scripts/capture_all_virtmanager.py adoptando el backend nativo headless Broadway de GTK3 (GDK_BACKEND=broadway) y renderizado directo a Cairo (win.draw(cr)), eliminando la dependencia del compositor Wayland y cualquier recorte artificial.

  • Sustitución y despliegue del catálogo completo de figuras de virt-manager en source/_static/images/ con capturas fidedignas bajo el tema oficial Adwaita en idioma español (es_MX.UTF-8), con geometría natural y optimización sin pérdidas con pngquant.

  • Actualización procedimental en el módulo de almacenamiento (source/almacenamiento/) para reflejar con precisión el cuadro de diálogo unificado de creación de pools de almacenamiento introducido en virt-manager 5.1.0.

  • Recompilación integral del manual en PDF de 66 páginas en build/nortk-vm-manual-v0.1.0.pdf integrando las 12 figuras fidedignas de Cockpit y virt-manager con maquetación tipográfica validada en LaTeX.

  • Corrección y alineación técnica del módulo de instantáneas (source/maquinas-virtuales/gestion-de-instantaneas-y-respaldos.rst): formalización de la división de responsabilidades (Cockpit para verificación previa de estado de ejecución y disco QCOW2; virt-manager y virsh para la gestión interactiva del árbol jerárquico de instantáneas).

  • Incorporación de la herramienta de captura automatizada en scripts/capture_all_cockpit.py basada en Chrome DevTools Protocol (CDP) y WebSockets.

  • Reestructuración integral de los módulos procedimentales bajo el paradigma GUI-first con doble carril obligatorio: flujos completos independientes para Cockpit y virt-manager, verificación visual primaria y degradación de la CLI a apéndices de auditoría opcionales.

  • Formalización del segundo término operativo para la línea de comandos: la CLI no se descarta ni se oculta; se preserva de manera estructurada al pie de cada módulo para automatización reproducible, auditoría profunda y contingencias sin interfaz gráfica.

  • Generalización del estándar operativo en .agents/skills/nortk-vm-doc/SKILL.md como marco metodológico portable para manuales de infraestructura empresarial.

  • Especificación técnica y protocolaria del pipeline de capturas de pantalla: automatización web con navegadores headless (CDP/Playwright), capturas selectivas por elemento modal, renderizado HiDPI 2x, anonimización dinámica en el DOM y compresión sin pérdidas con magick, pngquant y optipng.

  • Formalización del mandato de sincronización quíntuple del ciclo de vida (coordinación obligatoria entre GEMINI.md, .agents/skills/nortk-vm-doc/SKILL.md, CONTRIBUTING.rst, CHANGELOG.rst y README.rst).

  • Reestructuración del árbol de fuentes en directorios temáticos modulares independientes (fundamentos/, almacenamiento/, redes/, maquinas-virtuales/, migracion/, optimizacion/, referencia/ y normativa/), erradicando nombres planos en la raíz de source/.

  • Reorganización de source/index.rst en grupos temáticos estructurados con encabezados de navegación para cada subsistema de infraestructura.

  • Remediación integral de hallazgos de auditoría bajo el Crucible Protocol (Strikes 4 y 5): * Anonimización y saneamiento de figuras de consola conforme a RFC 5737 y RFC 2606 (sustitución por virt-manager-vms-visor-consola.png con FQDN institucional y direccionamiento seguro). * Regeneración y localización nativa al español (es-MX) del catálogo completo de figuras de Cockpit en source/_static/images/, eliminando errores de rutas inexistentes y sincronizando nombres corporativos (vm-app01.infra.nortk.com, srv-erp01.infra.nortk.com, puente enp3s0f0 y botón Aplicar). * Sustitución de pantallas de arranque fallido de SeaBIOS en consolas gráficas por inicios de sesión operativos de CentOS Stream 10. * Corrección de concordancia terminológica entre el texto normativo y las etiquetas de virt-manager en español (Dispositivo de puente..., sección lateral Resumen e icono de aspa circular de eliminación). * Conversión de todos los pasos procedimentales numerados a modo imperativo directo y voz activa. * Inclusión de la carga persistente e inmediata del módulo del kernel br_netfilter en la resolución de problemas de redes. * Erradicación de antropomorfismos residuales en descripciones técnicas de memoria virtual. * Depuración de variables obsoletas en GNUmakefile y corrección de descriptores en .githooks/pre-push.