Trilha do instrutor
Roteiro geral da sessão, lista de recursos compartilhados e notas do facilitador para cada módulo.
Esta trilha é o material de apoio do facilitador para a trilha do participante. Cada módulo do participante tem uma página de notas correspondente aqui, com quatro seções: Cronograma, Roteiro de apresentação, Falhas comuns e Etapas de redefinição. Leia primeiro esta página inicial para ter uma visão geral da sessão.
O percurso do participante é compatível com macOS e Windows. No Windows, ele usa o Ubuntu no WSL 2 com a integração do Docker Desktop. Peça a todos que escolham seu computador no cabeçalho da página antes da clínica de configuração e oriente os participantes no Windows a permanecer no terminal do Ubuntu após a inicialização.
A trilha do participante também inclui uma página sobre como fazer este workshop no seu próprio ritmo para quem estiver participando sem instrutor. Ela direciona essas pessoas a estas notas como gabarito (e ao gabarito de falhas do módulo 07 apenas como último recurso), portanto mantenha esta trilha atualizada também para esse público.
Roteiro da sessão
A sessão dura três horas. A tabela abaixo mostra a distribuição inicial; ajuste-a durante o ensaio e registre aqui os tempos definitivos.
| Módulo | Lição do participante | Tempo previsto | Notas |
|---|---|---|---|
| 00 | Configuração | 25 min | Inicie as etapas que podem rodar em segundo plano (criação do serviço, docker compose up) antes da apresentação |
| 01 | ClickHouse Cloud | 15 min | Primeiro momento de impacto com a velocidade das consultas |
| 02 | Aplicativo-base | 5 min | Não há nada para construir; seja breve |
| 03 | CDC com Postgres gerenciado | 20 min | Cada participante cria uma instância gerenciada; mantenha um conjunto de contingência gerenciado na nuvem |
| 04 | ClickHouse Agents | 10 min | Ferramenta em versão beta; tenha uma pergunta alternativa pronta |
| 05 | ClickStack | 15 min | A telemetria precisa de tempo para se acumular antes do módulo 07 |
| 06 | SRE com IA | 15 min | O OAuth do MCP é o momento mais delicado; deixe a configuração preparada |
| 07 | Identificar e corrigir falhas | 20 min | Benefício direto do módulo 06; é importante controlar o horário-limite |
| 08 | Chat e Langfuse | 15 min | As chaves já foram definidas no módulo 00; reinicie e faça o tour dos traces |
| 09 | Encerramento | 10 min | Voluntários fazem demonstrações; redefina qualquer estado compartilhado |
Esses tempos somam aproximadamente 2 horas e 30 minutos de trabalho prático; o restante da sessão de três horas cobre a abertura, as transições entre os módulos e as demonstrações finais.
Ajuste o cronograma durante o ensaio
Os tempos acima são a distribuição inicial. Valide cada um durante o ensaio cronometrado e defina um horário inegociável para encerrar o laboratório de incidentes (módulo 07), para que o módulo 08 e o encerramento nunca fiquem espremidos.
Lista de recursos compartilhados
Alguns recursos de contingência são compartilhados por toda a turma. Antes da abertura das portas, confirme se cada um está provisionado e funcionando:
- Conjunto de contingência do Postgres gerenciado — instâncias hospedadas na nuvem apenas para participantes cuja organização não permita criar uma. O percurso principal prevê um Postgres gerenciado pelo ClickHouse para cada participante.
- Serviços de reserva do ClickHouse Cloud — um pequeno conjunto para participantes cujo período de avaliação falhar. PENDENTE: tamanho do conjunto e método de distribuição.
- Conjunto de chaves de LLM em tempo de execução — chaves de contingência com limite de gastos para o chat no aplicativo (módulo 08).
- Projetor e canal compartilhado — para as demonstrações finais.
- Rede do local — largura de banda simétrica suficiente, sem portal cativo e compatível com OAuth.
- Ensaio em diferentes plataformas — uma execução limpa no macOS e outra no Windows/WSL 2, incluindo integração do Docker, OAuth do MCP no navegador, verificação prévia e redefinições de branches do módulo 07.
Clínica de configuração
As portas abrem mais cedo para uma clínica de configuração com equipe de apoio. Quem não tiver concluído toda a preparação prévia deve chegar nesse horário. PENDENTE: confirmar o horário de início e a equipe da clínica.