modal-storage-knowledge

Modal Storage Knowledge

Modal の永続化および共有状態プリミティブには、このスキルを使用してください。コンピューティング、GPU、自動スケーリング、デプロイに関するトピックには、modal-compute:modal-compute-knowledge を使用してください。

クイックルーティング

• Volumes：関数やクラスにマウントする永続的なファイルシステム状態です。永続化が必要な書き込みの後に vol.commit() を呼び出します。
• Dict：小規模な共有メタデータ、キャッシュ、調整に使う分散キーバリュー状態です。
• Queue：プロデューサーとコンシューマー間のタスク受け渡しや分散ジョブキューに使います。
• CloudBucketMount：Modal マウントを介して、S3／GCS 互換のオブジェクトストレージに直接アクセスします。
• Secrets：ストレージの認証情報には名前付きシークレットを使用し、キーをハードコードしないでください。

基本的なワークフロー

1. ワークロードで必要なのがファイルシステムのセマンティクス、キーバリュー状態、キューイング、オブジェクトストアへのアクセスのどれかを特定します。
2. ストレージプリミティブを必要とするすべての関数／クラスに明示的にマウントします。
3. Volumes では、書き込み後にコミットし、並行ワーカー間での再読み込み／読み取りを慎重に行います。
4. 認証情報は Modal Secrets に保存し、アクセスが必要な関数に対象を限定します。
5. 並列ジョブをスケールする前に、小規模な読み取り／書き込み／削除テストで検証します。

詳細リファレンス

例、注意点、ストレージに関する詳しいガイダンスについては、references/storage-volumes-cloud.md を参照してください。