Recetas de VM
Cómo crear, configurar y usar recetas de VM en VergeOS para la implementación rápida de máquinas virtuales estandarizadas con preguntas personalizables e integración de cloud-init.
Las recetas de VM ofrecen una forma potente de desplegar rápidamente máquinas virtuales específicas de una instancia a partir de una configuración estándar. Esta página le guiará por el proceso de creación y uso de recetas de VM.
¿Qué es una receta de VM?
Las recetas de VM son plantillas personalizables para iniciar nuevas máquinas virtuales únicas. Pueden incluir especificaciones de hardware iniciales, asignaciones de grupos de recursos y opciones de configuración personalizadas mediante un almacén de pares clave-valor creado en la instanciación de la VM. Por ejemplo, una receta puede configurarse para solicitar un nombre de usuario y contraseña de base de datos, o seleccionar un conjunto específico de paquetes para instalar. Los usuarios pueden determinar las opciones directamente desde la interfaz de usuario al crear la nueva instancia de VM. Las recetas también pueden aprovecharse junto con la API de VergeOS para crear interfaces de usuario personalizadas y agilizar aún más el proceso mediante la integración con sistemas existentes, p. ej., portales de servicios.
Integración estándar del sector VergeOS admite tanto Cloud-Init (Linux) y Cloudbase-Init (Windows) para personalizar las VM durante el primer arranque. Esto puede incluir tareas como configurar usuarios, instalar paquetes o ejecutar scripts. Las recetas pueden permitirle desplegar rápidamente implementaciones de cloud-init/Cloudbase-init proporcionando la interfaz de usuario para recopilar datos y crear dinámicamente los archivos de respuesta asociados. Consulte Uso avanzado a continuación para obtener más información.
Ventajas de usar recetas de VM
Despliegue rápido de nuevas máquinas virtuales
Coherencia entre configuraciones de VM
Menor tiempo de configuración manual
Personalizables para satisfacer necesidades específicas de la aplicación
Recetas de VM incluidas
Un sistema VergeOS incluye automáticamente el Repositorio del proveedor de servicios (Marketplace) compuesto por recetas de VM que pueden utilizarse de inmediato para crear nuevas máquinas virtuales de muchos tipos. La lista de estas recetas de VM disponibles puede verse navegando a Repositorios > (doble clic) repositorio de MarketPlace > Recetas de VM.
Puede hacer doble clic en una receta de VM individual para ver su configuración.
Crear una nueva receta de VM
Configuración base
Crear una VM para servir como la plantilla base para la receta. La VM debe estar generalizada y ser adecuada para el proceso de replicación/personalización.
Desde el menú superior, navegue a Máquinas virtuales > + Nueva receta de VM.
Campos de la receta
Nombre: Use un nombre descriptivo que identifique adecuadamente la receta y pueda ayudar a los usuarios a localizar recetas adecuadas.
Descripción: (opcional) Puede almacenar aquí cualquier información adicional sobre esta receta. Puede ser un buen lugar para proporcionar documentación básica sobre el propósito previsto y las pautas generales.
Icono: (opcional) un Font-Awesome icono puede asociarse a la receta. Los iconos pueden ayudar a los usuarios a identificar fácilmente diferentes recetas/tipos de receta.
Catálogo: Seleccione un catálogo en el que almacenar la receta. Los catálogos son útiles para mantener las recetas organizadas.
Máquina virtual: Seleccione una VM de plantilla.
Versión: Asigne un número de versión. Este campo se incrementará automáticamente cada vez que la receta se modifique, para ayudar a rastrear los cambios.
Usar número de activo para los nombres de las preguntas: Cuando está habilitado, los nombres de las preguntas de discos y NIC se basan en el número de activo asignado en lugar del número ordinal.
Cuando una receta se basa en una máquina virtual, las preguntas de discos se crean automáticamente para cada uno de los discos de la VM, p. ej., YB_DRIVE_1_SIZE, YB_DRIVE_3_NONPERSISTENT, YB_DRIVE_2_SERIAL, etc.
Dependencias de versión: (No aplica para recetas que solo se usarán en el sistema local y en sus propios inquilinos). Se pueden especificar dependencias cuando existan funciones de VergeOS necesarias para que la receta funcione correctamente (para evitar que un sistema remoto use una receta que no pueda admitir).
Haga clic en Enviar para guardar la configuración base. El panel de la receta de VM mostrará dónde puede configurar sus secciones y preguntas.
Preguntas
Las preguntas de la receta se usan para determinar valores clave. Cuando se crea una receta, algunas preguntas se incluyen automáticamente. Algunas de estas preguntas están deshabilitadas de forma predeterminada y tendrían que habilitarse si desea usarlas.
(Opcional) Habilite las preguntas deshabilitadas predeterminadas: Haga clic en Preguntas (menú izquierdo o tarjeta del panel), seleccione la(s) pregunta(s) y haga clic en Habilitar en el menú izquierdo.
Para configurar preguntas adicionales, haga clic en Preguntas en el menú izquierdo y luego en Nuevo.
Campos de la pregunta:
Sección: cada pregunta pertenece a una sola sección. Las secciones le permiten agrupar sus preguntas en el formulario de entrada. Algunas secciones se crean automáticamente. Opcionalmente, puede crear nuevas secciones para sus preguntas.
Nombre: actúa como el nombre de variable que puede referenciarse en scripts; use un nombre descriptivo para facilitar el mantenimiento y la resolución de problemas del script; solo caracteres alfanuméricos (sin espacios ni caracteres especiales)
Tipo: determina cómo se recopilan los datos: mediante la entrada del usuario, interactuando con la base de datos de VergeOS, descargando imágenes en la nube, etc.
ID de orden: se usa para determinar el orden en que se muestran las preguntas (dentro de la sección seleccionada)
Mostrar: texto mostrado en la interfaz de VergeOS para que el usuario responda a las preguntas de la receta
Valor predeterminado: (opcional) define un valor de respuesta inicial para la pregunta
Validación Regex: (opcional) cadena de expresión regular utilizada para validar la entrada (sintaxis estándar de Regex)
Texto del marcador de posición: (opcional) texto atenuado que se muestra para dar al usuario un ejemplo de la entrada esperada
Texto de información sobre herramientas: (opcional) texto de ayuda del usuario que se muestra en un emergente cuando se pasa el ratón sobre el campo
Texto de nota: (opcional) texto de ayuda del usuario que se muestra directamente debajo del campo de entrada para proporcionar orientación adicional al usuario.
Al cambiar: permite ocultar/mostrar otras preguntas cuando se cambia este campo. (Se muestra código de ejemplo en este campo al crear una nueva pregunta.)
Pueden estar disponibles opciones de configuración adicionales según el tipo seleccionado.
Simular una receta de VM
Puede simular una receta de VM para probarla. Al simular la receta, podrá ver el formulario de entrada del usuario, probar la validación de campos y crear archivos de respuesta de ejemplo para verificar su configuración. Solo puede simular una receta de VM que esté publicada en su catálogo local. Si lo desea, puede hacer referencia a recetas de Marketplace y clonarlas al catálogo local.
Para ver simplemente el formulario de entrada del usuario: mientras esté en el panel de la receta de VM, haga clic en Simular receta en el menú de la izquierda.
Desde el formulario de entrada simulado, puede probar la validación de campos y generar archivos de respuesta de prueba haciendo clic en el botón Simular en la parte inferior del formulario. Se mostrará una lista de pares variable/valor, junto con una impresión de los archivos de resultado simulados.
Para continuar creando una VM a partir de las entradas, haga clic en el botón Crear.
Modificar una receta de VM
Cuando se realizan cambios en una receta, será necesario republicarla para que esos cambios estén disponibles. En la parte superior del panel de la receta se mostrará un mensaje indicando que debe republicarse para que los cambios surtan efecto. Puede usar el Republicar enlace dentro de este mensaje o hacer clic en Republicar en el menú izquierdo.
Cuando realiza cambios y republica una receta, se notifica a los sistemas remotos y a los inquilinos que hay una actualización disponible (notificación en la parte superior del panel de la receta de VM y casilla de verificación de actualización disponible); deben actualizar la receta para acceder a los cambios.
Usar una receta de VM
Las recetas de VM están disponibles para su uso al crear una nueva máquina virtual. Todos los catálogos accesibles (locales y remotos) se enumeran a la izquierda de la pantalla de nueva VM; seleccione un catálogo para ver las recetas individuales disponibles.
Instancias de la receta
Una instancia se refiere a una máquina virtual asociada con una receta de VM. Cuando una máquina virtual se crea con una receta, se considera una instancia de la receta hasta que se elimina o se desvincula de la receta.
Haga clic en Instancias en el menú izquierdo de un panel de receta de VM para acceder rápidamente a una lista de las VM asociadas. Una receta de VM no se puede eliminar cuando hay alguna instancia de VM asociada.
Uso avanzado
Integración de Cloud-Init y Cloudbase-init
Para usar con una plantilla de VM:
Establezca la Campo Fuente de datos de Cloud-init = Config Drive v2.
Instale Cloud-init y los scripts asociados dentro de la plantilla de VM.
Para usar una imagen de sistema operativo en línea: Las recetas de VergeOS permiten aprovechar muchas imágenes de sistema operativo con cloud-init preinstaladas y disponibles para descargar por la mayoría de los sistemas operativos Linux y FreeBSD. Para utilizar una imagen descargada específica, puede crear una pregunta de la receta configurada de la siguiente manera:
Nombre="OS_DL_URL"
Tipo=Oculto
Valor predeterminado: la URL de descarga (p. ej.
https://cloud-images.example.com/releases/jammy/release/ubuntu-22.04-server-cloudimg-amd64-disk-kvm.img,http://download.rockylinux.org/pub/rocky/8/images/x86_64/Rocky-8-GenericCloud.latest.x86_64.qcow2)
Para transmitir una imagen en la nube a través de la web, puede crear una pregunta de la receta configurada de la siguiente manera:
Nombre="OS_URL"
Tipo=Oculto
Valor predeterminado: la URL de la imagen (p. ej.
https://cloud/debian.org/images/cloud/bullseye/latest/debian-11-generic-amd64.qcow2)
Ejemplos de referencia: Las recetas de Marketplace proporcionan buenos ejemplos para usar imágenes de sistema operativo cloud-init/cloudbase-init en una receta.
La integración con Cloud-init/Cloudbase-init permite muchas soluciones con una variedad de enfoques posibles. Póngase en contacto con el soporte de VergeOS si necesita ayuda adicional.
Última actualización
¿Te fue útil?