00 Configuração

Instale as ferramentas necessárias, crie uma conta do ClickHouse Cloud, clone o repositório e verifique os artefatos do workshop.

Ponto de partida

Você precisa de um terminal, uma máquina capaz de executar o Docker e cerca de 15 minutos. Escolha se a stack de origem do Elasticsearch será executada localmente ou no EC2 antes de iniciar o módulo 01.

Etapa 1 — Instalar as ferramentas

Requisito	Versão ou observação
Docker Engine e Compose	Docker 24 ou mais recente; Compose 2.20 ou mais recente
Memória disponível	Mínimo de 16 GB; 32 GB recomendados
Disco	Pelo menos 5 GB livres
`curl` e `jq`	Usados pelos scripts de validação
ClickHouse CLI	Usado para DDL, dicionários e validação
Terraform	1.5 ou mais recente, somente para a opção de origem no EC2
Conta AWS e par de chaves do EC2	Somente para a opção de origem no EC2

Instale o ClickHouse CLI e crie uma conta de avaliação do ClickHouse Cloud antes do módulo 03.

Etapa 2 — Clonar os artefatos

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

O playbook hospedado contém as instruções e os gabaritos. Este diretório contém somente os arquivos que você executa ou edita: Docker Compose, Terraform, configurações do collector, SQL, dashboards, scripts de validação e planilhas de projeto. A Parte 4 é concluída de forma interativa no playbook.

Etapa 3 — Verificar o 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

Se for usar a opção EC2, execute também:

terraform version
aws sts get-caller-identity

Checkpoints da arquitetura

O workshop percorre quatro estados planejados:

Origem: o Filebeat e o collector do OTel Demo alimentam o Elasticsearch e o Elastic APM.
Destino provisionado: as tabelas, os dicionários e as views materializadas do ClickHouse existem, mas não recebem dados.
Execução paralela: os dois collectors fazem gravação dupla no Elasticsearch e no ClickHouse para as verificações de paridade.
Transição: os collectors gravam somente no ClickHouse e o HyperDX se torna a interface de observabilidade.

Como verificar se você concluiu

Os três comandos test -f são encerrados com sucesso.
O Docker e o Compose mostram versões iguais ou superiores aos mínimos indicados.
Você consegue entrar no ClickHouse Cloud.
Se estiver usando o EC2, as verificações de identidade do Terraform e da AWS são bem-sucedidas.

Continue em 01 Criar o ambiente de origem.