00 Preparación

Instala las herramientas necesarias, crea una cuenta de ClickHouse Cloud, clona el repositorio y verifica los artefactos del taller.

Punto de partida

Necesitas un terminal, una máquina capaz de ejecutar Docker y unos 15 minutos. Decide si la pila de origen de Elasticsearch se ejecutará localmente o en EC2 antes de comenzar el módulo 01.

Paso 1 — Instalar las herramientas

Requisito	Versión u observación
Docker Engine y Compose	Docker 24 o posterior; Compose 2.20 o posterior
Memoria disponible	16 GB como mínimo; se recomiendan 32 GB
Disco	Al menos 5 GB libres
`curl` y `jq`	Utilizados por los scripts de validación
ClickHouse CLI	Utilizada para DDL, diccionarios y validación
Terraform	1.5 o posterior, solo para la opción de origen en EC2
Cuenta de AWS y par de claves de EC2	Solo para la opción de origen en EC2

Instala la CLI de ClickHouse y crea una cuenta de prueba de ClickHouse Cloud antes del módulo 03.

Paso 2 — Clonar los artefactos

git clone https://github.com/ClickHouse/ClickHouse_Demos.git
cd ClickHouse_Demos
git switch build-workshop-v1
cd workshops/elasticsearch_migration_lab

El manual alojado contiene las instrucciones y las soluciones. Este directorio solo contiene los archivos que ejecutarás o editarás: Docker Compose, Terraform, configuraciones del collector, SQL, dashboards, scripts de validación y hojas de diseño. La Parte 4 se completa de forma interactiva en el manual.

Paso 3 — Verificar el checkout

test -f part1/docker/docker-compose.source.yml
test -f part2/exercises/worksheet.md
test -f part3/clickhouse/schema.sql
docker --version
docker compose version
jq --version

Si vas a utilizar la opción EC2, ejecuta también:

terraform version
aws sts get-caller-identity

Comprobaciones de la arquitectura

El taller avanza por cuatro estados deliberados:

Origen: Filebeat y el collector de OTel Demo alimentan Elasticsearch y Elastic APM.
Destino aprovisionado: las tablas, los diccionarios y las vistas materializadas de ClickHouse existen, pero no reciben datos.
Ejecución paralela: ambos collectors escriben en Elasticsearch y ClickHouse para comprobar la paridad.
Transición: los collectors escriben solo en ClickHouse y HyperDX se convierte en la interfaz de observabilidad.

Cómo verificar que has terminado

Los tres comandos test -f terminan correctamente.
Docker y Compose muestran versiones iguales o superiores a los mínimos indicados.
Puedes iniciar sesión en ClickHouse Cloud.
Si utilizas EC2, las comprobaciones de Terraform y de identidad de AWS pasan.

Continúa en 01 Construir el entorno de origen.