AgentCore 배포: 시퀀스, 할당량, 명령어, 롤백
배포는 이 플러그인이 더 이상 스스로 실행하지 않고 조언만 하는 단계입니다. Terraform은 이미 리소스를 참조 관계에 따라 정렬합니다. 하지만 어떤 루트를 계획해야 하는지, 그래프 외부의 이유로 최초 적용 시 어떤 것이 실패할지, 나중에 변경할 수 없는 설정은 무엇인지, 그리고 되돌리는 방법은 알려주지 않습니다. 이 스킬은 아무것도 작성하거나 실행하지 않습니다: 명령어를 출력하면 사용자가 직접 실행합니다.
${CLAUDE_SKILL_DIR}은 스킬 런타임에 의해 이 스킬 자체의 디렉터리로 설정됩니다. 아래 모든 명령어에서 이를 그대로 사용하세요; 형제 스킬의 스크립트는 ${CLAUDE_SKILL_DIR}/../<skill>/scripts/에 있습니다.
흐름
-
먼저 검토. 오류 위에 배포 계획을 세우는 것은 오류를 배포하겠다는 계획입니다:
python3 ${CLAUDE_SKILL_DIR}/../agentcore-review/scripts/review.py <project> -
배포를 계획합니다.
python3 ${CLAUDE_SKILL_DIR}/scripts/deploy_plan.py <project>--root DIR(발견된 루트가 배포할 루트가 아닌 경우 – Provider 제약, 잠금, 리전 및 스테이지는 해당 루트의 것으로 간주);--plan-file NAME;--json. 명령어는 출력된setup줄에 설정된$AGENTCORE_PLUGIN으로 플러그인을 지정합니다. -
보고 루트 모듈, 스테이지,
DPL발견 사항, 명령어, 롤백 순서로 보고합니다. 비용 등급을 명시하세요: 이 명령어들은 사용자 계정에 청구 가능한 리소스를 생성합니다. -
옵션: (1, 권장) 사용자가 init → validate → plan to file →
show -json→ 정책 검사를 실행하고 정책 출력을 붙여넣습니다; (2) 읽은 후, 사용자는 해당 저장된 plan 파일을 적용합니다. 각 단계를AskUserQuestion으로 확인하고, 절대 하나의 단계로 축소하지 마세요. -
확인 사용자가 성공적인 적용을 보고한 후:
/agentcore:agentcore-verify로 전환합니다.
DPL0xx 대역
| Id | 심각도 | 트리거 |
|---|---|---|
DPL001 | 경고 | 원격 백엔드 없음 (Terragrunt도 없음) |
DPL002 | 오류 | 게시된 할당량 초과 (게이트웨이당 대상 수, 대상당 도구 수) |
DPL003 | 정보 | 역할과 게이트웨이를 한 번의 적용으로 처리: IAM 전파로 첫 번째 시도가 실패할 수 있음 |
DPL004 | 정보 | 의미론적 검색은 생성 전용 |
DPL005 | 정보 | Terragrunt 스택: 명령어는 terragrunt 사용 |
DPL006 | 경고 | hashicorp/aws가 6.55.0 미만으로 잠김 |
DPL007 | 정보 | TRACES 전달을 위해 먼저 Transaction Search를 활성화해야 함 |
DPL008 | 정보 | 선택한 루트가 hashicorp/aws 버전 제약 조건을 선언하지 않음 |
결정 규칙
- 저장된 plan을 적용하고, 절대
-auto-approve를 사용하지 마세요. 사용자가 읽은 plan이 실행되는 plan입니다. - 적용 전 정책 검사.
policy_check.py는 명시적인--allow-replace없이 메모리, 게이트웨이, 자격 증명 제공자, 사용자 풀의 삭제를 거부합니다. -target은 최초 배포가 아닌 롤백용입니다. 최초 적용이 IAM 전파로 실패하면, 동일한 적용을 다시 실행하세요.- 롤백은 삭제가 아닌 되돌리기로 수행합니다. 상태 저장 리소스(사용자, 대화, 비밀)는 롤백 대상에 절대 포함되지 않습니다.
참조
| 질문 | 파일 |
|---|---|
| 스테이지 순서, 최초 적용 실패 지점, Terragrunt | apply-sequencing.md |
| 배포 시 중요한 AgentCore 할당량 | quotas.md |
| 변경 유형별 롤백; 절대 삭제하지 말아야 할 것 | rollback.md |
스크립트
| 명령어 | 기능 | 종료 코드 |
|---|---|---|
scripts/deploy_plan.py <project> [--root DIR] [--plan-file F] [--json] | 루트, 스테이지, DPL 발견 사항, 명령어, 롤백 | 0 오류 없음, 1 오류 있음, 2 Terraform 없음 |
완료 체크리스트
-
review.py가 먼저 실행되었고, 그 오류가 사용자에 의해 해결되거나 수락되었습니다. -
deploy_plan.py가 실행되었고, 루트 모듈이 사용자와 확인되었습니다. - 어떤 명령어도 전달되기 전에 비용 등급(
aws)이 명시되었습니다. - 사용자가 apply 전에 plan → show -json → policy check를 실행했습니다.
- 저장된 plan 파일만 사용자에 의해 적용되었으며, 어시스턴트가 명령어를 실행하지 않았습니다.
- 이 변경 사항에 대한 롤백이 적용 전에 명시되었습니다.