AgentCore 리소스를 IaC로 생성하기
새로운 AgentCore 리소스는 팀이 배포하는 다른 모든 것과 동일한 트리 내에서 리뷰된 모듈로 제공되어야 하며, 아무도 재현할 수 없는 콘솔 클릭으로 제공되어서는 안 됩니다. 이 스킬은 작고 평평한 Terraform 모듈(main.tf, variables.tf, outputs.tf, versions.tf)을 작성하며, 사용자는 이를 자신의 루트 모듈에서 연결(wire)합니다. 모듈은 의도적으로 단순합니다: 모든 인수는 주석으로 설명되고, 시크릿은 쓰기 전용이며, Gateway는 인증자 없이 생성되지 않습니다.
${CLAUDE_SKILL_DIR}은 스킬 런타임에 의해 이 스킬의 자체 디렉토리로 설정됩니다. 아래 모든 명령에서 이를 그대로 사용하세요; 형제 스킬의 스크립트는 ${CLAUDE_SKILL_DIR}/../<skill>/scripts/에 있습니다.
흐름
-
발견 먼저 수행하여 모듈이 기존 모듈 옆에 배치되고 리전이 알려지도록 합니다:
python3 ${CLAUDE_SKILL_DIR}/../agentcore-discover/scripts/discover.py <project> --focus agentcore,region,terraformAgentCore CLI 또는 CDK가 이미 AgentCore 리소스를 소유하고 있는 경우(
DSC004영역), Terraform 대신 일치하는--iac를 제공합니다. -
쓰기 계획.
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를 참조하세요. - 모듈은 연결(wired)되고, 적용(applied)되지 않습니다. 스크립트는 추가할
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 잘못된 인수 |
완료 체크리스트
- 발견(Discovery)이 실행되었고, 선택한 IaC가 이미 AgentCore 리소스를 소유한 주체와 일치합니다.
-
--dry-run으로 작성 계획이 표시되고 작성 전에 확인되었습니다. -
module연결 블록이 사용자에게 제공되었으며, 루트 모듈에 직접 작성되지 않았습니다. -
review.py가 결과에 대해 실행되었고 그 결과가 표시되었습니다.