Menjalankan workshop ini secara mandiri

Workshop ini dirancang untuk dijalankan di ruangan bersama instruktur, tetapi semua yang Anda butuhkan untuk menyelesaikannya sendiri sudah ada di playbook ini. Jika Anda mengerjakan repositori ini sendiri - atau seseorang membagikannya kepada Anda setelah acara - halaman ini adalah peta Anda.

Pilih macOS atau Windows di header halaman sebelum setup. Learner Windows menjalankan semua perintah workshop di Ubuntu pada WSL 2; PowerShell hanya muncul di blok bootstrap dan pemulihan Windows yang diberi label secara eksplisit.

Apa yang berubah tanpa instruktur

Jawaban singkatnya: tidak ada, pada modul 00 hingga 07. Jalur utamanya sepenuhnya self-serve. Anda membuat trial ClickHouse Cloud sendiri, Postgres Anda sendiri yang dikelola ClickHouse dengan clickhousectl (modul 03), dan kunci API Anda sendiri - tidak ada sumber daya bersama yang Anda bergantung padanya. Modul 04 hingga 09 juga sama.

Instruktur biasanya menyediakan dua hal, dan masing-masing punya pengganti self-serve yang sudah dibangun ke dalam materi ini:

• Klinik setup berpendamping (modul 00) digantikan oleh ./preflight.sh di ClickHouse_Demos/workshops/build_workshop/app, yang memeriksa semua hal yang membuat bring-up langsung tersandung, dan halaman Troubleshooting, yang memuat setiap kegagalan yang terlihat saat pengujian beserta perbaikan tepatnya.
• Bantuan langsung saat macet di tengah modul digantikan oleh dua hal: coding agent Anda yang berperan sebagai instruktur (di bawah), dan jalur instruktur sebagai kunci jawaban Anda (di bawah).

Jalur instruktur adalah kunci jawaban Anda

Jalur Instructor diterbitkan dalam playbook yang sama ini. Setiap modul punya halaman instruktur yang bersesuaian dengan waktunya, kegagalan yang benar-benar terjadi dan cara mengatasinya, serta langkah reset untuk kembali ke kondisi yang diketahui baik. Ketika sebuah modul tidak berperilaku seperti yang diharapkan langkah verifikasinya, buka halaman instruktur yang bersesuaian - halaman itu ditulis persis untuk momen tersebut.

Coding agent Anda adalah instruktur Anda

Anda sudah memuat keahlian agent ClickHouse dan menghubungkan ClickHouse MCP jarak jauh ke coding agent Anda di modul 00. Agent yang sama itu menjadi instruktur workshop yang mumpuni. Tempel blok di bawah ke dalamnya, isi nomor modul dan apa yang Anda lihat:

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.

Karena agent itu punya keahlian dan MCP dari modul 00, ia juga dapat langsung meng-query layanan Cloud Anda saat membantu - jadi ia bisa memeriksa apakah tabel, pipe, atau telemetri Anda memang sudah masuk, bukan hanya membaca dokumentasi.

Jika Anda ingin kerangka instruktur itu bertahan antar sesi ketimbang menempelkannya berulang, masukkan ke berkas project-instructions alat Anda: CLAUDE.md untuk Claude Code, AGENTS.md untuk Codex CLI, dan .cursor/rules/ (atau AGENTS.md, yang juga dibaca Cursor) untuk Cursor. Setiap alat memuat berkas itu secara otomatis di root repo, jadi panduannya selalu ada dalam konteks setiap kali Anda membuka workshop.

Saran ritme

Anggaran waktu per modul di ikhtisar mengasumsikan sebuah ruangan di mana pendaftaran akun sudah dilakukan sebelumnya. Saat sendiri, modul 00 mendominasi: tiga pendaftaran lewat browser (ClickHouse Cloud, Langfuse, OpenAI) memerlukan 5 hingga 10 menit masing-masing, sebagian besar menunggu verifikasi email atau telepon. Callout "lakukan pendaftaran akun sebelum hari-H" di 00 Setup berlaku dua kali lipat saat Anda sendiri - lakukan ketiga pendaftaran lebih dahulu, kembali dengan kunci di tangan, dan sisa modul 00 akan cepat. Modul 01 hingga 09 kemudian berjalan mendekati anggaran waktu yang disebutkan.

Anda tidak akan pernah terlantar: bagian Titik awal setiap modul menyatakan tepat apa yang harus sudah tersedia, jadi Anda bisa berhenti, kembali nanti, dan melanjutkan dari sana.

Ke mana selanjutnya