Recetas de inquilino

Automatizar el despliegue completo de VDC con plantillas reutilizables de recetas de inquilino, incluidas preguntas del sistema, preguntas personalizadas, intercambio de recetas y ejemplos reales de CSP.

¿Qué son las recetas de inquilino?

Las recetas de inquilino transforman un inquilino configurado manualmente en un plantilla de implementación reutilizable de un clic. Una sola receta de inquilino puede automatizar la creación de un Centro de Datos Virtual completo, incluidas la configuración del inquilino, la configuración de red, las reglas del firewall, las máquinas virtuales incluidas, credenciales aleatorizadas, registro DNS/DHCP y notificaciones por correo electrónico, todo a partir del envío de un único formulario.

Donde el Asistente del Inquilino (tratado en la página anterior) lo guía a través de una configuración manual única, las recetas codifican esa configuración para que pueda repetirse cientos de veces con personalizaciones por instancia.

¿Por qué usar recetas de inquilino?

Implementación rápida

Reduce el aprovisionamiento de inquilinos de horas de configuración manual a minutos de implementación automatizada.

Consistencia y cumplimiento

Cada instancia de inquilino sigue la misma línea base de imagen dorada: red, reglas de firewall, VM y políticas son idénticas.

Menos errores humanos

La automatización elimina las configuraciones incorrectas que se cuelan durante la configuración manual repetitiva.

Habilitación de autoservicio

Combinadas con la API, las recetas impulsan portales orientados al cliente donde los usuarios finales aprovisionan sus propios VDC.

Preparación del inquilino base

Toda receta de inquilino comienza con un inquilino base que sirve como plantilla. Este inquilino debe ser:

1. Apagado — el sistema de recetas captura el estado del inquilino, por lo que no debe estar en ejecución
2. Dedicado al uso de recetas — no use un inquilino de producción como base. Si desea basar una receta en un inquilino existente, clónelo primero y elimine los datos específicos del cliente (contraseñas, nombres de usuario, archivos del cliente)
3. Totalmente configurado — incluya todas las redes, VM, reglas del firewall, configuraciones DHCP/DNS y cualquier otra configuración que deba aparecer en cada instancia

Piense en el inquilino base como una imagen dorada para un centro de datos completo, no solo para una sola VM.

Creación de una receta de inquilino

Proceso paso a paso

1. Construya y configure el inquilino base con todas las configuraciones, redes y VM deseadas
2. Apague el inquilino base
3. Vaya a Repositorios > Recetas de inquilino en la interfaz de VergeOS
4. Haga clic en Nuevo en el menú de la izquierda
5. Configure los campos de la receta (vea abajo)
6. Haga clic en Enviar para guardar — el panel de la receta se abre para personalizar las preguntas

Campos de la receta

Campo	Descripción	Notas
Nombre	Nombre descriptivo para la receta	Ayuda a los usuarios a encontrar la receta correcta cuando hay varias disponibles
Descripción	Documentación opcional para la receta	Buen lugar para pautas de uso, propósito previsto y notas de cumplimiento
Icono	Icono opcional de Font Awesome	Identificador visual para distinguir tipos de receta (por ejemplo, fa-cloud, fa-database)
Catálogo	El catálogo en el que almacenar la receta	Debe ser un catálogo en un repositorio local — las recetas no se pueden crear directamente en repositorios remotos/Marketplace. Vea Intercambio de recetas abajo
Inquilino	El inquilino base que se usará como plantilla	Debe estar apagado
Versión	Número de versión de incremento automático	Comienza en 1.0.0, incrementa a 1.0.0-1, 1.0.0-2, etc. Puede establecerse manualmente en 2.0.0 para cambios importantes
Conservar certificados SSL	Copiar los certificados SSL del inquilino base a las instancias	Habilitar cuando el inquilino base tenga certificados preinstalados
Dependencias de versión	Requisitos de funciones de VergeOS	Evita que los sistemas remotos usen una receta que no pueden admitir

Preguntas de la receta

Las preguntas son el corazón de una receta de inquilino. Capturan la entrada por instancia del operador (o de la base de datos de VergeOS) e inyectan esos valores en el nuevo inquilino durante la creación.

Cuando crea una receta de inquilino, VergeOS genera automáticamente preguntas del sistema organizadas en secciones. Muchas preguntas del sistema están deshabilitadas de forma predeterminada y deben habilitarse explícitamente si es necesario. Las preguntas del sistema no se pueden eliminar: solo habilitar o deshabilitar.

Campos de pregunta

Cada pregunta — del sistema o personalizada — se configura con estos campos:

