AI SREClickHouse Workshops

インストラクタートラック

会場全体の進行表、共有リソースのチェックリスト、モジュールごとのファシリテーターノート。

Your computer
macOS terminal: Run workshop commands in Terminal using zsh or bash.

このトラックは、Learner トラックに対応するファシリテーター用の手引きです。すべての学習者向けモジュールに、 タイミング、トークトラック、よくある失敗、リセット手順 の4つのセクションを持つノートページが 対応しています。まずはこのランディングページを読んで、会場全体の流れを把握してください。

学習者向けのパスは macOS と Windows に対応しています。Windows では WSL 2 上の Ubuntu と Docker Desktop の統合を使用します。セットアップクリニックの前に、全員にページヘッダーで自分のコンピューターを 選んでもらい、ブートストラップ後の Windows 学習者は Ubuntu ターミナルに留めておいてください。

学習者トラックには、インストラクターなしでワークショップを進める人向けの このワークショップを自習形式で進める ページもあります。このページは学習者を解答集としてこれらのノートへ誘導します(モジュール 07 の障害の解答集へは 最後の手段としてのみ)。そのため、この読者層のためにもこのトラックを正確に保ってください。

進行表

セッションは3時間です。以下の表は初期の時間配分です。ドライランで調整し、最終的な数値をここに記録してください。

モジュール学習者レッスン時間配分備考
00セットアップ25 min待ち時間の発生する手順(サービス作成、docker compose up)はトークの前に開始する
01ClickHouse Cloud15 minクエリ速度で最初の「おおっ」を引き出す
02ベースアプリ5 min構築するものはない。短く保つ
03マネージド Postgres CDC20 min各学習者がマネージドインスタンスを作成する。マネージドクラウドのフォールバックプールを用意しておく
04ClickHouse Agents10 minベータ版のツール。予備の質問を用意しておく
05ClickStack15 minモジュール 07 の前にテレメトリーが蓄積される時間が必要
06AI SRE15 minMCP の OAuth が壊れやすい山場。設定を事前に仕込む
07破壊と修復20 min06 の成果が直接効いてくる。ハードストップの管理が重要
08Chat と Langfuse15 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: クリニックの開始時刻とスタッフ体制を確定する。

モジュールごとのノート

このページの内容

JA