以 IaC 建立 AgentCore 資源
一個新的 AgentCore 資源應該以經過審查的模組形式,與團隊部署的其他資源放在同一目錄結構中,而不是透過無人能重現的主控台點擊。此技能會撰寫小而扁平的 Terraform 模組——每個模組包含 main.tf、variables.tf、outputs.tf、versions.tf——讓使用者從自己的根模組進行連接。這些模組刻意保持簡單:每個引數都有註解說明、機密僅供寫入、且 Gateway 絕不會在沒有授權器的情況下建立。
${CLAUDE_SKILL_DIR} 由技能執行環境設定為此技能本身的目錄。請在下方每個指令中直接使用該變數;同級技能的腳本位於 ${CLAUDE_SKILL_DIR}/../<skill>/scripts/。
流程
-
先進行探索,以便模組能放置在既有模組旁,並確認區域:
python3 ${CLAUDE_SKILL_DIR}/../agentcore-discover/scripts/discover.py <project> --focus agentcore,region,terraform如果 AgentCore CLI 或 CDK 已經擁有 AgentCore 資源(
DSC004領地),則提供相對應的--iac而非 Terraform。 -
規劃寫入。
python3 ${CLAUDE_SKILL_DIR}/scripts/scaffold.py <project> --component runtime --dry-run--component gateway|identity|memory、--iac terraform|cdk|cli、--name、--out-dir、--protocol HTTP|MCP|A2A|AGUI(僅 runtime)。 -
選項。 Terraform 模組(推薦,免費)、CDK 堆疊(免費)、或 AgentCore CLI 指令(免費顯示;
agentcore deploy本身由aws負責)。 -
確認 透過
AskUserQuestion,然後執行相同指令但不加--dry-run。只有當使用者看到計畫後要求取代檔案時,才加上--force。 -
驗證。 對結果執行審查並顯示:
python3 ${CLAUDE_SKILL_DIR}/../agentcore-review/scripts/review.py <project>
決策規則
- Terraform 優先。 這是第一個使用者的預設選項,也是此插件的審查、部署計畫與 CI 政策皆適用的唯一選項。hashicorp/aws 提供者涵蓋所有核心資源;如需
awscc或 CLI 的支援項目,請參閱 provider-coverage.md。 - 模組只連接,不套用。 腳本會印出需加入的
module區塊,但不會編輯根模組。 - 僅寫入機密需要 Terraform 1.11+。 產生的
versions.tf會明確標示;較舊的 Terraform 必須使用敏感變數,並接受機密會存在狀態檔中(ACR031)。 - 入門工具組不再提供。 其 CLI 已不再支援;AgentCore CLI 是 CLI 替代方案。
參考資料
| 問題 | 檔案 |
|---|---|
| 每個產生模組的內容與原因 | terraform-modules.md |
| CDK 與 AgentCore CLI 路徑及使用時機 | cdk-and-cli-alternatives.md |
hashicorp/aws 涵蓋的資源;awscc 與 CLI 備援方式 | provider-coverage.md |
腳本
| 指令 | 功能 | 結束碼 |
|---|---|---|
scripts/scaffold.py <project> --component C [--iac terraform|cdk|cli] [--dry-run] [--force] [--json] | 規劃並撰寫模組、CDK 堆疊或顯示 CLI 指令 | 0 已寫入/已規劃,1 無需寫入,2 錯誤引數 |
完成檢查清單
- 已執行探索,且所選 IaC 與擁有 AgentCore 資源的對象一致。
- 寫入計畫已透過
--dry-run顯示,並在寫入前獲得確認。 -
module連接區塊已提供給使用者,而非直接寫入他們的根模組。 - 已對結果執行
review.py並顯示其發現。