Tự học workshop này

Workshop này được thiết kế để chạy trong một lớp có giảng viên, nhưng mọi thứ bạn cần để tự hoàn thành nó đều đã nằm trong playbook này. Nếu bạn đang tự làm qua repository - hoặc có ai đó chia sẻ nó cho bạn sau sự kiện - trang này là tấm bản đồ của bạn.

Hãy chọn macOS hoặc Windows ở phần header trang trước khi thiết lập. Học viên Windows chạy mọi câu lệnh của workshop trong Ubuntu trên WSL 2; PowerShell chỉ xuất hiện trong các khối bootstrap và khôi phục dành cho Windows được ghi nhãn rõ ràng.

Điều gì thay đổi khi không có giảng viên

Trả lời ngắn: không có gì trong các module 00 đến 07. Lộ trình chính hoàn toàn tự phục vụ. Bạn tự tạo bản dùng thử ClickHouse Cloud của mình, tự tạo Postgres do ClickHouse quản lý bằng clickhousectl (module 03), và tự tạo các API key của mình - không có tài nguyên dùng chung nào mà bạn phụ thuộc vào. Các module 04 đến 09 cũng vậy.

Một giảng viên thường cung cấp hai thứ, và mỗi thứ đều có phương án tự phục vụ được dựng sẵn trong tài liệu này:

• Buổi hỗ trợ thiết lập có người trực (module 00) được thay bằng ./preflight.sh trong ClickHouse_Demos/workshops/build_workshop/app, script này kiểm tra mọi thứ mà quá trình khởi động trực tiếp thường vướng phải, cùng trang Xử lý sự cố liệt kê mọi lỗi đã gặp khi kiểm thử cùng cách sửa chính xác.
• Việc tháo gỡ trực tiếp trong lúc làm một module được thay bằng hai thứ: coding agent của bạn đóng vai giảng viên (bên dưới), và lộ trình giảng viên làm đáp án của bạn (bên dưới).

Lộ trình giảng viên là đáp án của bạn

Lộ trình giảng viên được công bố trong cùng playbook này. Mỗi module đều có một trang giảng viên tương ứng với thời lượng, những lỗi thực sự xảy ra và cách tháo gỡ, cùng các bước reset để trở về trạng thái đã biết là tốt. Khi một module không hoạt động như phần kiểm chứng mong đợi, hãy mở trang giảng viên tương ứng - nó được viết ra cho chính khoảnh khắc đó.

Coding agent của bạn chính là giảng viên của bạn

Bạn đã nạp các ClickHouse agent skills và kết nối ClickHouse MCP từ xa vào coding agent của mình ở module 00. Chính agent đó là một giảng viên workshop có năng lực. Hãy dán khối bên dưới vào nó, điền số module và những gì bạn đang thấy:

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.

Vì đã có các skill và MCP từ module 00, agent còn có thể truy vấn trực tiếp service Cloud của bạn trong lúc hỗ trợ - nên nó có thể kiểm tra xem các bảng, pipe, hay telemetry của bạn có thực sự vào tới đích hay không, chứ không chỉ đọc tài liệu.

Nếu bạn muốn cách đóng vai giảng viên này được giữ lại qua nhiều phiên thay vì phải dán lại, hãy đưa nó vào file hướng dẫn dự án của công cụ bạn dùng: CLAUDE.md cho Claude Code, AGENTS.md cho Codex CLI, và .cursor/rules/ (hoặc AGENTS.md, mà Cursor cũng đọc) cho Cursor. Mỗi công cụ tự nạp file đó ở gốc repo, nên hướng dẫn luôn nằm trong context mỗi lần bạn mở workshop.

Lời khuyên về nhịp độ

Ngân sách thời gian theo từng module trong phần tổng quan giả định một lớp học nơi việc đăng ký tài khoản đã làm từ trước. Khi tự làm, module 00 chiếm phần lớn thời gian: ba lần đăng ký trên browser (ClickHouse Cloud, Langfuse, OpenAI) mất 5 đến 10 phút mỗi lần, chủ yếu là chờ xác thực email hoặc số điện thoại. Callout "hãy đăng ký tài khoản trước ngày diễn ra" trong 00 Thiết lập càng đúng gấp đôi khi bạn làm một mình - hãy làm cả ba lần đăng ký trước, quay lại với key đã có trong tay, và phần còn lại của module 00 sẽ nhanh gọn. Các module 01 đến 09 khi đó chạy sát với ngân sách thời gian đã nêu.

Bạn không bao giờ bị bỏ rơi: phần Điểm khởi đầu của mỗi module nêu chính xác những gì phải có sẵn, nên bạn có thể dừng lại, quay lại sau, và tiếp tục từ đó.

Đi đâu tiếp