Lộ trình giảng viên
Kịch bản chạy phiên ở cấp độ phòng học, checklist tài nguyên dùng chung và ghi chú điều phối cho từng module.
Lộ trình này là tài liệu đồng hành của người điều phối bên cạnh lộ trình Học viên. Mỗi module của học viên đều có một trang ghi chú tương ứng ở đây với bốn phần: Thời lượng, Nội dung dẫn giảng, Lỗi thường gặp và Các bước khôi phục. Hãy đọc trang giới thiệu này trước để có bức tranh toàn cảnh ở cấp độ phòng học.
Lộ trình học viên hỗ trợ macOS và Windows. Windows dùng Ubuntu trên WSL 2 với tích hợp Docker Desktop. Hãy yêu cầu mọi người chọn máy tính của mình ở phần đầu trang trước khi vào phòng hỗ trợ cài đặt, và giữ học viên Windows ở trong terminal Ubuntu sau khi bootstrap.
Lộ trình học viên cũng có trang Tự học workshop này dành cho những người làm workshop mà không có giảng viên; trang đó hướng họ đến các ghi chú này như đáp án (và chỉ dùng đáp án lỗi của module 07 như phương án cuối cùng), nên hãy giữ lộ trình này chính xác cho cả nhóm người đọc đó.
Kịch bản chạy phiên
Phiên học kéo dài ba giờ. Bảng dưới đây là phân bổ khởi điểm; hãy tinh chỉnh trong buổi tổng duyệt và ghi lại các con số cuối cùng ở đây.
| Module | Bài học của học viên | Ngân sách thời gian | Ghi chú |
|---|---|---|---|
| 00 | Cài đặt | 25 phút | Các bước khởi chạy rồi chờ (tạo service, docker compose up) bắt đầu trước phần dẫn giảng |
| 01 | ClickHouse Cloud | 15 phút | Khoảnh khắc "wow" đầu tiên về tốc độ truy vấn |
| 02 | Ứng dụng nền | 5 phút | Không có gì để xây; giữ ngắn gọn |
| 03 | Managed Postgres CDC | 20 phút | Mỗi học viên tạo một instance được quản lý; giữ sẵn một pool dự phòng trên cloud |
| 04 | ClickHouse Agents | 10 phút | Công cụ đang ở giai đoạn beta; chuẩn bị sẵn một câu hỏi dự phòng |
| 05 | ClickStack | 15 phút | Telemetry cần thời gian tích luỹ trước module 07 |
| 06 | AI SRE | 15 phút | MCP OAuth là điểm dễ vỡ nhất; hãy chuẩn bị cấu hình trước |
| 07 | Gây lỗi và sửa lỗi | 20 phút | Thành quả trực tiếp từ module 06; quản lý mốc dừng cứng rất quan trọng |
| 08 | Chat và Langfuse | 15 phút | Khoá đã được đặt ở module 00; khởi động lại cộng với phần tham quan trace |
| 09 | Tổng kết | 10 phút | Tình nguyện viên demo; khôi phục mọi trạng thái dùng chung |
Các ngân sách này tổng cộng khoảng 2 giờ 30 phút thực hành; thời gian còn lại trong phiên ba giờ dành cho phần mở đầu, chuyển tiếp giữa các module và các demo kết thúc.
Tinh chỉnh thời lượng trong buổi tổng duyệt
Các ngân sách trên là phân bổ khởi điểm. Hãy kiểm chứng từng con số với buổi tổng duyệt có bấm giờ, và đặt một mốc chuyển hướng cứng cho phòng lab sự cố (module 07) để module 08 và phần tổng kết không bao giờ bị bó hẹp.
Checklist tài nguyên dùng chung
Một số tài nguyên dự phòng được dùng chung cho cả phòng. Hãy xác nhận từng thứ đã được cấp phát và ổn định trước khi mở cửa:
- Pool Managed Postgres dự phòng — chỉ là các instance chạy trên cloud dành cho những người mà tổ chức của họ không thể tạo được. Đường đi chính là mỗi học viên có một Postgres do ClickHouse quản lý.
- Các service ClickHouse Cloud cho mượn — một pool nhỏ dành cho người dùng bị lỗi bản trial. TODO: kích thước pool và cách phân phối.
- Pool khoá LLM lúc chạy — các khoá dự phòng có giới hạn chi tiêu cho phần chat trong ứng dụng (module 08).
- Máy chiếu và kênh chat dùng chung — cho các demo kết thúc.
- Mạng của địa điểm — đủ băng thông đối xứng, không có captive portal, thân thiện với OAuth.
- Tổng duyệt đa nền tảng — một lần chạy sạch trên macOS và một lần chạy sạch trên Windows/WSL 2, bao gồm tích hợp Docker, MCP browser OAuth, preflight, và các lần khôi phục nhánh của Module 07.
Phòng hỗ trợ cài đặt
Cửa mở sớm để có một phòng hỗ trợ cài đặt có người trực. Bất kỳ ai chưa vượt qua hoàn toàn phần chuẩn bị trước nên đến vào lúc đó. TODO: xác nhận giờ bắt đầu và nhân sự trực phòng.