Saltar al contenido

Crear y usar plantillas de VM

Convierta una copia detenida de una VM en plantilla, cree dos VM a partir de ella y compruebe que cada una obtiene sus propios discos y datos. La VM original permanece intacta.

Se aplica a la imagen xoa-image-20261022-a280852, paquete v5.113.2_e281c536-ce40 (Xen Orchestra 5.113.2). Basado en el código publicado; aún no probado en un laboratorio. Estos pasos reutilizan un disco instalado: no preparan un sistema operativo invitado para su reutilización generalizada.

Antes de empezar

  • Acceda al appliance XOA-HL como administrador. Convertir una VM exige permisos de administración tanto sobre la VM como sobre su pool; el acceso solo a la VM no basta.
  • Use un invitado de pruebas ya instalado con discos normales: sin discos compartidos ni dispositivos de paso directo. Nunca convierta el appliance ni la VM original.
  • Cree una copia de trabajo independiente con Crear una copia completa en el mismo pool. Anote los UUID del original y la copia, el ID VDI, SR y tamaño de cada disco, y la suma de comprobación de un archivo de ejemplo inocuo dentro del invitado. Compruebe que la copia arranca aislada y apáguela normalmente.
  • En la copia de trabajo, quite todas las interfaces de red, expulse el ISO del instalador, desactive el encendido automático y exclúyala de las tareas programadas.
  • Reserve memoria del host y espacio en SR con escritura para la plantilla y dos VM de prueba.
  • Disponga de acceso a la consola y de las credenciales del invitado. Renombrar una VM o cambiar su MAC no cambia las contraseñas, nombre de host, configuración IP, claves ni identidades de aplicaciones copiados. Use estas copias únicamente mediante la consola.

Trabaje en el navegador, en la dirección del appliance. Compruebe archivos y sumas en la consola del invitado, no en el host ni en el appliance. Una plantilla en la misma infraestructura no es una copia de seguridad: guarde sus copias de seguridad por separado. Para un invitado Ubuntu 24.04 nuevo, instale las herramientas de invitado antes de crear la copia.

