AgentCore-Ressourcen als IaC erstellen
Eine neue AgentCore-Ressource sollte als überprüftes Modul im selben Baum landen, den das Team bereitstellt – nicht als Klick in der Konsole, den niemand reproduzieren kann. Diese Fähigkeit schreibt kleine, flache Terraform-Module – eine main.tf, variables.tf, outputs.tf, versions.tf – die der Nutzer aus seinem Root-Modul einbindet. Die Module sind bewusst einfach gehalten: Jedes Argument wird in einem Kommentar erklärt, Geheimnisse sind nur schreibbar, und das Gateway wird niemals ohne einen Authorizer erstellt.
${CLAUDE_SKILL_DIR} wird von der Skill-Laufzeit auf das eigene Verzeichnis dieser Fähigkeit gesetzt. Verwenden Sie es unverändert in jedem Befehl unten; die Skripte einer benachbarten Fähigkeit liegen unter ${CLAUDE_SKILL_DIR}/../<skill>/scripts/.
Ablauf
-
Erkunden Sie zuerst, damit das Modul neben den vorhandenen Modulen landet und die Region bekannt ist:
python3 ${CLAUDE_SKILL_DIR}/../agentcore-discover/scripts/discover.py <projekt> --focus agentcore,region,terraformWenn die AgentCore-CLI oder CDK bereits AgentCore-Ressourcen verwaltet (Bereich
DSC004), bieten Sie passend--iacanstelle von Terraform an. -
Planen Sie den Schreibvorgang.
python3 ${CLAUDE_SKILL_DIR}/scripts/scaffold.py <projekt> --component runtime --dry-run--component gateway|identity|memory,--iac terraform|cdk|cli,--name,--out-dir,--protocol HTTP|MCP|A2A|AGUI(Runtime). -
Optionen. Terraform-Modul (empfohlen, kostenlos), CDK-Stack (kostenlos) oder die AgentCore-CLI-Befehle (kostenlos zur Anzeige;
agentcore deployselbst istaws). -
Bestätigen Sie mit
AskUserQuestion, führen Sie dann denselben Befehl ohne--dry-runaus. Verwenden Sie--forcenur, wenn der Nutzer nach dem Plan explizit das Ersetzen einer Datei verlangt hat. -
Überprüfen Sie das Ergebnis mit der Überprüfung und zeigen Sie es an:
python3 ${CLAUDE_SKILL_DIR}/../agentcore-review/scripts/review.py <projekt>
Entscheidungsregeln
- Terraform zuerst. Es ist das, was der erste Nutzer ausführt, und die einzige Option, bei der die Überprüfung, der Bereitstellungsplan und die CI-Richtlinie dieses Plugins alle greifen. Der hashicorp/aws-Provider deckt jede Kernressource ab; siehe provider-coverage.md für das, was
awsccoder die CLI benötigt. - Ein Modul wird eingebunden, nicht angewendet. Das Skript gibt den einzufügenden
module-Block aus; es bearbeitet niemals das Root-Modul. - Nur-schreibbare Geheimnisse benötigen Terraform 1.11+. Die generierte
versions.tfgibt dies vor; älteres Terraform muss eine sensitive Variable verwenden und akzeptieren, dass das Geheimnis im State liegt (ACR031). - Das Starter-Toolkit wird nicht angeboten. Seine CLI wird nicht mehr unterstützt; die AgentCore-CLI ist die CLI-Alternative.
Referenzen
| Frage | Datei |
|---|---|
| Was jedes generierte Modul enthält und warum | terraform-modules.md |
| Die CDK- und AgentCore-CLI-Pfade und wann man sie wählt | cdk-and-cli-alternatives.md |
Welche Ressourcen hashicorp/aws abdeckt; awscc- und CLI-Fallbacks | provider-coverage.md |
Skripte
| Befehl | Aufgabe | Exit-Codes |
|---|---|---|
scripts/scaffold.py <projekt> --component C [--iac terraform|cdk|cli] [--dry-run] [--force] [--json] | Plant und schreibt ein Modul, einen CDK-Stack oder gibt CLI-Befehle aus | 0 geschrieben/geplant, 1 nichts zu schreiben, 2 fehlerhafte Argumente |
Erledigungsliste
- Die Erkennung wurde ausgeführt und das gewählte IaC stimmt mit dem überein, der bereits AgentCore-Ressourcen verwaltet.
- Der Schreibplan wurde mit
--dry-runangezeigt und vor dem Schreiben bestätigt. - Der
module-Einbindungsblock wurde dem Nutzer mitgeteilt, nicht in sein Root-Modul geschrieben. -
review.pywurde auf dem Ergebnis ausgeführt und seine Erkenntnisse wurden angezeigt.