이 글에서 소개한 도구
글을 읽으면서 브라우저에서 바로 도구를 열어 작업 흐름을 직접 확인해 보세요.
여러분의 인프라 구성도는 최신 상태인가요?
“가장 최신 구성도가 어디에 있죠?”

팀에 새로 합류한 멤버가 이렇게 물었을 때, 자신 있게 파일을 내밀 수 있는 프로젝트는 얼마나 될까요? 많은 경우 초기 설계 단계에서 draw.io나 파워포인트로 만든 그림이 업데이트되지 않은 채 방치되어 있곤 합니다.
이유는 단순합니다. **“수정하기 번거롭기 때문”**입니다.
브라우저에서 마우스로 일일이 선을 다시 연결하고, 배치를 조정하고, 이미지로 내보내는 과정은 인프라 변경이 잦은 현대의 개발 환경에서 너무나 큰 비용입니다.
“코드를 짜듯” 그림을 만들고 싶다
우리가 코드를 Git으로 관리하는 것처럼 구성도 역시 텍스트 기반으로 관리할 수 있다면, 문서의 최신성을 유지하는 일은 훨씬 쉬워질 것입니다. 이를 가능하게 하는 것이 바로 Mermaid.js입니다.
텍스트로 연결 관계만 정의하면 브라우저가 자동으로 최적의 레이아웃을 계산하여 도표를 그려줍니다. 이 ‘마법’ 같은 방식을 쓰지 않을 이유가 없죠.
graph TD
Internet["Internet"] --> LB["Load Balancer"]
LB --> WebServer["Web Server"]
WebServer --> DB[("Database")]
도구에 휘둘리지 않기 위한 ‘비주얼 에디터’
하지만 Mermaid 구문을 모두 외워서 직접 타이핑하는 것도 만만한 일은 아닙니다. 우리는 ‘인프라 구성을 고민하는 것’에 집중하고 싶지, ‘Mermaid 문법 에러’ 때문에 씨름하고 싶지는 않으니까요.
DevToolKits의 **인프라 구성도 빌더**는 바로 이런 고민을 해결하기 위해 만들어졌습니다.
직관적인 조작, 스마트한 출력
- 노드 배치: 서버나 DB 등 컴포네트들을 UI에서 클릭 한 번으로 추가합니다.
- 선 연결: 어떤 노드끼리 통신하는지 선택만 하면 됩니다.
- Mermaid 코드 복사: 완성된 도표를 그대로 코드로 복사할 수 있습니다.
출력된 Mermaid 코드를 GitHub의 README나 Notion에 붙여넣으면, 그곳이 바로 ‘항상 최신 상태인 구성도’가 됩니다. 수정이 필요할 때는 코드 한 줄만 바꾸면 끝이죠. 이런 가벼움이야말로 진정한 ‘살아있는 문서’의 모습입니다.
읽기 쉬운 구성도를 만드는 요령
노드와 선을 늘릴수록 도표는 복잡해집니다. 다음 점을 의식하면 나중에 다시 봐도 이해하기 쉬운 도표가 됩니다.
- 레이어로 그룹화하기: Mermaid의
subgraph를 써서 “네트워크 계층”, “앱 계층”, “데이터 계층”이나 VPC/가용 영역별로 묶으면 책임의 경계가 잘 보입니다. - 통신 방향 통일하기: 외부 → 로드 밸런서 → 앱 → DB처럼 위에서 아래(또는 왼쪽에서 오른쪽)로 흐름을 통일하면 데이터의 흐름을 직관적으로 따라갈 수 있습니다.
- 범례 대신 레이블 붙이기:
WebServer["Web Server (ECS)"]처럼 구체적인 이름을 넣어 두면 도표만으로 구성이 전달됩니다.
graph TD
subgraph Public
Internet["Internet"] --> LB["Load Balancer"]
end
subgraph Private
LB --> App["App Server"]
App --> DB[("RDS")]
end
처음부터 완벽한 도표를 노리기보다 먼저 주요 통신 경로만 그리고 변경할 때마다 코드를 갱신하는 편이 결과적으로 “항상 최신” 구성도를 유지할 수 있습니다.
그룹과 색상 구분으로 읽기 쉽게 하기
인프라 구성도 빌더에서는 노드마다 종류와 그룹을 지정할 수 있습니다.
- 그룹: 같은 이름을 넣은 노드가 Mermaid의
subgraph로 묶여 테두리로 둘러싸입니다(예:Private subnet·VPC). 그룹이 없는 노드가 먼저, 그룹은 입력한 순서대로 나옵니다. 연결선은 그룹 바깥에 쓰이므로 그룹을 가로지르는 선도 그대로 그을 수 있습니다 - 종류:
user·gateway·server·database·storage·network·cloud중에서 고릅니다 - 종류별 색상: 체크하면 사용 중인 종류에만 색이 붙습니다(
default는 색 없음). 예를 들어server는 파랑,database는 초록,user는 노랑,gateway는 보라입니다. 도면 영역은 다크 모드에서도 밝은 배경이므로 옅은 채우기와 짙은 글자의 조합으로 했습니다
subgraph grp_1["Private subnet"]
n3["App Server 1"]
n5[("Database")]
end
classDef infra_server fill:#dbeafe,stroke:#2563eb,color:#1e3a8a
class n3 infra_server
마치며
인프라 구성도는 한 번 만들고 끝나는 ‘예술 작품’이 아닙니다. 시스템의 성장에 맞춰 계속해서 모습을 바꾸는 ‘생명체’입니다.
마우스 노가다를 졸업하고 더 가볍고 정확하게.
여러분의 설계를 텍스트의 힘으로 시각화하여 팀원들과 항상 같은 최신 지도를 공유해 보세요.
💡 유용한 활용 팁: GitHub에서 Pull Request를 올릴 때, 인프라 변경 사항에 맞춰 Mermaid 코드도 함께 업데이트해 보세요. 코드 리뷰와 동시에 인프라 구성의 변경점도 함께 리뷰할 수 있어 문서가 낡아버리는 것을 방지할 수 있습니다.
고급 SVG 표시: 손으로 정리하고, 이어서 쓰기
Mermaid 코드 외에, 도표를 **자체 제작 「고급 SVG」**로도 볼 수 있습니다(표시 방식의 기본값이며, Mermaid 표시와 코드 복사도 그대로 쓸 수 있습니다).
- 모양: 그림자가 있는 카드에 노드 종류 이름을 작게 붙이고, 그룹은 탭 모양의 이름이 달린 색 테두리로 그립니다. 실선·점선·굵은 선·화살표 없는 선을 구분해 그리고, 레이블도 붙일 수 있습니다
- 조작: 노드 위에 올리면(키보드는 포커스) 연결된 선만 남고, 클릭하면 연결 대상과 출처가 나옵니다. 노드를 드래그(또는 포커스한 뒤 방향키)해서 재배치하고, 「배치 초기화」로 자동 배치로 되돌릴 수 있습니다
- 저장: 도표는 너비에 맞춰 축소하고, 확대·축소하고, 정리한 배치 그대로 SVG와 PNG로 저장할 수 있습니다
- 내보내기: Mermaid 외에 Graphviz DOT·PlantUML·D2·Mermaid
architecture-beta로 내보낼 수 있습니다
만든 구성도와 옮긴 노드의 위치는 이 브라우저에 자동으로 저장되어, 다음에 열어도 이어서 쓸 수 있습니다. 저장한 내용은 삭제하거나 JSON으로 내보내고 불러올 수도 있습니다. 서버로는 보내지 않습니다.
자주 묻는 질문
Mermaid 구성도는 어디에 붙여넣어 쓸 수 있나요?
GitHub README와 Issue/PR, GitLab, Notion 등 Mermaid를 지원하는 많은 서비스에서 코드 블록으로 붙여넣으면 그대로 도표로 렌더링됩니다. 이미지와 달리 텍스트로 관리할 수 있어 Git 차이(diff)에 남고 변경 이력을 추적할 수 있는 것이 장점입니다.
draw.io나 파워포인트와 비교한 장점은?
GUI 도구는 외형을 세밀하게 조정할 수 있지만 수정과 재출력이 번거로워 방치되기 쉽습니다. Mermaid는 텍스트 한 줄만 바꾸면 도표가 갱신되고 Git으로 버전 관리할 수 있어, 구성 변경에 따라가기 쉽고 ‘항상 최신’을 유지하기 좋습니다.
입력한 구성 정보는 외부로 전송되나요?
인프라 구성도 빌더는 브라우저 안에서 처리가 완결되며 입력한 구성이나 Mermaid 코드를 서버로 보내지 않습니다. 사내 시스템 구성처럼 민감한 정보도 안심하고 도식화할 수 있습니다.
크고 복잡한 구성도를 보기 좋게 하려면?
Mermaid의 subgraph로 네트워크·앱·데이터 계층이나 VPC/영역별로 그룹화하고, 통신 방향을 위에서 아래(또는 왼쪽에서 오른쪽)로 통일하면 책임의 경계와 데이터의 흐름을 따라가기 쉬워집니다. 처음부터 모두 그리기보다 주요 경로만 그리고 변경할 때마다 갱신하는 편이 도표의 신선도를 유지하기 쉽습니다.
