Crear recursos de AgentCore como IaC
Un nuevo recurso de AgentCore debe llegar como un módulo revisado en el mismo árbol que todo lo demás que despliega el equipo, no como un clic en la consola que nadie puede reproducir. Esta habilidad escribe módulos de Terraform pequeños y planos — un main.tf, variables.tf, outputs.tf, versions.tf — que el usuario conecta desde su módulo raíz. Los módulos son deliberadamente simples: cada argumento está explicado en un comentario, los secretos son de solo escritura, y la gateway nunca se crea sin un autorizador.
${CLAUDE_SKILL_DIR} es establecido por el entorno de ejecución de la habilidad en el directorio propio de esta habilidad. Úsalo textualmente en cada comando a continuación; los scripts de una habilidad hermana están en ${CLAUDE_SKILL_DIR}/../<skill>/scripts/.
Flujo
-
Descubrir primero, para que el módulo se ubique junto a los existentes y se conozca la región:
python3 ${CLAUDE_SKILL_DIR}/../agentcore-discover/scripts/discover.py <proyecto> --focus agentcore,region,terraformSi la CLI de AgentCore o CDK ya posee recursos de AgentCore (territorio
DSC004), ofrecer el--iaccorrespondiente en lugar de Terraform. -
Planificar la escritura.
python3 ${CLAUDE_SKILL_DIR}/scripts/scaffold.py <proyecto> --component runtime --dry-run--component gateway|identity|memory,--iac terraform|cdk|cli,--name,--out-dir,--protocol HTTP|MCP|A2A|AGUI(runtime). -
Opciones. Módulo de Terraform (recomendado, gratuito), stack de CDK (gratuito), o los comandos de la CLI de AgentCore (gratis para imprimir;
agentcore deployen sí esaws). -
Confirmar con
AskUserQuestion, luego ejecutar el mismo comando sin--dry-run. Pasar--forcesolo cuando el usuario solicitó reemplazar un archivo después de ver el plan. -
Verificar. Ejecutar la revisión sobre el resultado y mostrarlo:
python3 ${CLAUDE_SKILL_DIR}/../agentcore-review/scripts/review.py <proyecto>
Reglas de decisión
- Terraform primero. Es lo que ejecuta el primer usuario, y la única opción donde se aplican la revisión, el plan de despliegue y la política de CI de este plugin. El proveedor hashicorp/aws cubre todos los recursos centrales; consulta provider-coverage.md para saber qué necesita
awscco la CLI. - Un módulo se conecta, no se aplica. El script imprime el bloque
moduleque se debe añadir; nunca edita el módulo raíz. - Los secretos de solo escritura requieren Terraform 1.11+. El
versions.tfgenerado lo indica; Terraform más antiguo debe usar una variable sensible y aceptar que el secreto quede en el estado (ACR031). - El kit de inicio (starter toolkit) no se ofrece. Su CLI ya no tiene soporte; la CLI de AgentCore es la alternativa CLI.
Referencias
| Pregunta | Archivo |
|---|---|
| Qué contiene cada módulo generado y por qué | terraform-modules.md |
| Las rutas de CDK y CLI de AgentCore, y cuándo elegirlas | cdk-and-cli-alternatives.md |
Qué recursos cubre hashicorp/aws; alternativas de awscc y CLI | provider-coverage.md |
Scripts
| Comando | Hace | Códigos de salida |
|---|---|---|
| `scripts/scaffold.py --component C [--iac terraform | cdk | cli] [--dry-run] [--force] [--json]` |
Lista de verificación de finalización
- Se ejecutó el descubrimiento, y el IaC elegido coincide con quien ya posee recursos de AgentCore.
- El plan de escritura se mostró con
--dry-runy se confirmó antes de escribir. - El bloque de conexión
modulese entregó al usuario, no se escribió en su módulo raíz. -
review.pyse ejecutó sobre el resultado y sus hallazgos se mostraron.