> 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/learn-the-platform/es/modulo-7-multiinquilinato/02-creating-tenants.md).
# Creación y configuración de inquilinos
## Métodos de creación de inquilinos
VergeOS ofrece tres métodos para crear nuevos inquilinos, cada uno adecuado para diferentes escenarios:
```mermaid
flowchart LR
START["Crear inquilino"] --> W["Asistente"]
START --> C["Clonar"]
START --> R["Receta"]
W --> WD["Configuración personalizada
formularios paso a paso"]
C --> CD["Duplicar inquilino existente
como plantilla"]
R --> RD["Despliegue automatizado
desde plantilla predefinida"]
style W fill:#e3f2fd,stroke:#1565c0
style C fill:#fff3e0,stroke:#e65100
style R fill:#e8f5e9,stroke:#2e7d32
```
| Método | Mejor para | Características clave |
| ------------- | -------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| **Asistente** | Inquilinos únicos o puntuales | Formularios paso a paso para configuración, nodos, almacenamiento y administración de la interfaz |
| **Clonar** | Duplicación de un inquilino existente | Crea una copia de un inquilino en ejecución o detenido para pruebas, desarrollo o aprovisionamiento rápido |
| **Recetas** | Implementaciones estandarizadas y repetibles | Aprovisionamiento automatizado desde una plantilla predefinida con campos de entrada personalizables |
Se accede a los tres métodos desde el mismo punto de partida: **Inquilinos > + Nuevo inquilino** en la interfaz de VergeOS.
## Recorrido del Asistente de inquilino
El Asistente de inquilino te guía a través de múltiples formularios de entrada para crear un inquilino completamente personalizado. Este es el método más común para crear tus primeros inquilinos o construir entornos puntuales.
### Paso 1: Formulario de configuración del inquilino
1. Vaya a **Inquilinos** desde el menú superior
2. Haga clic en **+ Nuevo inquilino**
3. Selecciona **Desde el asistente** en la parte superior izquierda, luego haz clic en **Siguiente**
El formulario de configuración del inquilino presenta los siguientes campos:
| Campo | Descripción | Requerido |
| -------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- |
| **Nombre** | Nombre visible del inquilino | Sí |
| **URL** | Enlace a la interfaz del inquilino -- se completa automáticamente cuando se asigna la primera IP externa | No |
| **Contraseña del usuario administrador** | Contraseña para el usuario root "admin" creado automáticamente | Sí |
| **Confirmar contraseña del usuario administrador** | Vuelve a introducir la contraseña de administrador para confirmar que coincide | Sí |
| **Requerir cambio de contraseña** | Obliga al administrador del inquilino a cambiar la contraseña en el primer inicio de sesión | No |
| **Descripción** | Notas adicionales o metadatos sobre el inquilino | No |
| **Exponer instantáneas del sistema** | Permite que el inquilino explore las instantáneas del sistema principal y descargue por su cuenta su propia instantánea del inquilino desde las marcas de tiempo de instantáneas del proveedor (habilitado de forma predeterminada) | No |
| **Acceso a temas** | Controla si el inquilino puede crear temas y/o acceder a los temas del host | No |
| **URL de ayuda personalizada** | Redirige los enlaces de ayuda del inquilino a un sitio de documentación alternativo | No |
| **Aplicación OIDC** | Define una fuente de autorización para el inquilino (a partir de aplicaciones OIDC definidas por el padre) | No |
La **Acceso a temas** las opciones controlan las capacidades de marca:
* **No puede crear nuevos temas, acceso de solo lectura a todos los temas del host** -- el inquilino puede usar pero no modificar los temas del host
* **No puede crear nuevos temas, acceso de solo lectura a los temas del host especificados** -- el inquilino solo puede ver los temas seleccionados
* **Puede crear nuevos temas, sin acceso a los temas del host** -- el inquilino crea su propia marca desde cero
* **Puede crear nuevos temas, acceso de solo lectura a los temas del host** -- total flexibilidad con los temas del host como referencia
### Paso 2: Formulario de nuevo nodo del inquilino
Este formulario configura el nodo inicial del inquilino. Se pueden añadir nodos adicionales del inquilino después de completar el asistente.
| Campo | Descripción | Notas |
| ------------------------------------ | ---------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
| **Núcleos** | Número de núcleos de CPU asignados al nodo del inquilino | Tamaño basado en las cargas de trabajo esperadas |
| **RAM** | Cantidad de memoria asignada al nodo del inquilino | Tamaño basado en las cargas de trabajo esperadas |
| **Clúster** | Clúster físico para ejecutar el nodo del inquilino | Déjalo en --Default-- a menos que se apunte a un clúster específico |
| **Clúster de conmutación por error** | Clúster a usar si el principal no está disponible | Déjalo en --Default-- para despliegues estándar |
| **Nodo preferido** | Fijar el nodo del inquilino a un nodo físico específico | **No recomendado** -- puede afectar negativamente a la redundancia |
| **Al perder energía** | Comportamiento cuando el sistema anfitrión se recupera tras una pérdida de energía | **Último estado** (predeterminado), **Dejar apagado**, o **Encender** |
{% hint style="warning" %}
Establecer un **Nodo preferido** es una configuración avanzada que puede romper la redundancia HA integrada. Consulta al soporte de VergeOS antes de usar esta opción.
{% endhint %}
### Paso 3: Formulario de almacenamiento del nuevo inquilino
| Campo | Descripción |
| ------------------------------- | ------------------------------------------------------------------------------------- |
| **Nivel** | Qué nivel de almacenamiento vSAN usar para el volumen de almacenamiento del inquilino |
| **Capacidad de almacenamiento** | Cantidad de almacenamiento a aprovisionar para el inquilino |
El inquilino recibe un volumen de almacenamiento dedicado del nivel seleccionado. Este volumen proporciona aislamiento exclusivo del almacenamiento -- los datos del inquilino quedan completamente segregados a nivel de volumen.
### Paso 4: Formulario de administración de la interfaz
El paso final asigna opcionalmente una dirección IP externa al inquilino, lo que permite el acceso a la interfaz de administración del inquilino.
1. Selecciona una IP del **Asignar IP externa** desplegable (enumera todas las IP virtuales no asignadas en el padre)
2. Si no existe una IP adecuada, haz clic en **Crear una nueva IP externa** para definir una:
* **Red** -- selecciona la red externa adecuada
* **Tipo** -- IP virtual
* **Dirección IP** -- introduce la dirección o déjalo en blanco para autoasignar la siguiente disponible
* **Propietario** -- nombre del nuevo inquilino
3. Haga clic en **Enviar** para completar la creación del inquilino
Si un inquilino **Proxy** está configurado, el formulario de administración de la interfaz también ofrece una **Crear un nuevo FQDN** opción en lugar de asignar una IP externa. Al seleccionarla, se abre una **Configuración del inquilino proxy** página donde eliges la red del proxy, el inquilino y el FQDN (el registro A que apunta al alias IP del proxy); luego haz clic en **Omitir** en la parte inferior de la página de administración de la interfaz para evitar asignar una IP directa. Un inquilino no puede tener tanto una dirección IP de interfaz como un FQDN proxy.
{% hint style="success" %}
Una "IP externa" es cualquier dirección externa al sistema VergeOS -- puede ser una dirección pública de Internet o una dirección privada en tu LAN/WAN externa (p. ej., `10.10.10.100`).
{% endhint %}
Después de la creación, aparece el panel del inquilino. Haz clic en **Encender** en el menú izquierdo para iniciar el inquilino. Si se asignaron IP externas, haz clic en el mensaje naranja **Necesita aplicar reglas** para aplicar las reglas de red necesarias.
## Clonación de inquilinos
Clonar crea un duplicado de un inquilino existente, lo que lo hace útil para escenarios de pruebas, desarrollo, restauraciones y aprovisionamiento rápido.
### Recorrido de clonación
1. Vaya a **Inquilinos > + Nuevo inquilino**
2. Selecciona **Clonar existente** en la parte superior izquierda
3. Selecciona el inquilino de origen de la **Selecciones disponibles** lista, luego haz clic en **Siguiente**
4. Modificar los **Nombre** según sea necesario (el valor predeterminado es `clon de `)
5. Opcionalmente selecciona **Clonar como nuevo inquilino** para eliminar del clon el historial, las estadísticas, los registros y las instantáneas con caducidad
6. Haga clic en **Enviar**
El inquilino clonado aparece en su propio panel, listo para encenderse.
### Consideraciones sobre la clonación
{% hint style="warning" %}
Al clonar inquilinos, ten en cuenta posibles conflictos:
* **Direcciones MAC** -- las máquinas virtuales clonadas reciben las mismas direcciones MAC que la original. Ejecutar ambas en la misma red de Capa 2 provoca conflictos
* **Direcciones IP** -- las configuraciones IP estáticas se duplicarán, causando conflictos si ambos inquilinos comparten la misma red externa
* **Instancias de aplicaciones** -- servicios como Active Directory, DNS o DHCP pueden entrar en conflicto si tanto el original como el clon están activos simultáneamente
La **Clonar como nuevo inquilino** se recomienda la opción cuando no se necesitan el historial ni los registros del inquilino de origen, ya que crea un punto de partida más limpio.
{% endhint %}
## Modificaciones del inquilino
Después de crear un inquilino, su configuración puede modificarse desde el panel del inquilino:
* **Añadir nodos del inquilino** -- amplía la capacidad de cómputo añadiendo nodos adicionales del inquilino con sus propias asignaciones de núcleos/RAM
* **Ajustar almacenamiento** -- aumentar (o disminuir) la asignación de almacenamiento del inquilino
* **Modificar ajustes** -- cambiar el nombre del inquilino, la descripción, la contraseña de administrador, el acceso a temas, la configuración OIDC y otros ajustes
* **Gestionar redes** -- crear redes internas adicionales, ajustar reglas de firewall y configurar el enrutamiento dentro del inquilino
Todas las modificaciones se realizan desde la vista del sistema principal del panel del inquilino o desde la propia interfaz de administración del inquilino.
## Asignación de direcciones IP externas
Las direcciones IP externas proporcionan a los inquilinos conectividad con redes fuera del sistema VergeOS -- ya sea Internet pública o una WAN/LAN privada. Cuando se asigna una IP externa, las reglas de enrutamiento adecuadas se crean automáticamente.
### Asignación de una sola IP
**Desde el sistema anfitrión/principal:**
1. Vaya a **Redes > Externa** (tu red externa raíz)
2. Haga clic en **Direcciones IP** en el menú izquierdo
3. Haga clic en **Nuevo** y configura:
* **Tipo:** IP virtual
* **Dirección IP:** Introduce la dirección externa (p. ej., `203.0.113.50`)
* **Tipo de propietario:** Inquilino
* **Propietario:** Selecciona el inquilino de destino
4. Haga clic en **Enviar**
5. Vuelve al panel de la red externa y haz clic en **Aplicar reglas**
**Desde dentro del inquilino:**
1. Inicia sesión en la interfaz del inquilino
2. Vaya a **Redes > Externa**
3. La IP asignada aparece en la **Direcciones IP** lista con la descripción "IP externa del proveedor de servicios"
4. Haga clic en **Aplicar reglas** en la red externa del inquilino
### Uso de bloques de red
Para inquilinos que necesitan varias IP externas, **Bloques de red** asignan un grupo de IPs como una sola unidad:
1. Navega hasta la red **Externa** raíz
2. Haga clic en **Bloques de red** en el menú izquierdo
3. Haga clic en **Nuevo** e introduce el bloque en formato CIDR (p. ej., `203.0.113.48/29`)
4. Establece **Tipo de propietario** a Inquilino y selecciona el inquilino
5. Haga clic en **Enviar**
{% hint style="info" %}
Los bloques de red requieren un mínimo de 4 IPs (/30) para entregar 1 dirección utilizable, ya que el bloque utiliza sobrecarga de dirección de red, puerta de enlace y broadcast. Un bloque /29 (8 IPs) proporciona 5 direcciones utilizables.
{% endhint %}
## Compartir archivos con los inquilinos
Los proveedores de servicios pueden compartir archivos (imágenes ISO, archivos multimedia, imágenes de disco) desde el sistema principal directamente en la sección **Archivos** del inquilino. Esto utiliza una operación de rama eficiente en el vSAN, por lo que es casi instantáneo independientemente del tamaño del archivo.
### Compartir un archivo
1. Vaya a **Inquilinos > Lista** y haz doble clic en el inquilino de destino
2. Haga clic en **Añadir archivo** en el menú izquierdo
3. Selecciona el **Tipo de archivo** en el desplegable (o selecciona **TODO** para ver todos los archivos disponibles, incluidos `.raw` imágenes de disco)
4. Elige el archivo específico del desplegable
5. Haga clic en **Enviar**
El archivo está disponible inmediatamente dentro de la **Archivos** sección. Como esta operación utiliza una rama vSAN (similar a una referencia de instantánea), no duplica los datos en disco -- simplemente proporciona al inquilino una referencia a los bloques existentes.
## Compartir instantáneas de VM
La **Objetos compartidos** la función proporciona compartición de VM basada en instantáneas entre un proveedor y un inquilino (o viceversa). Cualquiera de las partes puede poner a disposición de la otra una instantánea específica de la VM para crear una nueva VM dentro de su propio sistema.
### Desde el sistema emisor
1. Navega al panel de la VM que deseas compartir
2. Apaga la VM correctamente (mejor práctica)
3. Expande **Instantáneas** en el menú izquierdo y haz clic en **Tomar instantánea**
4. Proporciona una **Nombre** y **Fecha de caducidad**, luego haz clic en **Enviar**
5. Vaya a **Sistema > Objetos compartidos**
6. Haga clic en **Nuevo** y configura:
* **Nombre** -- identificador del objeto compartido (se convierte en el nombre de la VM importada)
* **Tipo** -- Máquina virtual
* **Instantánea** -- selecciona la instantánea de VM que creaste
* **Receptor** -- selecciona el inquilino de destino (o proveedor de servicios)
7. Haga clic en **Enviar**
### Desde el sistema receptor
1. Vaya a **Sistema > Objetos compartidos**
2. Los objetos compartidos entrantes aparecen en la lista
3. Selecciona la VM deseada y haz clic en **Importar**
4. Opcionalmente desmarca **Conservar direcciones MAC** si la VM de origen seguirá activa (evita conflictos de MAC)
5. Opcionalmente selecciona un **Nivel preferido** para las unidades de la nueva VM
6. Haga clic en **Enviar** para completar la importación
La VM importada aparece en la lista de VMs del inquilino, lista para ser configurada y encendida.
```mermaid
sequenceDiagram
participant P as Padre/Proveedor
participant SO as Objetos compartidos
participant T as Inquilino
P->>P: Tomar instantánea de la VM
P->>SO: Crear objeto compartido
(Tipo: VM, Receptor: Inquilino)
SO-->>T: El objeto aparece como "Entrante"
T->>SO: Seleccionar e importar VM
SO->>T: VM creada en el inquilino
(nuevas direcciones MAC opcionales)
T->>T: Configurar y encender
```
{% hint style="info" %}
**¿Vienes de VMware o Nutanix?**
Los Objetos compartidos de VergeOS permiten que el proveedor y el inquilino intercambien VMs por referencia — sin copias completas de disco, y el mismo mecanismo funciona en ambas direcciones. Se toma una instantánea de la VM, se crea un Objeto compartido dirigido al inquilino receptor, y el receptor lo importa; los bloques subyacentes del vSAN se referencian en lugar de copiarse.
{% endhint %}
## Resumen
VergeOS ofrece una creación flexible de inquilinos mediante tres métodos -- el **Asistente** para inquilinos personalizados puntuales, **Clonación** para duplicar entornos existentes, y **Recetas** para despliegues automatizados y estandarizados. Después de la creación, los inquilinos pueden configurarse con direcciones IP externas para conectividad de red, archivos compartidos para medios e imágenes, y instantáneas compartidas de VM para la distribución de cargas de trabajo. Cada una de estas operaciones aprovecha la arquitectura nativa vSAN de VergeOS para mayor eficiencia, y el aislamiento arquitectónico del inquilino garantiza que todos los recursos compartidos queden correctamente segregados una vez importados en el propio entorno del inquilino.
En la siguiente sección, exploraremos **Recetas de inquilino** -- el marco de automatización que permite el aprovisionamiento rápido y estandarizado de VDC a escala.
---
# 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/learn-the-platform/es/modulo-7-multiinquilinato/02-creating-tenants.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.