patrickchugh/terravision

해결하는 문제

TerraVision은 AWS, Azure 및 Google Cloud를 위한 전문적인 클라우드 아키텍처 다이어그램 생성을 자동화합니다. Lucidchart나 Visio와 같은 도구에서 수동으로 다이어그램을 그릴 필요가 없으며, 시각적 문서가 실제 인프라 코드(Terraform)와 완벽하게 동기화되도록 하거나 AI 어시스턴트를 통해 일반 영어 설명에서 즉시 생성할 수 있습니다.

작동 방식

TerraVision은 Model Context Protocol(MCP)을 통해 AI 어시스턴트(Claude, ChatGPT, Cursor 등)에 통합되거나 플러그인으로 사용할 수 있는 로컬 도구로 작동합니다. 두 가지 주요 방향으로 작동합니다:

1. 설계에서 코드로: AI 어시스턴트가 자연어 설명을 받아 JSON 그래프를 생성하면 TerraVision이 이를 다이어그램으로 렌더링합니다. 그런 다음 어시스턴트는 해당 설계를 기반으로 대응하는 Terraform 코드를 작성할 수 있습니다.
2. 코드에서 다이어그램으로: TerraVision은 terraform plan 출력을 분석하여 배포되는 리소스, VPC, 서브넷 및 영역에 대한 정확한 시각적 표현을 생성합니다.

렌더링을 위해 Graphviz를 사용하며, 다이어그램을 PNG, SVG, 편집 가능한 draw.io 파일 또는 대화형 HTML 페이지로 내보낼 수 있습니다.

대상 사용자

Terraform을 사용하여 인프라를 관리하고 수동 작업 없이 정확하고 전문적인 아키텍처 다이어그램을 유지하려는 클라우드 아키텍트, DevOps 엔지니어 및 개발자.

주요 특징

• AI 네이티브 통합: Claude Desktop, ChatGPT 및 기타 MCP 호환 클라이언트를 위한 확장 프로그램/플러그인으로 작동합니다.
• 입증된 정확성: Terraform 코드에서 직접 다이어그램을 생성하여 코드가 유일한 진실의 원천(single source of truth)이 되도록 합니다.
• 로컬 및 보안: 클라우드 액세스가 필요 없고 코드 업로드가 없는 상태에서 사용자 컴퓨터에서 완전히 실행됩니다.
• 멀티 클라우드 지원: AWS, Azure 및 GCP를 위한 공식 아이콘 및 그룹화 규칙을 지원합니다.
• CI/CD 자동화: Terraform 코드가 변경될 때마다 다이어그램을 자동으로 다시 그리는 GitHub Action을 포함합니다.
• 대화형 출력: 보안 감사 및 문서를 위한 클릭 가능한 HTML 다이어그램을 지원합니다.