Créer des ressources AgentCore en tant qu'IaC
Une nouvelle ressource AgentCore doit arriver sous forme de module révisé dans le même arbre que tout ce que l'équipe déploie, et non comme un clic de console que personne ne peut reproduire. Cette compétence écrit des modules Terraform petits et plats — un main.tf, variables.tf, outputs.tf, versions.tf — que l'utilisateur branche depuis son module racine. Les modules sont délibérément simples : chaque argument est expliqué dans un commentaire, les secrets sont en écriture seule, et la passerelle n'est jamais créée sans autorisateur.
${CLAUDE_SKILL_DIR} est défini par le moteur de compétence comme le répertoire de cette compétence. Utilisez-le textuellement dans chaque commande ci-dessous ; les scripts d'une compétence sœur se trouvent dans ${CLAUDE_SKILL_DIR}/../<compétence>/scripts/.
Flux
-
Découvrir d'abord, pour que le module atterrisse à côté des existants et que la région soit connue :
python3 ${CLAUDE_SKILL_DIR}/../agentcore-discover/scripts/discover.py <projet> --focus agentcore,region,terraformSi l'interface CLI AgentCore ou le CDK possède déjà des ressources AgentCore (territoire
DSC004), proposez le--iaccorrespondant au lieu de Terraform. -
Planifier l'écriture.
python3 ${CLAUDE_SKILL_DIR}/scripts/scaffold.py <projet> --component runtime --dry-run--component gateway|identity|memory,--iac terraform|cdk|cli,--name,--out-dir,--protocol HTTP|MCP|A2A|AGUI(runtime). -
Options. Module Terraform (recommandé, gratuit), pile CDK (gratuit), ou les commandes de l'interface CLI AgentCore (gratuit à afficher ;
agentcore deploylui-même estaws). -
Confirmer avec
AskUserQuestion, puis exécuter la même commande sans--dry-run. Passez--forceuniquement lorsque l'utilisateur a demandé à remplacer un fichier après avoir vu le plan. -
Vérifier. Lancer la révision sur le résultat et l'afficher :
python3 ${CLAUDE_SKILL_DIR}/../agentcore-review/scripts/review.py <projet>
Règles de décision
- Terraform d'abord. C'est ce que le premier utilisateur exécute, et la seule option où la révision, le plan de déploiement et la politique d'intégration continue de ce plugin s'appliquent tous. Le fournisseur hashicorp/aws couvre chaque ressource principale ; voir provider-coverage.md pour ce qui nécessite
awsccou la CLI. - Un module est câblé, pas appliqué. Le script affiche le bloc
moduleà ajouter ; il ne modifie jamais le module racine. - Les secrets en écriture seule nécessitent Terraform 1.11+. Le
versions.tfgénéré le précise ; Terraform plus ancien doit utiliser une variable sensible et accepter que le secret soit dans l'état (ACR031). - Le kit de démarrage n'est pas proposé. Son interface CLI n'est plus prise en charge ; l'interface CLI AgentCore est l'alternative CLI.
Références
| Question | Fichier |
|---|---|
| Ce que contient chaque module généré et pourquoi | terraform-modules.md |
| Les chemins CDK et AgentCore CLI, et quand les choisir | cdk-and-cli-alternatives.md |
Quelles ressources hashicorp/aws couvre ; les alternatives awscc et CLI | provider-coverage.md |
Scripts
| Commande | Fait | Codes de sortie |
|---|---|---|
| `scripts/scaffold.py --component C [--iac terraform | cdk | cli] [--dry-run] [--force] [--json]` |
Liste de vérification
- La découverte a été exécutée et l'IaC choisie correspond à celui qui possède déjà les ressources AgentCore.
- Le plan d'écriture a été affiché via
--dry-runet confirmé avant l'écriture. - Le bloc de câblage
modulea été donné à l'utilisateur, pas écrit dans son module racine. -
review.pya été exécuté sur le résultat et ses constats ont été affichés.