modal-web-scheduling-knowledge について
ModalでHTTPエンドポイントやスケジュールジョブを構築する開発者向けのリファレンススキルです。実装方法の選択からローカルテスト、デプロイ、デバッグまで扱い、計算やストレージ機能は対象外です。
主な機能
- 01HTTPエンドポイントのルーティング指針
- 02Cronと間隔実行のスケジューリング
- 03ローカル実行とデプロイの手順
- 04リトライ、タイムアウト、冪等性の指針
- 05デプロイとログのデバッグチェックリスト
活用シーン
- 01APIに使うエンドポイントデコレーターの選択
- 02定期的なETLジョブの設定
- 03Modalアプリのテストとデプロイ
- 04スケジュールやエンドポイント設定の問題調査
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/modal-web-scheduling-knowledgeを入力して読み込まれたか確認します。
詳細
Modal の Web エンドポイントとスケジューリングに関する知識
Modal の Web エンドポイントとスケジュールされたジョブには、このスキルを使用してください。GPU コンピューティング、自動スケーリング、ストレージのプリミティブには、用途に特化した Modal のコンピューティングまたはストレージのスキルを使用してください。
エンドポイントの使い分け
- シンプルな関数ベースの HTTP API には、
@modal.fastapi_endpoint()を使用してください。 - 完全な FastAPI／Starlette アプリ、WebSocket、ミドルウェア、ルーティングには、
@modal.asgi_app()を使用してください。 - WSGI フレームワークには、
@modal.wsgi_app()を使用してください。 - コンテナごとに複数の入力を安全に同時処理できる、高スループットのエンドポイントには、
@modal.concurrentを追加してください。 modal serveでローカルテストを行い、その後modal deployでデプロイしてください。
スケジューリングの使い分け
- カレンダーに基づくスケジュールと明示的なタイムゾーンには、
modal.Cron(...)を使用してください。 - インターバルに基づく実行には、
modal.Period(...)を使用してください。 - スケジュールはデプロイ済みのアプリから実行されます。
modal runは手動テスト専用です。 - スケジュールされた ETL や定期的なジョブには、リトライ、タイムアウト、冪等性を追加してください。
デバッグチェックリスト
- スケジュールのテスト時に、アプリがデプロイ済みであることを確認してください。
- ログのストリーミング範囲を制限して、エンドポイントのログを確認してください。
- デプロイ前に、シークレットと環境名を検証してください。
- トラフィックを増やす前に、最小限のリクエストまたはスケジュールの手動トリガーを試してください。
コメント
Markdown 対応