Campo	Propósito
Sección	Agrupa las preguntas en el formulario de entrada (algunas se crean automáticamente, se pueden agregar secciones personalizadas)
Nombre	Nombre de variable al que se hace referencia en scripts — solo alfanumérico, sin espacios ni caracteres especiales
Tipo	Cómo se recopilan los datos — campo de entrada del usuario, búsqueda en base de datos, valor oculto, etc.
Orden	Orden de visualización dentro de la sección
Mostrar	Etiqueta mostrada en el formulario de entrada del usuario
Valor predeterminado	Respuesta prellenada (opcional)
Validación mediante regex	Expresión regular para validación de entrada (opcional)
Texto de marcador de posición	Texto de sugerencia en gris que muestra el formato de entrada esperado (opcional)
Texto de ayuda emergente	Ventana emergente al pasar el cursor con texto de ayuda (opcional)
Texto de nota	Texto de ayuda mostrado directamente debajo del campo de entrada (opcional)
Al cambiar	JavaScript para mostrar/ocultar otras preguntas según el valor de este campo (opcional)

Referencia de preguntas del sistema

Las siguientes tablas documentan las preguntas del sistema integradas generadas para cada receta de inquilino.

Sección del inquilino

Identidad principal del inquilino, credenciales de administrador y configuración SSL:

Nombre de variable	Etiqueta de visualización	Tipo	Predeterminado	Habilitado de forma predeterminada
YB_URL	URL	Cadena	—	Sí
YB_DESCRIPTION	Descripción	Área de texto	—	Sí
YB_USER_NAME	Usuario administrador	Cadena	admin	Sí
YB_USER_PASSWORD	Contraseña	Contraseña	—	Sí
YB_USER_EMAIL	Correo electrónico	Cadena	—	No
YB_USER_CHANGE_PASSWORD	Requerir cambio de contraseña	Booleano	false	No
YB_EXPOSE_CLOUD_SNAPSHOTS	Exponer instantáneas del sistema	Booleano	true	No
YB_HELP_URL	URL de ayuda	Cadena	predeterminado	No
YB_THEME_ACCESS	Acceso a temas	Lista	host_only	Sí
YB_SPECIFIED_THEME	Tema	Selección de fila	—	Sí
YB_CLUSTER	Clúster	Clúster	—	No
YB_CERT_TYPE	Tipo de certificado SSL	Oculto	manual	No
YB_CERT_DOMAIN	Dominio del certificado SSL	Cadena	—	No
YB_CERT_PUBLIC	Certificado SSL público	Área de texto	—	No
YB_CERT_PRIVATE	Certificado SSL privado	Área de texto	—	No
YB_CERT_CHAIN	Cadena de certificado SSL	Área de texto	—	No

Sección de nodos

Recursos de cómputo asignados a los nodos virtuales del inquilino:

Nombre de variable	Etiqueta de visualización	Tipo	Predeterminado	Habilitado de forma predeterminada
YB_NODE_1_CPU_CORES	Núcleos del nodo 1	Número	8	Sí
YB_NODE_1_RAM	RAM del nodo 1	RAM	16384	Sí
YB_NODE_1_INSTANCES	Instancias del nodo 1	Número	1	No
YB_NODE_1_CLUSTER	Clúster del nodo 1	Clúster	—	No
YB_NODE_1_CLUSTER_FAILOVER	Clúster de conmutación por error del nodo 1	Clúster	—	No

Sección de red

Direcciones de red para la interfaz de usuario del inquilino y la conectividad externa:

Nombre de variable	Etiqueta de visualización	Tipo	Predeterminado	Habilitado de forma predeterminada
YB_NET_1_IP	Dirección IP de la interfaz de usuario	Dirección IP virtual	—	Sí
YB_NET_2_IP	Dirección IP	Dirección IP virtual	—	Sí

Estas son las preguntas predeterminadas del sistema a partir de VergeOS 26.1. Puede agregar preguntas personalizadas además de estas para capturar información adicional como fechas de vencimiento, nombres de host personalizados u otros valores específicos del inquilino.

Preguntas personalizadas

Más allá de las preguntas del sistema, puede agregar preguntas personalizadas para capturar cualquier entrada adicional que requiera su implementación. Las preguntas personalizadas admiten los mismos tipos de campo que las preguntas del sistema, además de varios tipos de interacción con la base de datos (leer/escribir en cualquier objeto de VergeOS).

Tipos comunes de preguntas

