00 Setup

Pendamping fasilitator untuk pelajaran learner 00 Setup.

Waktu

Sekitar 30 menit total. Ini pra-kerja, bukan materi hari-H — kirimkan ke partner sebelum sesi dan konfirmasi penyelesaiannya sehari sebelumnya, bukan di pagi hari sesi. Tidak ada bagian di sini yang bisa ditinggal dalam arti "jalankan lalu pergi"; isinya lima instalasi tool, dua pendaftaran akun, satu clone, dan dua pembangunan virtualenv, yang semuanya butuh tangan partner di keyboard sepanjang waktu. Partner yang datang tanpa mengerjakannya menghabiskan sekitar 30 menit waktu sesi untuk mengejar secara langsung, dengan mengorbankan apa pun yang seharusnya dibahas modul 01 di slot tersebut.

Alur pembicaraan

• Posisikan modul ini sebagai instalasi dasar, bukan konten: dua cloud (Snowflake sebagai sumber, ClickHouse Cloud sebagai target), dua adapter dbt, satu per cloud, dan kedua adapter berbagi batas bawah Python yang keras.
• Satu fakta yang layak diucapkan lantang, lebih dari sekali: dbt-snowflake dan dbt-clickhouse keduanya membutuhkan Python 3.11, 3.12, atau 3.13. Python 3.14+ merusak satu dependensi transitif bersama, mashumaro, di kedua adapter.
• Tunjuk dua virtualenv terpisah — workshop_public/snowflake_migration_lab/01-setup-snowflake/.venv dan workshop_public/snowflake_migration_lab/03-migrate-to-clickhouse/.venv — dan jelaskan mengapa keduanya tidak bisa digabung menjadi satu: kedua adapter mem-pin rentang dependensi yang bertentangan.
• Dorong kedua pendaftaran cloud dilakukan sekarang, bukan pada hari-H: baik trial Snowflake maupun trial ClickHouse Cloud tidak boleh menjadi penghambat begitu modul 01 dimulai.

Kegagalan umum

• Python 3.14+ merusak dbt-snowflake dan dbt-clickhouse lewat mashumaro. Ini kegagalan utama modul ini, dan yang paling berbahaya, karena mem-pin interpreter secara salah tidak gagal di sini — ia muncul dua modul kemudian sebagai error impor dbt yang membingungkan dan tidak tampak berkaitan dengan versi Python. Konfirmasi python3 --version melaporkan 3.11, 3.12, atau 3.13 untuk interpreter yang sebenarnya berada di balik setiap virtualenv — workshop_public/snowflake_migration_lab/01-setup-snowflake/.venv dan workshop_public/snowflake_migration_lab/03-migrate-to-clickhouse/.venv — bukan hanya default sistem — sebelum menyatakan partner lulus modul ini.
• TODO: tidak ada mode kegagalan lain untuk modul ini yang terdokumentasi di README lab itu sendiri. Catat apa pun yang teramati saat gladi bersih di sini (proxy atau firewall perusahaan yang memblokir pip install atau terraform init, prompt lisensi Docker Desktop saat pertama dijalankan, keterlambatan persetujuan pendaftaran trial).

Langkah reset

• Versi Python salah di balik sebuah venv: cd ke virtualenv modul mana pun yang bermasalah — workshop_public/snowflake_migration_lab/01-setup-snowflake/ atau workshop_public/snowflake_migration_lab/03-migrate-to-clickhouse/ — lalu hapus dan bangun ulang terhadap interpreter yang di-pin, misalnya rm -rf .venv && python3.13 -m venv .venv && source .venv/bin/activate, dan instal ulang adapter venv tersebut seperti ditunjukkan pada Step 4 halaman learner.
• Tidak ada skrip teardown yang berlaku untuk modul ini — belum ada apa pun yang di-provision di kedua cloud. Jika partner perlu mengulang satu langkah, lebih murah menjalankannya ulang daripada mereset apa pun.
• TODO: konfirmasi saat gladi bersih apakah mendistribusikan venv yang sudah dibangun sebelumnya layak dilakukan untuk ruangan dengan Wi-Fi tidak andal, alih-alih menginstal lima tool dan dua venv secara langsung pada hari-H.