00 Setup

Pendamping fasilitator untuk pelajaran pembelajar 00 Setup.

Waktu

Sekitar 25 menit. Mulai langkah fire-and-wait (buat service, docker compose up) sebelum atau selama sesi bicara pembukaan agar berjalan di belakangnya. Dorong peserta untuk menyelesaikan tiga pendaftaran akun (ClickHouse Cloud, Langfuse, OpenAI) sebelum hari-H - masing-masing 5 sampai 10 menit - supaya modul ini tetap sesuai anggaran.

Untuk ruangan campuran, sisihkan 10 menit tambahan sebelum sesi bagi pembelajar Windows yang belum memasang WSL 2 dan Docker Desktop. Restart bisa dibutuhkan setelah wsl --install.

Untuk sesi tatap muka dengan kredensial yang disediakan pengajar:

• Terbitkan API key organisasi ClickHouse Cloud dan project OpenAI sementara yang terpisah untuk setiap pembelajar. Jangan pernah membagi satu key ke seluruh ruangan.
• Kirimkan setiap key melalui kanal berbagi rahasia yang disetujui, bukan lewat chat atau slide.
• Terapkan anggaran project OpenAI dan batas rate, lalu pantau penggunaan selama sesi.
• Cabut kedua key setelah workshop. Rotasi salah satu key segera jika terekspos.

Alur pembicaraan

• Bingkai sesinya: mereka akan memindahkan aplikasi yang sudah ada ke ClickHouse Cloud, dan agen yang melakukan pembangunannya.
• CLI mengembalikan password default-user sekali saja; minta pembelajar menyimpannya segera. Dialog Connect pada service menyediakan hostname.
• Modul 00 sekarang membuat service Cloud dan mengisi setiap kredensial, jadi bagian fire-and-wait dimuat di depan di sini; modul 01 hanya membangun skema pada service yang sudah ada.
• Langkah 7 adalah satu-satunya setup integrasi agen: skills, ClickHouse MCP, dan ClickStack MCP.
• Minta pembelajar memilih macOS atau Windows di header halaman sebelum Langkah 1. Di Windows, PowerShell hanya untuk bootstrap WSL; setiap perintah workshop dijalankan di Ubuntu.
• Perlakukan WSL 2 sebagai prework Windows, bukan pemasangan di dalam sesi. Pastikan build Windows yang didukung, hak administrator lokal, virtualisasi, RAM host 16 GB, disk bebas 20 GB, Ubuntu versi 2, dan integrasi Ubuntu di Docker Desktop sebelum pintu dibuka.

Kegagalan umum

• Email kerja sudah terhubung ke org ClickHouse yang ada, sehingga tidak ada kredit trial yang muncul. Arahkan ke email pribadi (sudah dimunculkan di prework).
• Coding agent tidak bisa menambahkan server MCP karena kebijakan korporat (dimunculkan oleh smoke test prework).
• docker compose up gagal karena alokasi Docker terlalu kecil (butuh 6 GB+).
• Pembelajar Windows melakukan clone di bawah /mnt/c, menyebabkan bind mount lambat atau kegagalan CRLF. Clone ulang di bawah ~/ClickHouse_Demos di dalam Ubuntu dan setel git config --global core.autocrlf input.
• Docker Desktop berjalan tetapi Ubuntu tidak bisa menjangkaunya. Aktifkan engine WSL 2 dan integrasi Ubuntu secara eksplisit, lalu jalankan wsl --shutdown dari PowerShell.
• Coding agent membuka checkout C:\Users yang terpisah sementara perintah dijalankan di WSL. Buka kembali folder WSL ~/ClickHouse_Demos di agen desktop dan pastikan terminalnya melaporkan Linux dengan uname -s.
• Kebijakan korporat memblokir WSL, virtualisasi, Docker Desktop, atau OAuth. Ini tidak bisa diperbaiki selama modul berjalan; pindahkan pembelajar ke mesin pinjaman yang sudah disiapkan atau mesin pribadi.
• Request pertama setelah service Cloud idle-scale ke nol dulu menghasilkan 500; back end sekarang mencoba ulang idle-wake saat connect, jadi pemuatan dashboard pertama mungkin berhenti beberapa detik tapi berhasil. Bukan kegagalan yang perlu dikejar. Dikonfirmasi pada dry run clean-room 2026-07.

Langkah reset

• Arahkan peserta yang mentok ke pool service Cloud pinjaman jika trial mereka tidak bisa dipakai.
• Jalankan ulang cp .env.workshop.example .env.workshop dan isi kembali; pastikan tidak ada .env.workshop yang tercommit tanpa sengaja.
• Di Windows, verifikasi wsl --status, wsl --version, dan wsl --list --verbose; Ubuntu harus versi 2. Di dalam Ubuntu, pwd dimulai dengan /home/ dan docker version menampilkan Client maupun Server.
• TODO: konfirmasi perintah reset.