Tipo	Propósito	Ejemplo de uso
Cadena	Entrada de texto de una sola línea	Nombre del cliente, nombre del host
Área de texto	Entrada de texto de varias líneas	Notas, fragmentos de configuración
Contraseña	Entrada enmascarada con confirmación	Contraseñas de cuentas de servicio
Número	Entrada numérica	Números de puerto, cantidad de instancias
Booleano	Casilla de verificación (verdadero/falso)	Habilitar/deshabilitar funciones
Lista	Selección desplegable	Elegir entre opciones predefinidas
Oculto	No se muestra en el formulario	Valores codificados para scripts
Red	Selector de red	Elegir red de destino
Dirección IP virtual	Selector de dirección IP	Asignar IP específicas
RAM	Entrada de memoria (en MB)	Asignación adicional de recursos
Clúster	Selector de clúster	Clúster de destino para la colocación

Tipos de interacción con la base de datos

Estos tipos avanzados de preguntas permiten a las recetas leer y escribir en la base de datos de VergeOS durante la creación del inquilino, lo que permite flujos de trabajo de automatización como:

Tipo	Propósito	Ejemplo de uso
Crear en la base de datos	Crear un nuevo registro en la base de datos de VergeOS	Registrar una reserva DHCP, crear una entrada DNS
Editar en la base de datos	Modificar un registro existente en la base de datos	Actualizar una configuración de red, cambiar un ajuste
Buscar en la base de datos	Buscar valores en la base de datos	Recuperar la siguiente IP disponible, encontrar un ID de red

Cada pregunta de base de datos incluye un Contexto de la base de datos campo que determina si la operación se dirige a la base de datos del sistema principal o a la base de datos del inquilino recién creado. Esta distinción es crítica:

• Contexto principal: Registrar la IP del inquilino en el DNS del host, crear una reserva DHCP en la red del host
• Contexto del inquilino: Configurar ajustes dentro del propio nuevo inquilino

Las preguntas de interacción con la base de datos hacen referencia a las tablas API de VergeOS. Consulte la Descripción de las tablas API y Guía de la API para los nombres de tabla, nombres de campo y sintaxis de filtro.

Modificación y republicación de recetas

Cuando modifica una receta (cambia preguntas, actualiza el inquilino base, ajusta valores predeterminados), los cambios no están disponibles de inmediato para los usuarios. Debe republicar la receta:

1. Haga sus cambios en el panel de la receta (edite preguntas, actualice secciones, etc.)
2. Aparece un banner en la parte superior: "La receta debe republicarse para que los cambios surtan efecto"
3. Haga clic en Republicar (desde el enlace del banner o el menú izquierdo)
4. El número de versión se incrementa automáticamente (por ejemplo, 1.0.0-1 → 1.0.0-2)

Cuando se republica una receta, los sistemas remotos y los inquilinos con acceso reciben una notificación de que hay una actualización disponible. Deben descargar explícitamente la actualización para usar la nueva versión.

Instancias de receta

Una instancia es un inquilino que fue creado a partir de una receta y sigue asociado a ella. Puede ver todas las instancias desde el panel de la receta haciendo clic en Instancias en el menú izquierdo.

Reglas clave para las instancias:

• Una receta no puede eliminarse mientras tenga instancias asociadas
• Las instancias pueden ser desvinculadas de su receta para convertirse en inquilinos independientes
• Los inquilinos desvinculados pierden su asociación con la receta pero conservan toda la configuración

Intercambio de recetas: compartición entre sistemas

Las recetas se organizan en repositorios y catálogos, formando una estructura jerárquica:

Tipos de repositorio

• Repositorios locales: Catálogos y recetas creados y mantenidos en el sistema local. Cada sistema VergeOS viene con un repositorio "Local" vacío listo para usar.
• Repositorios remotos: Conéctese a catálogos alojados en un sistema VergeOS separado. Esto elimina la necesidad de mantener las mismas recetas en múltiples ubicaciones.
• Marketplace: Un repositorio remoto proporcionado por VergeOS e instalado previamente en sistemas a nivel de host, que contiene recetas de VM listas para usar. Los catálogos del Marketplace tienen como predeterminado scope=global, lo que los pone a disposición de todos los inquilinos.

Ámbitos de publicación de catálogos

Alcance	Disponibilidad
Privado	Solo el sistema local de VergeOS
Ninguna	Deshabilitado — no disponible en ningún lugar
Inquilino	El sistema local y sus inquilinos directos
Global	El sistema local, los inquilinos y los sistemas externos de VergeOS (con credenciales de API)

Compartir con inquilinos

