Suivre cet atelier en autonomie

Cet atelier est conçu pour se dérouler en salle avec un formateur, mais tout ce dont vous avez besoin pour le terminer seul figure déjà dans ce guide. Si vous parcourez le dépôt de votre côté, ou si quelqu’un vous l’a transmis après l’événement, cette page vous sert de carte.

Choisissez macOS ou Windows dans l’en-tête de la page avant la configuration. Sous Windows, exécutez toutes les commandes de l’atelier dans Ubuntu sur WSL 2 ; PowerShell n’apparaît que dans les blocs expressément consacrés à l’amorçage ou à la récupération sous Windows.

Ce qui change sans formateur

Réponse courte : rien dans les modules 00 à 07. Le parcours principal est entièrement en libre-service. Vous créez votre propre essai ClickHouse Cloud, votre propre Postgres managé par ClickHouse avec clickhousectl (module 03) et vos propres clés API ; vous ne dépendez d’aucune ressource partagée. Les modules 04 à 09 sont également inchangés.

Un formateur fournit normalement deux types d’aide, qui disposent chacun d’un équivalent en libre-service dans ces ressources :

• La permanence de configuration (module 00) est remplacée par ./preflight.sh dans ClickHouse_Demos/workshops/build_workshop/app, qui contrôle tous les points susceptibles de faire échouer le démarrage en direct, et par la page de Dépannage, qui répertorie chaque problème rencontré pendant les tests avec sa correction exacte.
• Le déblocage en direct pendant un module est remplacé par deux éléments : votre agent de programmation qui joue le rôle de formateur (ci-dessous) et le parcours formateur qui vous sert de corrigé (ci-dessous).

Le parcours formateur vous sert de corrigé

Le parcours formateur est publié dans ce même guide. Chaque module possède une page formateur correspondante indiquant sa durée, les problèmes qui se produisent réellement et la manière de les résoudre, ainsi que les procédures de réinitialisation pour revenir à un état opérationnel connu. Si un module ne se comporte pas comme le prévoit son étape de vérification, ouvrez la page formateur correspondante : elle est précisément faite pour ce moment.

Votre agent de programmation est votre formateur

Vous avez déjà chargé les compétences de l’agent ClickHouse et connecté le MCP ClickHouse distant à votre agent de programmation au module 00. Ce même agent peut très bien faire office de formateur. Collez-lui le bloc ci-dessous en renseignant le numéro du module et ce que vous observez :

You are my workshop instructor. The workshop lives in this repo: the app is in workshops/build_workshop/app/, infrastructure notes are in workshops/build_workshop/infra/README.md, and the playbook markdown (learner and instructor tracks) is in site/content/docs/build-workshop. I am on module NN and stuck: <describe what you see>. Read the relevant module page and the troubleshooting page, inspect my local state (docker compose ps, container logs, and .env.workshop WITHOUT printing any secret values), and walk me to the module's verify step.

Grâce aux compétences et au MCP du module 00, l’agent peut aussi interroger directement votre service Cloud pendant qu’il vous aide. Il peut ainsi vérifier si vos tables, votre pipeline ou votre télémétrie sont effectivement arrivés, au lieu de se contenter de lire la documentation.

Pour que le rôle de formateur persiste d’une session à l’autre sans avoir à recoller ces instructions, placez-les dans le fichier d’instructions de projet de votre outil : CLAUDE.md pour Claude Code, AGENTS.md pour Codex CLI et .cursor/rules/ (ou AGENTS.md, également lu par Cursor) pour Cursor. Chaque outil charge automatiquement ce fichier à la racine du dépôt ; les consignes restent donc en contexte à chaque ouverture de l’atelier.

Conseils de rythme

Les durées par module indiquées dans la vue d’ensemble supposent une session où les inscriptions aux comptes ont été effectuées à l’avance. En autonomie, le module 00 prend l’essentiel du temps : les trois inscriptions dans le navigateur (ClickHouse Cloud, Langfuse et OpenAI) demandent chacune 5 à 10 minutes, principalement en attente de la vérification par e-mail ou téléphone. L’encadré « créez les comptes avant le jour de l’atelier » de 00 Configuration est encore plus important lorsque vous êtes seul : effectuez d’abord les trois inscriptions, revenez avec vos clés, et le reste du module 00 sera rapide. Les modules 01 à 09 respectent ensuite d’assez près leurs durées annoncées.

Vous ne serez jamais bloqué : la section Point de départ de chaque module indique exactement ce qui doit être en place. Vous pouvez donc interrompre l’atelier et le reprendre plus tard au même endroit.

Pour aller plus loin