Structurizr, LikeC4, IcePanel 프로젝트를 원클릭으로 Archyl에 가져오기 - Archyl Blog

Structurizr DSL, LikeC4 또는 IcePanel에서 아키텍처 문서를 몇 분 만에 Archyl로 마이그레이션하세요. 시스템, 컨테이너, 컴포넌트, 관계 및 기술 정보를 자동으로 가져옵니다.

Structurizr, LikeC4, IcePanel 프로젝트를 원클릭으로 Archyl에 가져오기

아키텍처 프로젝트를 한 도구에서 다른 도구로 옮겨본 경험이 있다면, 그 과정을 잘 아실 겁니다. 모든 시스템을 수동으로 다시 만들고, 모든 관계를 다시 그리고, 모든 기술 레이블을 다시 입력하면서 빠뜨린 것이 없기를 바라는 것이죠. 규모가 있는 코드베이스라면, 이는 며칠에 걸친 지루한 작업이며 오류가 발생하는 것은 불가피합니다.

이러한 마이그레이션 장벽이야말로 팀이 더 이상 맞지 않는 도구에 묶여 있는 진짜 이유입니다. 도구가 훌륭해서가 아니라, 떠나는 것이 고통스럽기 때문입니다.

오늘, 이것이 바뀝니다. Archyl은 이제 Structurizr DSL, LikeC4, IcePanel에서 아키텍처 프로젝트를 직접 가져올 수 있습니다. 전체 C4 모델을 몇 분 만에 완전한 Archyl 프로젝트로 자동 변환합니다.

세 가지 형식, 하나의 가져오기 흐름

Archyl의 가져오기 기능은 가장 널리 사용되는 세 가지 C4 모델링 형식을 지원하며, 각각 완전한 구조적 충실도를 유지합니다.

Structurizr DSL

Structurizr는 Simon Brown(C4 모델의 창시자)이 만든 이 생태계에서 가장 확립된 도구입니다. .dsl 파일은 텍스트 기반 아키텍처 모델링의 사실상 표준입니다.

Archyl은 Structurizr DSL을 파싱하여 다음을 추출합니다:

  • 전체 설명이 포함된 소프트웨어 시스템과 사용자/액터
  • 시스템 내에 중첩된 컨테이너와 컴포넌트
  • 태그 기반 외부 시스템 감지
  • -> 구문을 사용한 모든 관계(설명 및 기술 정보 포함)
  • 위치 인자에서 추출한 기술 정보
  • 쉼표로 구분된 태그 문자열에서 추출한 태그

LikeC4

LikeC4는 더 새롭고 개발자 친화적인 C4 모델링 방식입니다. LikeC4 파일을 가져올 수 있는 다른 도구는 없습니다. Archyl이 최초입니다.

가져오기 도구는 LikeC4의 고유한 기능을 처리합니다:

  • 커스텀 요소 종류를 C4 개념에 매핑
  • 중첩된 요소 계층 구조를 컨테이너와 컴포넌트로 해석
  • #external 태그 감지로 경계 분류
  • technology: 속성 추출 및 적용

IcePanel

IcePanel은 시각화 중심의 C4 모델링 플랫폼으로, 아키텍처를 JSON 형식으로 내보냅니다.

IcePanel 가져오기 도구는 다음을 매핑합니다:

  • system 타입을 소프트웨어 시스템으로, actor 타입을 사용자로
  • app 및 store 타입을 컨테이너로, component 타입을 컴포넌트로
  • external: true 필드를 외부 시스템 분류로
  • **modelConnections**를 전체 메타데이터가 포함된 관계로

작동 방식

1단계 — Archyl 프로젝트에서 가져오기 모달을 엽니다. 2단계 — 소스 형식을 선택하고 콘텐츠를 업로드하거나 붙여넣습니다. 3단계 — Archyl이 유효성을 검사하고 미리보기를 표시합니다. 4단계 — 원클릭. 모든 요소가 프로젝트에 반영됩니다.

AI 에이전트 워크플로우용

동일한 가져오기 기능은 AI 코딩 에이전트를 위한 MCP import_dsl 도구를 통해서도 사용할 수 있습니다.

가져오기 후 얻을 수 있는 것

AI 기반 드리프트 감지 — 문서화된 아키텍처를 실제 코드베이스와 비교합니다. 아키텍처 준수 규칙 — 아키텍처 표준을 자동으로 적용합니다. DORA 메트릭 추적 — 아키텍처를 배포 성과에 연결합니다. ADR(아키텍처 결정 기록) — 선택 뒤에 숨은 이유를 기록합니다. API 계약 관리 — OpenAPI, gRPC, GraphQL 스펙을 연결합니다. 이벤트 채널 관리 — Kafka 토픽, RabbitMQ 익스체인지를 매핑합니다. MCP 통합 — 모든 AI 코딩 에이전트가 동일한 아키텍처 컨텍스트를 공유합니다.

이 기능을 만든 이유

마이그레이션 장벽을 완전히 제거하기로 결정했습니다. 가져오기 기능은 무료 플랜을 포함한 모든 플랜에서 사용할 수 있습니다.

지금 바로 가져오기를 시작하세요

가져오기 기능 사용해 보기 — 무료 계정을 만들고 아키텍처를 가져오세요.

아키텍처 문서는 수동으로 다시 입력하기엔 너무 소중합니다. 가져오세요.