피드로 돌아가기
CDK Architecture Diagram Generator — Visualize AWS CDK Apps Instantly
Dev.toDev.to
Infrastructure

cdk synth JSON 파싱을 통한 AWS 아키텍처 자동 시각화 구현

CDK Architecture Diagram Generator — Visualize AWS CDK Apps Instantly

Raghvendra Pandey2026년 4월 24일3intermediate

Context

CDK의 고수준 추상화로 인한 인프라 가시성 저하 문제 발생. CloudFormation 콘솔의 단순 스택 나열과 CDK Tree의 계층 구조만으로는 실제 Network Topology 파악에 한계가 있음.

Technical Solution

  • cdk synth 결과물인 CloudFormation JSON의 Resources 객체를 직접 파싱하는 메커니즘 채택
  • Ref 및 Fn::GetAtt 참조 관계 분석을 통한 리소스 간 Directed Arrow 연결 구조 설계
  • VpcId 속성 기반의 리소스 그룹화로 VPC Containment 시각화 구현
  • SubnetSelection 정보 분석을 통한 Public/Private Subnet Lane 배치 로직 적용
  • 리소스 타입별 자동 분류를 통한 Internet, Messaging, Data Zone 그룹핑 자동화
  • L1/L2 Construct의 최종 합성 결과물인 CloudFormation 리소스 타입을 매핑하여 범용적 시각화 지원

- CDK 코드 리뷰 시 cdk synth 결과물을 시각화하여 인프라 변경 사항을 직관적으로 검토 - 신규 입사자 온보딩 시 소스 코드 대신 시각화된 아키텍처 다이어그램을 제공하여 도메인 이해도 향상 - 설계 문서 작성 시 draw.io XML 내보내기 기능을 활용해 편집 가능한 다이어그램으로 변환

원문 읽기