Classmethod Agentcore Runtime Storage Three Types Cdk
AgentCore RuntimeにSession Storage・S3 Files・EFSを同時マウントしてCDKで構築・検証してみた
- URL: https://dev.classmethod.jp/articles/agentcore-runtime-storage-three-types-cdk/
- 日付: 2026-06-09
- Tier: Tier 3
- 要旨: AWS AgentCore Runtime のストレージマウント機能（Session Storage・S3 Files・EFS の 3 種類同時）を CDK TypeScript で構築し、セッション間のデータ共有を実機検証。CDK L2 コンストラクトの escape hatch やセキュリティグループの注意点も詳述。
詳細
3 種類のストレージ比較
| ストレージ | セッション間共有 | 永続性 | VPC 要否 |
|---|---|---|---|
| Session Storage | 不可 | 同一セッション stop/resume 間。構成更新・14 日間アイドルで削除 | 不要 |
| S3 Files (BYO) | 同じ Access Point を使えば可 | S3 と同期して永続 | 必要 |
| EFS (BYO) | 同じ Access Point を使えば可 | 永続 | 必要 |
CDK での注意点
aws-bedrockagentcoreの Runtime L2 コンストラクトはfilesystemConfigurations未サポート（2026-06-09 時点 CDK 2.258.0）→ escape hatch でCfnRuntimeに直接設定が必要S3 Files用にaws-cdk-lib 2.258.0以降（aws-cdk-lib/aws-s3filesモジュール）が必要- IAM 権限は ClientMount/ClientWrite に加え、Runtime 作成時バリデーション用の Describe 系も必要
Security Group
runtime.connections.allowTo(storage.mountTargetSg, Port.tcp(2049))で Runtime ↔ マウントターゲット間の NFS（TCP 2049）を双方向で設定
実機検証結果
- 3 種すべてが正常にマウント（
dfで確認） - Session Storage は約 1 GiB 表示、EFS/S3 Files は約 8 EiB 表示（NFS 上の仮想値）
- セッション間データ共有: EFS/S3 Files では同じ Access Point 経由の別セッションからファイルが見える
- Session Storage は異なるセッションインスタンス間で共有不可（設計どおり）