다이어그램 모델을 쿼리로 활용한 AWS 인프라 자동 문서화 전략

Context

복잡한 AWS 인프라 자원을 수동으로 다이어그램화하는 작업의 높은 시간 비용 발생. 리소스 탐색과 시각화 과정의 반복적인 수작업으로 인한 효율성 저하.

Technical Solution

• AWS SDK 기반 Python 스크립트를 활용해 VPC 및 Subnet 등 실제 인프라 데이터를 JSON 형태로 추출하는 단계 설계
• Draw.io 모델 파일의 구조를 LLM에 입력하여 필요한 추출 데이터 항목을 역으로 추론하는 데이터 정의 자동화 방식 도입
• LLM의 데이터 교차 분석 능력을 활용해 추출된 JSON 데이터와 Draw.io 모델 템플릿을 결합한 실제 인프라 다이어그램 생성
• Kiro IDE의 Custom Agent 기능을 이용해 '데이터 추출-모델 분석-다이어그램 생성' 전 과정을 단일 커맨드로 실행하는 워크플로우 구축
• API Gateway 및 Integration 등 다양한 리소스 모델에 범용적으로 적용 가능한 확장형 에이전트 설계

Key Takeaway

다이어그램 모델 자체를 일종의 쿼리 언어로 활용하여 데이터 추출 범위를 정의하고 시각화 결과물을 도출하는 선언적 인프라 문서화 접근 방식의 유효성 확인.