インストラクタートラック
会場全体の進行表、共有リソースのチェックリスト、モジュールごとのファシリテーターノート。
このトラックは、Learner トラックに対応するファシリテーター用の手引きです。すべての学習者向けモジュールに、 タイミング、トークトラック、よくある失敗、リセット手順 の4つのセクションを持つノートページが 対応しています。まずはこのランディングページを読んで、会場全体の流れを把握してください。
学習者向けのパスは macOS と Windows に対応しています。Windows では WSL 2 上の Ubuntu と Docker Desktop の統合を使用します。セットアップクリニックの前に、全員にページヘッダーで自分のコンピューターを 選んでもらい、ブートストラップ後の Windows 学習者は Ubuntu ターミナルに留めておいてください。
学習者トラックには、インストラクターなしでワークショップを進める人向けの このワークショップを自習形式で進める ページもあります。このページは学習者を解答集としてこれらのノートへ誘導します(モジュール 07 の障害の解答集へは 最後の手段としてのみ)。そのため、この読者層のためにもこのトラックを正確に保ってください。
進行表
セッションは3時間です。以下の表は初期の時間配分です。ドライランで調整し、最終的な数値をここに記録してください。
| モジュール | 学習者レッスン | 時間配分 | 備考 |
|---|---|---|---|
| 00 | セットアップ | 25 min | 待ち時間の発生する手順(サービス作成、docker compose up)はトークの前に開始する |
| 01 | ClickHouse Cloud | 15 min | クエリ速度で最初の「おおっ」を引き出す |
| 02 | ベースアプリ | 5 min | 構築するものはない。短く保つ |
| 03 | マネージド Postgres CDC | 20 min | 各学習者がマネージドインスタンスを作成する。マネージドクラウドのフォールバックプールを用意しておく |
| 04 | ClickHouse Agents | 10 min | ベータ版のツール。予備の質問を用意しておく |
| 05 | ClickStack | 15 min | モジュール 07 の前にテレメトリーが蓄積される時間が必要 |
| 06 | AI SRE | 15 min | MCP の OAuth が壊れやすい山場。設定を事前に仕込む |
| 07 | 破壊と修復 | 20 min | 06 の成果が直接効いてくる。ハードストップの管理が重要 |
| 08 | Chat と Langfuse | 15 min | キーはモジュール 00 で設定済み。再起動とトレース見学 |
| 09 | まとめ | 10 min | 有志によるデモ。共有状態をリセットする |
これらの時間配分は合計で約2時間30分のハンズオン作業になります。3時間のセッションの残り時間は、 オープニング、モジュール間の移行、そして最後のデモに充てます。
リハーサルでタイミングを調整する
上記の配分は初期の割り当てです。時間を計測したドライランでそれぞれを確認し、モジュール 08 と まとめが圧迫されないよう、インシデントラボ(モジュール 07)のハードピボット時刻を決めてください。
共有リソースのチェックリスト
一部のフォールバックリソースは会場全体で共有されます。開場前に、それぞれがプロビジョニング済みで 正常であることを確認してください。
- マネージド Postgres のフォールバックプール — 組織の都合で自分で作成できない参加者のためだけの クラウドホスト型インスタンス。主経路は学習者ごとに1つの ClickHouse マネージド Postgres です。
- 貸出用 ClickHouse Cloud サービス — トライアルに失敗した参加者向けの小規模なプール。 TODO: プールのサイズと配布方法。
- ランタイム LLM キーのプール — アプリ内チャット(モジュール 08)向けの、上限額を設定した予備キー。
- プロジェクターと共有チャンネル — 最後のデモ用。
- 会場のネットワーク — 十分な対称帯域、キャプティブポータルなし、OAuth が通ること。
- 複数プラットフォームでのリハーサル — クリーンな macOS での1回と、クリーンな Windows/WSL 2 での1回。 Docker 統合、MCP のブラウザ OAuth、preflight、モジュール 07 のブランチリセットを含めること。
セットアップクリニック
スタッフが常駐するセットアップクリニックのため、早めに開場します。事前課題が完全に通らなかった人は その時間に来てもらってください。TODO: クリニックの開始時刻とスタッフ体制を確定する。