00 Setup — instructor notes
Preflight the room, choose the source deployment path, and keep credentials out of shared surfaces.
Before the session
- Confirm the
build-workshop-v1branch containsworkshops/elasticsearch_migration_lab. - Test the local path on a 16 GB machine and keep an EC2 fallback ready.
- Confirm ClickHouse Cloud sign-up is available in the participants' region.
- Put the learner setup module on screen.
Talk track
Explain the four checkpoints: source, target provisioned, parallel run, and cutover. The parallel run is the safety mechanism; it is not an optional demo flourish.
Common failures
- Docker has less than 16 GB available: use EC2 or pair participants.
jqis missing: install it before module 02, where almost every inspection command uses it.- Learner cloned the default branch: run
git switch build-workshop-v1and repeat the file checks.
End checkpoint
Every learner can locate all four part directories and run the version checks. Do not start the large image pull in module 01 until this is true.