> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/automate-protect-and-extend/es/automatizacion/vm-recipes.md). # Recetas de VM 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](#advanced-usage) 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**. ![marketplaceVMlisting](/files/58b0632455c0808a59db6586978413be474a67f9) Puede hacer doble clic en una receta de VM individual para ver su configuración. ![included-recipe-config](/files/1b8057fd888ebf0ab26640d662cc7b8a5e3ae300) ## Crear una nueva receta de VM ### Configuración base 1. **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. 2. Desde el menú superior, navegue a **Máquinas virtuales** > **+ Nueva receta de VM**. {% hint style="info" %} **Las recetas se almacenan en** [**Catálogos**](/automate-protect-and-extend/es/automatizacion/recipes-organization.md#catalogs)**. Si aún no ha creado un catálogo local, se le pedirá que cree uno nuevo primero.** {% endhint %} 3. **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.

Numeración de versiones

Un número de versión de 1.0.0 se incrementaría a 1.0.0-1 y luego a 1.0.0-2, y así sucesivamente. Además, puede editar manualmente el número de versión para reflejar cambios de versión más importantes, como cambiar la versión a 2.0.0 después de realizar modificaciones significativas en la receta.

* **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). 4. 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. 1. **(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. 2. 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. {% hint style="success" %} **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.** {% endhint %} ## 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](#included-vm-recipes) 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. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.verge.io/automate-protect-and-extend/es/automatizacion/vm-recipes.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.