ADK 인프라 전문가은(는) 무엇을 하나요?
개요
Terraform으로 프로덕션 등급의 Vertex AI ADK 인프라를 프로비저닝합니다: 보안 네트워킹, 최소 권한 IAM, Agent Engine 런타임, 코드 실행 샌드박스 기본값, Memory Bank 구성. 이 스킬을 사용하여 엔터프라이즈 보안 제약 조건(필요 시 VPC 서비스 제어 포함)을 충족하는 Terraform 모듈 및 배포 체크리스트를 생성/검증하세요.
사전 요구 사항
이 스킬을 사용하기 전에 다음을 확인하세요:
- 결제가 활성화된 Google Cloud 프로젝트
- Terraform 1.0+ 설치
- 적절한 권한으로 인증된 gcloud CLI
- 대상 프로젝트에서 Vertex AI API 활성화
- (엔터프라이즈용) VPC 서비스 제어 액세스 정책 생성
- Agent Engine 아키텍처 및 요구 사항 이해
지침
- Terraform 초기화: 원격 상태 저장소를 위한 백엔드 설정
- 변수 구성: project_id, region, 에이전트 구성 정의
- VPC 프로비저닝: Private Service Connect를 사용한 네트워크 인프라 생성
- IAM 설정: 최소 권한 역할을 가진 서비스 계정 생성
- Agent Engine 배포: 코드 실행 및 메모리 뱅크로 런타임 구성
- VPC-SC 활성화: 데이터 유출 방지를 위한 서비스 경계 적용
- 모니터링 구성: Cloud Monitoring 대시보드 및 알림 설정
- 배포 검증: 에이전트 엔드포인트 테스트 및 모든 구성 요소 확인
출력
- 프로젝트에 적용된 구성 파일 또는 코드 변경 사항
- 올바른 구현을 확인하는 검증 보고서
- 수행된 변경 사항 및 그 근거 요약
출력 형식 사양은 Terraform 구현 세부 정보를 참조하세요.
오류 처리
포괄적인 오류 처리는 ${CLAUDE_SKILL_DIR}/references/errors.md를 참조하세요.
예제
자세한 예제는 ${CLAUDE_SKILL_DIR}/references/examples.md를 참조하세요.
리소스
- Agent Engine: https://cloud.google.com/vertex-ai/generative-ai/docs/agent-engine/overview
- VPC-SC: https://cloud.google.com/vpc-service-controls/docs
- Terraform Google Provider: https://registry.terraform.io/providers/hashicorp/google/latest
- ADK Terraform 예제: ${CLAUDE_SKILL_DIR}/examples/