> 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-10-laboratorios-de-escenarios/lab-hci.md).

# Laboratorio: Implementación de HCI

## Objetivo

Implementa VergeOS en configuraciones de Infraestructura Hiperconvergente (HCI) usando el entorno de pruebas de Terraform. Aprovisionarás tanto un clúster mínimo de 2 nodos como un clúster ampliado de 4 nodos, y luego validarás el almacenamiento, la red y la salud general del clúster.

## Requisitos previos

* Completados todos los módulos anteriores (1–9)
* Acceso al repositorio vergeos-terraform-playground (clonado localmente)
* Terraform CLI instalado y configurado
* Un entorno o laboratorio de VergeOS que admita implementaciones anidadas
* Familiaridad con los conceptos básicos de Terraform (init, plan, apply)

## Dificultad

**Intermedio** -- Requiere comprender la arquitectura de VergeOS y el uso básico de Terraform

## Tiempo estimado

**2 horas**

## Pasos

### Parte 1: Implementación HCI de 2 nodos

Implementa la topología HCI mínima.

1. Clona el repositorio vergeos-terraform-playground (si aún no lo has hecho)
2. Revisa el `examples/` directorio e identifica el HCI de 2 nodos `.tfvars` archivo
3. Examina las variables para entender:
   * Cantidad de nodos y funciones
   * Configuración de red (núcleo de la infraestructura, externa)
   * Configuración del nivel de almacenamiento
4. Ejecuta `terraform init` para inicializar el proveedor
5. Ejecuta `terraform plan -var-file=<2-node-hci>.tfvars` y revisa los recursos planificados
6. Ejecuta `terraform apply -var-file=<2-node-hci>.tfvars` para implementar
7. Inicia sesión en la interfaz de VergeOS y verifica:
   * Ambos nodos aparecen en línea en el panel
   * La red de la infraestructura núcleo está establecida
   * El grupo de almacenamiento vSAN está sano y con la capacidad esperada
   * Los roles de nodo controlador están asignados a Node 1 y Node 2 (presencia de almacenamiento de metadatos de Tier 0)

### Parte 2: Implementación HCI de 4 nodos

Escala hasta un clúster HCI de 4 nodos.

1. Identifica el HCI de 4 nodos `.tfvars` archivo en el directorio examples
2. Compáralo con la configuración de 2 nodos -- observa las diferencias en:
   * Cantidad de nodos
   * Ajustes de redundancia del almacenamiento
   * Cualquier configuración de red adicional
3. Implementa la topología de 4 nodos usando `terraform plan` y `terraform apply`
4. En la interfaz de VergeOS, verifica:
   * Los cuatro nodos están en línea y sanos
   * El almacenamiento se ha redistribuido entre todos los nodos
   * La conmutación por error de los nodos controladores (par HA en Node 1 / Node 2) está sana
   * La conectividad de red entre todos los nodos está establecida

### Parte 3: Validación y comparación

Compara las dos implementaciones y valida la preparación para producción.

1. Crea una VM de prueba en cada clúster y verifica que se inicie correctamente
2. Prueba la migración en vivo de la VM entre nodos
3. Compara el uso de recursos entre las implementaciones de 2 nodos y 4 nodos
4. Documenta las diferencias en:
   * Redundancia y capacidad de almacenamiento
   * Margen de cómputo
   * Consideraciones sobre el dominio de fallo
5. Limpia ambas implementaciones con `terraform destroy`

## Verificación

Tu laboratorio de implementación HCI está completo cuando puedas responder **sí** a todo lo siguiente:

* [ ] Implementaste con éxito una topología HCI de 2 nodos mediante Terraform
* [ ] Implementaste con éxito una topología HCI de 4 nodos mediante Terraform
* [ ] Verificaste la salud del clúster, los pools de almacenamiento y la red en la interfaz de VergeOS
* [ ] Creaste y migraste una VM de prueba en al menos un clúster
* [ ] Documentaste las diferencias clave entre las implementaciones HCI de 2 nodos y 4 nodos
* [ ] Limpiaste todos los recursos del laboratorio con `terraform destroy`


---

# 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-10-laboratorios-de-escenarios/lab-hci.md?ask=<question>&goal=<endgoal>
```

`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.
