Criar recursos AgentCore como IaC
Um novo recurso AgentCore deve chegar como um módulo revisado na mesma árvore
de tudo o que a equipe implanta, não como um clique no console que ninguém
consegue reproduzir. Esta skill escreve módulos Terraform pequenos e planos — um
main.tf, variables.tf, outputs.tf, versions.tf — que o usuário conecta a
partir do seu módulo raiz. Os módulos são deliberadamente simples: cada argumento
é explicado em um comentário, segredos são write-only, e o gateway nunca é
criado sem um autorizador.
${CLAUDE_SKILL_DIR} é definido pelo runtime da skill como o diretório da
própria skill. Use-o exatamente como aparece em cada comando abaixo; os scripts
de uma skill irmã estão em ${CLAUDE_SKILL_DIR}/../<skill>/scripts/.
Fluxo
-
Descubra primeiro, para que o módulo seja colocado ao lado dos existentes e a região seja conhecida:
python3 ${CLAUDE_SKILL_DIR}/../agentcore-discover/scripts/discover.py <projeto> --focus agentcore,region,terraformSe a CLI AgentCore ou o CDK já possuir recursos AgentCore (território
DSC004), ofereça o--iaccorrespondente em vez de Terraform. -
Planeje a escrita.
python3 ${CLAUDE_SKILL_DIR}/scripts/scaffold.py <projeto> --component runtime --dry-run--component gateway|identity|memory,--iac terraform|cdk|cli,--name,--out-dir,--protocol HTTP|MCP|A2A|AGUI(runtime). -
Opções. Módulo Terraform (recomendado, gratuito), stack CDK (gratuito) ou comandos da CLI AgentCore (gratuito para exibir;
agentcore deployem si éaws). -
Confirme com
AskUserQuestion, depois execute o mesmo comando sem--dry-run. Passe--forceapenas quando o usuário pedir para substituir um arquivo após ver o plano. -
Verifique. Execute a revisão no resultado e mostre-a:
python3 ${CLAUDE_SKILL_DIR}/../agentcore-review/scripts/review.py <projeto>
Regras de decisão
- Terraform primeiro. É o que o primeiro usuário executa, e a única opção
onde a revisão, o plano de deploy e a política de CI deste plugin se aplicam.
O provedor hashicorp/aws cobre todos os recursos principais; veja
provider-coverage.md para o que precisa de
awsccou da CLI. - Um módulo é conectado, não aplicado. O script imprime o bloco
modulea ser adicionado; ele nunca edita o módulo raiz. - Segredos write-only precisam do Terraform 1.11+. O
versions.tfgerado informa isso; Terraform mais antigo deve usar uma variável sensível e aceitar que o segredo fique no estado (ACR031). - O starter toolkit não é oferecido. Sua CLI não é mais suportada; a CLI AgentCore é a alternativa de CLI.
Referências
| Pergunta | Arquivo |
|---|---|
| O que cada módulo gerado contém e por quê | terraform-modules.md |
| Os caminhos do CDK e da CLI AgentCore, e quando escolhê-los | cdk-and-cli-alternatives.md |
Quais recursos o hashicorp/aws cobre; fallbacks awscc e CLI | provider-coverage.md |
Scripts
| Comando | Faz | Códigos de saída |
|---|---|---|
scripts/scaffold.py <projeto> --component C [--iac terraform|cdk|cli] [--dry-run] [--force] [--json] | planeja e escreve um módulo, um stack CDK ou imprime comandos da CLI | 0 escrito/planejado, 1 nada para escrever, 2 argumentos inválidos |
Checklist de conclusão
- A descoberta foi executada, e o IaC escolhido corresponde a quem já possui recursos AgentCore.
- O plano de escrita foi exibido a partir de
--dry-rune confirmado antes de escrever. - O bloco de conexão
modulefoi fornecido ao usuário, não escrito em seu módulo raiz. -
review.pyfoi executado no resultado e suas descobertas foram exibidas.