00 Préparation

Installez les outils requis, créez un compte ClickHouse Cloud, clonez le dépôt et vérifiez les ressources de l'atelier.

Point de départ

Vous avez besoin d'un terminal, d'une machine capable d'exécuter Docker et d'environ 15 minutes. Avant de commencer le module 01, choisissez si l'environnement source Elasticsearch s'exécutera localement ou sur EC2.

Étape 1 — Installer la chaîne d'outils

Prérequis	Version ou remarque
Docker Engine et Compose	Docker 24 ou version ultérieure ; Compose 2.20 ou version ultérieure
Mémoire disponible	16 Go au minimum ; 32 Go recommandés
Disque	Au moins 5 Go disponibles
`curl` et `jq`	Utilisés par les scripts de validation
CLI ClickHouse	Utilisée pour le DDL, les dictionnaires et la validation
Terraform	Version 1.5 ou ultérieure, uniquement pour l'option de source EC2
Compte AWS et paire de clés EC2	Uniquement pour l'option de source EC2

Installez la CLI ClickHouse et créez un compte d'essai ClickHouse Cloud avant le module 03.

Étape 2 — Cloner les ressources

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

Le guide hébergé contient les instructions et les corrigés. Ce répertoire ne contient que les fichiers à exécuter ou modifier : Docker Compose, Terraform, configurations des collecteurs, SQL, tableaux de bord, scripts de validation et fiches de conception. La partie 4 s'effectue de manière interactive dans le guide.

Étape 3 — Vérifier le dépôt extrait

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 vous utilisez l'option EC2, exécutez également :

terraform version
aws sts get-caller-identity

Jalons d'architecture

L'atelier passe par quatre états délibérés :

Source : Filebeat et le collecteur OTel Demo alimentent Elasticsearch et Elastic APM.
Cible provisionnée : les tables, dictionnaires et vues matérialisées ClickHouse existent, mais ne reçoivent aucune donnée.
Exécution parallèle : les deux collecteurs écrivent à la fois dans Elasticsearch et ClickHouse afin d'en vérifier l'équivalence.
Bascule : les collecteurs écrivent uniquement dans ClickHouse et HyperDX devient l'interface d'observabilité.

Comment vérifier que vous avez terminé

Les trois commandes test -f se terminent sans erreur.
Docker et Compose affichent des versions égales ou supérieures aux minimums indiqués.
Vous pouvez vous connecter à ClickHouse Cloud.
Si vous utilisez EC2, les contrôles Terraform et d'identité AWS réussissent.

Passez à 01 Construction de l'environnement source.