Convierta la copia detenida en plantilla

  1. Compruebe la copia de trabajo: su UUID, estado Halted, lista de interfaces de red vacía y los discos anotados.
  2. Asígnele un nombre único, como lab-template-v1, y una descripción con el SO invitado y su versión, la fecha de preparación y la suma del archivo de ejemplo. Actualice la página y compruebe estos valores.
  3. Abra la pestaña Advanced (/#/vms/<copy-uuid>/advanced) y seleccione Convert to template. El botón solo funciona cuando la VM está detenida. La confirmación advierte que el cambio es permanente: cancele si no es la copia deseada.
  4. Confirme una vez y espere a que termine.
  5. Abra Home y elija el tipo de objeto Template (/#/home?t=VM-template). Borre los filtros si es necesario, expanda la fila y lea el UUID completo.

Comprobación: la plantilla tiene el mismo UUID que la copia de trabajo, con el nombre y descripción elegidos, y la VM original sigue existiendo. La conversión no copia la VM: la propia copia se convierte en plantilla.

Antes de marcar la VM como plantilla, XO intenta expulsar los medios extraíbles. Si falla, los cambios previos en los medios pueden permanecer aunque falle la conversión. Actualice el tipo de objeto, los medios y la tarea antes de repetir. Esta guía no trata la reconversión de plantilla a VM ni la reversión automática.

Cree una VM detenida a partir de la plantilla

  1. Abra New → VM (/#/vms/new), elija el mismo pool y seleccione su plantilla. Llame a la VM lab-template-test-1. Compruebe el UUID template= en la dirección de la página, no solo el nombre de la plantilla.
  2. Compruebe CPU, memoria, discos de la plantilla, tamaños y SR de destino con escritura. Mantenga los mismos discos y tamaños.
  3. En Install settings, elija No config drive. Esta prueba reutiliza el disco instalado: no ejecuta un instalador ni depende de cloud-init para cambiar la identidad del invitado. Si faltan los discos o esta opción, deténgase y compruebe la plantilla seleccionada.
  4. En Interfaces, quite todas las interfaces propuestas y compruebe que la lista está vacía. Incluso una plantilla sin interfaces puede recibir las redes predeterminadas del pool mediante el asistente.
  5. En Advanced, desmarque Boot VM after creation y deje desactivado el encendido automático.
  6. En Summary, desmarque Fast clone. Compruebe que está creando una VM con los discos, recursos y SR esperados y cero interfaces. Seleccione Create una sola vez. El asistente activa por defecto el arranque tras la creación y la clonación rápida; no confíe en ajustes anteriores. Sin clonación rápida, XO realiza una copia completa de los discos, que requiere espacio en el SR.
  7. Espere, actualice y anote el UUID de la nueva VM.

Comprobación: antes de cualquier arranque, la VM nueva está Halted, su pestaña Network está vacía y los discos tienen el número, tamaños y SR esperados, con ID VDI distintos de los de la plantilla y el original. La plantilla y el original siguen existiendo. Un mensaje de éxito o un nombre nuevo no lo demuestra. Si apareció una interfaz o arrancó la VM, deténgala y compruebe a qué pudo acceder antes de continuar.

Compruebe que cada VM obtiene su propia copia

  1. Tras las comprobaciones anteriores, arranque solo lab-template-test-1. En su consola, compruebe que el invitado arranca y puede acceder; después compruebe la disposición de los discos y la suma del archivo de ejemplo.
  2. Cambie solo el archivo de ejemplo a un nuevo valor de prueba, anótelo y apague normalmente el invitado.
  3. Repita Crear una VM detenida a partir de la plantilla desde la misma plantilla, como lab-template-test-2. Revise de nuevo todos los ajustes.
  4. Estando detenida, compruebe que tiene un UUID de VM diferente, ID VDI distintos y ninguna interfaz. Arránquela mediante la consola y compruebe que el archivo de ejemplo conserva su suma original, no el nuevo valor de la prueba 1. Apáguela normalmente.
  5. Anote los UUID e ID VDI de ambas VM, el UUID de la plantilla, los resultados del invitado y las versiones instaladas. Deje detenidas las VM de prueba.

Comprobación: ambos invitados arrancan con los datos esperados y el cambio en la prueba 1 no llegó a la prueba 2. Esta comprobación de archivo no prueba la recuperación de aplicaciones ni elimina las identidades duplicadas del SO. No conecte una red de producción hasta que el responsable del invitado las haya resuelto.

Para limpiar, elimine cada VM de prueba tras identificarla. Conserve la plantilla, la VM original y sus copias de seguridad. Para una versión nueva de la plantilla, prepare otra copia con un nombre de versión nuevo y repita estas comprobaciones.

Si algo falla

ProblemaQué comprobar
Se rechaza la conversiónLea el error, los permisos de la VM y el pool y el estado real de alimentación. No fuerce la detención de un invitado valioso ni vuelva a convertir un objeto sin identificar. Tras un error, compruebe el tipo de objeto y los medios extraíbles del mismo UUID.
La plantilla no apareceElija el tipo de objeto Template, el pool y los filtros correctos, y actualice. Una plantilla no aparece en la lista normal de VM. No cree otra copia antes de comprobar el inventario.
Falla la creación de la VMGuarde el error y la lista de plantillas, VM y VDI antes de repetir. XO intenta limpiar tras un fallo, pero una respuesta perdida o una limpieza fallida pueden dejar objetos. Nunca elimine en masa discos que parezcan huérfanos.
El invitado difiere o no arrancaConserve la plantilla y los registros. Compruebe el UUID de plantilla, discos copiados, firmware, recursos y ajustes de instalación. No cambie la red de administración del host para resolverlo.

Quedan fuera de esta guía la modificación del invitado dentro de una plantilla, la retirada o eliminación de plantillas, el despliegue en otro pool, el almacenamiento para clonación rápida, cloud-init y la preparación específica de cada SO. Si persiste un problema, comuníquelo sin datos sensibles.

Fuentes

Preparar, mantener y retirar una plantilla (VM06)

Alcance: XO 5.113.2 e281c536, fuentes de XOA-HL ce40/ce47. Las operaciones de conversión y copia de XO no generalizan un sistema operativo invitado. Este procedimiento no admite ningún comando universal de generalización de invitados.

  1. Antes de la conversión, haga una copia de trabajo aislada y anote el sistema operativo invitado, su versión y sus aplicaciones. Siga el procedimiento de preparación del fabricante del sistema operativo para el nombre de host, la identidad de la máquina, las claves de host SSH, la red estática, las credenciales, el estado de cloud-init y las identidades de aplicaciones y licencias. Elimine el material privado. Para Windows, obtenga primero un plan Sysprep específico del sistema operativo y un laboratorio Windows; los resultados de Linux no pueden validarlo.
  2. Anote los comandos exactos de preparación del invitado y el comportamiento previsto en el primer arranque. No borre a ciegas los ID de máquina ni las claves de un original en ejecución. Apague la copia preparada y siga los pasos de conversión existentes. Si no hay un procedimiento específico para el invitado, mantenga la plantilla para uso solo por consola y márquela como no generalizada.
  3. Para un fast clone, elija la plantilla en New VM, asigne un nombre único, seleccione Fast clone, mantenga la relación de almacenamiento que exige la plantilla y deje desactivado el arranque. Compruebe el resumen y cree una VM. Un fast clone depende de su SR y de sus discos base; no es una copia completa e independiente.
  4. Vuelva a leer los ID distintos de VM y VDI y su ubicación. Quite todas las VIF, arranque desde la consola y compruebe la muestra y las identidades previstas en el primer arranque. Repita con un segundo clon; compare las identidades entre sí y con la plantilla antes de aprobar el uso de la red. Un cambio de MAC por sí solo no basta.
  5. Para el mantenimiento, cree una VM de trabajo detenida a partir de la plantilla v1, aíslela, aplique las actualizaciones del invitado, compruebe las herramientas y la aplicación, repita la preparación y publique la plantilla v2 mediante conversión. Pruebe dos despliegues de v2. No edite un disco base en uso ni suponga que una plantilla puede arrancarse y parchearse en su sitio.
  6. Para la retirada, quite v1 de los conjuntos de recursos y deje de elegirla para VM nuevas. Haga inventario de los clones dependientes y de las copias de recuperación independientes, y elimine solo la plantilla retirada identificada, con la confirmación normal, tras una comprobación de recuperación. Compruebe que los clones existentes siguen arrancando con sus datos. No elimine manualmente VDI base ni fusione cadenas.

Fallo: conserve la plantilla original, los clones parciales y los inventarios. No publique v2 ni retire v1 tras una preparación fallida, una identidad duplicada, un fallo de arranque o una dependencia de almacenamiento sin explicar. La generalización específica del invitado sigue pendiente hasta que se superen su procedimiento exacto para el sistema operativo y dos primeros arranques.

Implementación fijada: packages/xo-server/src/api/vm.mjs, packages/xo-web/src/xo-app/new-vm/index.js, packages/xo-server/src/xapi/mixins/vm.mjs, @xen-orchestra/xapi/vm.mjs.

Resultado de laboratorio, 3 de noviembre de 2026 (parcial): A través de la API, se convirtió una VM en plantilla y después se crearon dos fast clones y un clon completo. Un clon de una plantilla es a su vez una plantilla. Los dos fast clones compartían un disco padre base copy (vhd-parent) y la copia completa no tenía ninguno. Eliminar la plantilla de origen dejó intactos los tres clones y sus discos, y la copia base compartida permaneció. No se ejecutaron la preparación del invitado, dos primeros arranques distintos ni los pasos de generalización del fabricante, así que VM06 sigue pendiente.