cdk-local (cdkl) で Bedrock AgentCore Runtime のローカル開発体験を試してみた

• URL: https://dev.classmethod.jp/articles/cdk-local-bedrock-agentcore-runtime/
• 日付: 2026-06-06
• Tier: Tier 3
• 要旨: go-to-k/cdk-local（cdkl）の invoke-agentcore サブコマンドと CDK --hotswap の AgentCore 対応を実測。cdkl/hotswap/通常デプロイの3手法でデプロイ速度を比較し、cdkl の --from-cfn-stack や --assume-role 機能も確認。

詳細

• 3手法の位置づけ:
  • cdkl invoke-agentcore: ローカル開発・即時テスト向け（cdkl は開発用）
  • cdk deploy --hotswap: イメージ更新のみのケースを高速化
  • cdk deploy（通常）: 本番反映に使用
• 検証環境: EC2 t4g.medium (ARM64), Amazon Linux 2023, CDK CLI 2.1125.0, cdk-local 0.105.0, us-east-1
• アプリ構成: AgentCore Runtime アプリは /ping（GET）と /invocations（POST）をポート8080で実装。環境変数 GREETING の値を返すシンプルな Python サーバー
• CDK スタック: SSM パラメータから環境変数を取得し agentcore.Runtime に渡す。AgentRuntimeArtifact.fromCodeAsset でコードを直接パッケージング
• cdkl 独自機能: --from-cfn-stack で既存 CloudFormation スタックから設定を読み込み、--assume-role でロール切り替えをサポート
• 評価: ローカルから AgentCore Runtime をターミナル一発で呼び出せる開発体験は CI/CD 組み込み前の高速イテレーションに有効