1. Establezca el ámbito de publicación del catálogo en Inquilino o Global
2. En la interfaz del usuario del inquilino, navegue a la proveedor de servicios repositorio
3. Haga clic en Actualizar para descubrir los catálogos disponibles
4. Descargue las recetas deseadas — el estado muestra En línea cuando está listo

Compartir con sistemas remotos

1. Crea un usuario de tipo API en el sistema que comparte, con permisos de Lista/Leer en el catálogo de destino
2. En el sistema receptor, crea un Repositorio remoto apuntando a la URL del sistema que comparte
3. Autentíquese con las credenciales del usuario de la API
4. Actualice el repositorio para descubrir y descargar los catálogos y recetas disponibles

Cuando se actualizan las recetas en el origen, tanto los inquilinos como los sistemas remotos ven una notificación de que hay una actualización disponible para descargar.

Ejemplo real: oferta de almacenamiento compatible con S3 para CSP

Para ilustrar el poder de las recetas de inquilino, considere este escenario de la Arquitectura de referencia de CSP de VergeOS:

CloudHoster, un proveedor de nube de tamaño mediano, quiere ofrecer a sus clientes un servicio de almacenamiento compatible con S3 llamado "Cloud Storage". En lugar de configurar manualmente el entorno de cada cliente, crean una receta de inquilino que automatiza toda la implementación:

Qué crea la receta

1. Inquilino — Un nuevo VDC con recursos de cómputo y almacenamiento adecuados
2. Red interna — Red aislada para la VM de la aplicación de almacenamiento
3. Reglas de firewall — Configurada para permitir tráfico de la API S3 mientras bloquea todo lo demás
4. VM de almacenamiento — La VM que aloja la aplicación de almacenamiento compatible con S3, preconfigurada
5. Aprovisionamiento de almacenamiento — Nivel de almacenamiento vSAN dedicado asignado al inquilino
6. Registro DNS/DHCP — Registro automático en la red del host

Preguntas de la receta para este caso de uso

La receta solicita al operador (o al portal de autoservicio del cliente):

• Nombre del cliente y URL (Sección de inquilino)
• Credenciales de administrador (generadas automáticamente o manuales)
• Capacidad de almacenamiento (pregunta personalizada — cuánto almacenamiento S3 aprovisionar)
• IP externa (Sección de red — para el punto de conexión de la API S3)
• Recursos del nodo (Sección de nodos — CPU/RAM para la VM de almacenamiento)

Con un solo envío de formulario, CloudHoster implementa un entorno de almacenamiento completo, aislado y compatible con S3 para su cliente — en minutos en lugar de horas.

Escalando la oferta

CloudHoster implementa esta receta en cuatro de sus sitios compartiendo el catálogo mediante un repositorio remoto. Cuando actualizan la receta (por ejemplo, para actualizar la VM de la aplicación de almacenamiento), todos los sitios reciben una notificación y pueden obtener la actualización.

Prácticas recomendadas

Diseño de la receta

• Empiece simple — primero cree un tenant base mínimo, agregue complejidad de forma incremental
• Use nombres de variables descriptivos — STORAGE_CAPACITY_GB es mejor que T1 para el mantenimiento de scripts
• Documente sus recetas — use el campo Descripción y el Texto de nota en las preguntas para orientar a los operadores
• Pruebe con simulación — valide las preguntas y las salidas antes de publicarlas en catálogos de producción

Mantenimiento del tenant base

• Tenants base dedicados — nunca use el tenant base de una receta para cargas de trabajo de producción
• Control de versiones — establezca manualmente los números de versión principales (por ejemplo, 2.0.0) al realizar cambios significativos en el tenant base
• Elimine los datos sensibles — asegúrese de que no existan en la base contraseñas, datos o configuraciones específicos de clientes

Organización

• Nombres de catálogo significativos — agrupe las recetas por propósito (por ejemplo, "VDC estándar", "Cómputo con GPU", "Servicios de almacenamiento")
• Use iconos — los iconos de Font Awesome ayudan a los operadores a identificar rápidamente los tipos de receta en la interfaz de usuario
• Establezca el alcance adecuadamente — use Privado para las recetas solo internas, Tenant para las orientadas al cliente, Global para la distribución multisede

¿Vienes de VMware o Nutanix?

Una receta de tenant de VergeOS aprovisiona un VDC aislado completo en una sola operación — interfaz de administración, usuarios, pila de red, reglas de firewall, almacenamiento y DNS/DHCP — no solo máquinas virtuales o aplicaciones. Para conocer el alcance y las capacidades de cualquier herramienta de automatización de VMware o Nutanix con la que pueda estar comparando, consulte la documentación actual de ese proveedor.