Skip to content

Commit 9579023

Browse files
committed
Add AgentCore Runtime VPC configuration documentation
- Add VPC network configuration section to DEPLOY_OPTION.md - Include AZ support requirements with AWS official documentation link - Add NAT Gateway requirements for MCP server installation - Add manual stack deletion procedure for AgentCore - Include both Generic Runtime and AgentBuilder Runtime settings
1 parent dea7feb commit 9579023

File tree

1 file changed

+61
-0
lines changed

1 file changed

+61
-0
lines changed

docs/ja/DEPLOY_OPTION.md

Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -769,6 +769,67 @@ const envs: Record<string, Partial<StackInput>> = {
769769
}
770770
```
771771

772+
> [!NOTE]
773+
> AgentCore ユースケースの設定を有効後に、再度無効化する場合は、`createGenericAgentCoreRuntime: false` にして再デプロイすればAgentCore ユースケースは無効化されますが、`AgentCoreStack` 自体は残ります。マネージメントコンソールを開き、`agentCoreRegion` の CloudFormation から `AgentCoreStack` というスタックを削除することで完全に消去ができます。
774+
775+
#### AgentCore Runtime のネットワーク設定
776+
777+
AgentCore Runtime は以下のネットワークモードで動作できます:
778+
779+
- `PUBLIC` (デフォルト): パブリックネットワークで動作
780+
- `PRIVATE`: VPC内のプライベートネットワークで動作
781+
782+
ネットワーク設定は、Generic Runtime と AgentBuilder Runtime の両方に適用されます。
783+
784+
**VPCモードの使用場面**:
785+
786+
- AgentCore Runtime から社内システムやプライベートデータベースにアクセスする必要がある場合
787+
- 例えば、VPC内の他のAWSサービス(RDS、ElastiCache等)と直接通信したい場合
788+
789+
VPC モードを使用する場合は、以下のパラメータを設定してください:
790+
791+
- `agentCoreNetworkType`: `PRIVATE` に設定
792+
- `agentCoreVpcId`: 使用するVPCのID
793+
- `agentCoreSubnetIds`: 使用するサブネットのIDリスト
794+
795+
> [!IMPORTANT]
796+
> **Availability Zone (AZ) サポート**: AgentCore RuntimeはリージョンごとにサポートされているAZが限定されています。サブネットは必ずサポートされているAZ内に配置してください。詳細は[AWS公式ドキュメント](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/agentcore-vpc.html#agentcore-supported-azs)をご確認ください。
797+
>
798+
> **インターネットアクセス**: AgentCore Runtime で MCP サーバーのインストールにはインターネットアクセスが必要です。プライベートサブネットが接続先の場合には NAT Gateway への経路を設定してください。
799+
800+
**[parameter.ts](/packages/cdk/parameter.ts) を編集**
801+
802+
```typescript
803+
// parameter.ts
804+
const envs: Record<string, Partial<StackInput>> = {
805+
dev: {
806+
createGenericAgentCoreRuntime: true,
807+
agentBuilderEnabled: true,
808+
agentCoreNetworkType: 'PRIVATE',
809+
agentCoreVpcId: 'vpc-xxxxxxxxx',
810+
agentCoreSubnetIds: ['subnet-xxxxxxxxx', 'subnet-yyyyyyyyy'],
811+
},
812+
};
813+
```
814+
815+
**[packages/cdk/cdk.json](/packages/cdk/cdk.json) を編集**
816+
817+
```json
818+
// cdk.json
819+
{
820+
"context": {
821+
"createGenericAgentCoreRuntime": true,
822+
"agentBuilderEnabled": true,
823+
"agentCoreNetworkType": "PRIVATE",
824+
"agentCoreVpcId": "vpc-xxxxxxxxx",
825+
"agentCoreSubnetIds": ["subnet-xxxxxxxxx", "subnet-yyyyyyyyy"]
826+
}
827+
}
828+
```
829+
830+
> [!WARNING]
831+
> VPCモードを使用する場合、AgentCore Runtime削除時にセキュリティグループが自動削除されません。AgentCore Runtimeが作成するマネージドENIがセキュリティグループを参照するため、CloudFormationでは削除できません。AgentCore Runtime削除後、マネージドENIが自動削除されるまで待ってから、手動でセキュリティグループを削除してください。削除が必要なセキュリティグループIDはCloudFormationの出力に表示されます。
832+
772833
### 音声チャットユースケースの有効化
773834

774835
> [!NOTE]

0 commit comments

Comments
 (0)