AgentCore のデプロイ: シーケンス、クォータ、コマンド、ロールバック
デプロイとは、このプラグインが行動を停止し、助言を開始する場面です。 Terraform はリソースを依存関係に基づいて自動的に順序付けますが、どのルートを計画すべきか、グラフの外部要因で初回適用時に何が失敗するか、後から変更できない設定は何か、そして元に戻す方法は何か、これらを教えてくれるわけではありません。 このスキルは何も書き込まず、何も実行しません。コマンドを表示し、ユーザーがそれらを実行します。
${CLAUDE_SKILL_DIR} はスキルランタイムによってこのスキル自身のディレクトリに設定されます。
以下のすべてのコマンドでそのまま使用してください。兄弟スキルのスクリプトは ${CLAUDE_SKILL_DIR}/../<skill>/scripts/ にあります。
フロー
-
まずレビューする。 エラーの上にデプロイ計画を立てることは、エラーをデプロイする計画を立てることに等しいです。
python3 ${CLAUDE_SKILL_DIR}/../agentcore-review/scripts/review.py <project> -
デプロイを計画する。
python3 ${CLAUDE_SKILL_DIR}/scripts/deploy_plan.py <project>--root DIRは、検出されたルートがデプロイ対象でない場合に使用します（プロバイダ制約、ロック、リージョン、ステージはそのルートのものになります）。--plan-file NAME、--json。 コマンドはプラグインを$AGENTCORE_PLUGINとして参照し、これは表示されるsetup行によって設定されます。 -
報告する。 ルートモジュール、ステージ、
DPL調査結果、コマンド、ロールバックをこの順序で報告します。 コスト階層を明示します。これらのコマンドはユーザーのアカウントに課金可能なリソースを作成します。 -
オプション: (1、推奨) ユーザーが init → validate → plan to file →
show -json→ ポリシーチェックを実行し、ポリシー出力を貼り付けます。 (2) それを読んだ後、ユーザーは その保存された計画ファイル を適用します。 各ステップはAskUserQuestionで確認し、1つのステップにまとめないでください。 -
確認する。 ユーザーが適用成功を報告したら、
/agentcore:agentcore-verifyに引き継ぎます。
DPL0xx 帯
| Id | 重大度 | トリガー |
|---|---|---|
DPL001 | warn | リモートバックエンドがない（かつ Terragrunt もない） |
DPL002 | error | 公開クォータ超過（ゲートウェイあたりのターゲット数、ターゲットあたりのツール数） |
DPL003 | info | ロールとゲートウェイを1回の適用で行う場合: IAM 伝搬が初回で失敗する可能性あり |
DPL004 | info | セマンティック検索は作成時のみ有効 |
DPL005 | info | Terragrunt スタックの場合: コマンドは terragrunt を使用 |
DPL006 | warn | hashicorp/aws が 6.55.0 未満でロックされている |
DPL007 | info | TRACES 配信には事前に Transaction Search の有効化が必要 |
DPL008 | info | 選択されたルートに hashicorp/aws バージョン制約がない |
判断ルール
- 保存された計画ファイルを適用し、決して
-auto-approveを使用しない。 ユーザーが読んだ計画が実行される計画です。 - 適用前にポリシーチェック。
policy_check.pyは、明示的な--allow-replaceなしではメモリ、ゲートウェイ、認証情報プロバイダ、ユーザープールの削除を拒否します。 -targetはロールバック用であり、初回デプロイには使用しない。 初回適用が IAM 伝搬で失敗した場合、同じ適用を再実行します。- ロールバックは破棄ではなく、元に戻すことによって行う。 ステートフルリソース（ユーザー、会話、シークレット）はロールバックの対象になりません。
リファレンス
| 質問 | ファイル |
|---|---|
| ステージ順序、初回適用で問題が発生する点、Terragrunt | apply-sequencing.md |
| デプロイ時に関連する AgentCore クォータ | quotas.md |
| 変更種別ごとのロールバック、絶対に破棄してはいけないもの | rollback.md |
スクリプト
| コマンド | 処理内容 | 終了コード |
|---|---|---|
scripts/deploy_plan.py <project> [--root DIR] [--plan-file F] [--json] | ルート、ステージ、DPL 調査結果、コマンド、ロールバック | 0 エラーなし、1 エラーあり、2 Terraform なし |
完了チェックリスト
-
review.pyが最初に実行され、そのエラーが解決されるかユーザーによって承認された。 -
deploy_plan.pyが実行され、ルートモジュールがユーザーと確認された。 - コマンドが引き渡される前に、コスト階層 (
aws) が明示された。 - ユーザーが適用前に plan → show -json → ポリシーチェックを実行した。
- 保存された計画ファイルのみがユーザーによって適用され、アシスタントはコマンドを実行しなかった。
- この変更に対するロールバックが適用前に明示された。