시작하기

환영합니다! 이 가이드에서는 Architecto로 클라우드 아키텍처를 설계, 분석, 문서화하기 위해 알아야 할 내용을 안내합니다.

Architecto란?

Architecto는 클라우드 아키텍처 아이디어를 운영 환경에 적합한 설계로 바꾸는 AI 네이티브 플랫폼입니다. 새 인프라를 구상하거나 기존 시스템을 검토할 때, 초기 개념부터 팀 검토와 전문 문서화까지 전체 과정을 간소화합니다.

주요 역량

즉각적인 아키텍처 생성

• 자연어 입력 — 쉬운 말로 인프라 요구사항 설명
• 다중 클라우드 옵션 — AWS, GCP, Azure, Kubernetes, 하이브리드 환경의 제안
• 시각적 캔버스 — 직관적인 드래그 앤 드롭으로 다이어그램 편집과 개선

지능형 분석

• 비용 분석 — 규모별 재무 영향 이해
• 확장성 테스트 — 문제가 되기 전에 병목 식별
• 보안 검토 — 자동 위협 모델링과 취약점 평가
• 성능 시뮬레이션 — 부하 상황의 지연과 처리량 예측

전문 문서화

• 자동 문서 생성 — 아키텍처에서 RFC, ADR, 런북 작성
• 코드 분석 — 기존 Terraform 또는 CloudFormation 파일을 다이어그램으로 파싱
• 리치 에디터 — 시각 자료를 포함하는 향상된 Markdown용 HyperDocs

팀 협업

• 안전한 공유 — 토큰 링크, 댓글 스레드, 피드백
• 브랜딩 내보내기 — 사용자 테마의 PPT, PDF, PNG
• 조직 관리 — 팀원 역할, 초대, 라이선스

첫 단계

1. 계정 생성

architecto.dev에서 이메일, OAuth, 패스키로 가입합니다.

2. 대시보드 탐색

다음 항목에 빠르게 접근할 수 있습니다.

• 최근 프로젝트 — 이전에 만든 아키텍처
• 패턴 라이브러리 — 업계 표준 참조 아키텍처 240개 이상
• 빠른 작업 — 설계, 코드 가져오기, 학습 시작 버튼

3. 첫 아키텍처 생성

방법을 선택하세요.

옵션 A: Architect AI 사용

1. “아키텍처 생성” → **“AI로 설명”**을 클릭합니다
2. 자연어 설명을 입력합니다. 예: “동시 사용자 1만 명을 지원하고 실시간 재고 동기화, 결제 처리, 다중 리전 장애 조치가 필요한 전자상거래 플랫폼”
3. 생성한 옵션을 검토합니다(보통 3~5개)
4. 선호하는 아키텍처를 선택합니다
5. 캔버스에서 구성요소를 조정하고 보안 그룹과 데이터 흐름을 수정합니다

옵션 B: 패턴 라이브러리 사용

1. “아키텍처 생성” → **“패턴에서 시작”**을 클릭합니다
2. 마이크로서비스, 서버리스, 다중 테넌트, 데이터 분석 등을 탐색합니다
3. 사용 사례에 맞는 패턴을 선택합니다
4. 구성요소를 구체적인 요구사항에 맞춥니다

옵션 C: 코드에서 가져오기

1. “아키텍처 생성” → **“Terraform에서 가져오기”**를 클릭합니다
2. GitHub 계정을 OAuth로 연결합니다
3. 저장소를 선택합니다
4. Terraform/CloudFormation 파일을 선택합니다
5. Architecto가 토폴로지를 생성하고 최적화 기회를 식별합니다

4. 아키텍처 분석

설계를 마치면 다음을 수행하세요.

비용 분석 실행

• 답하는 질문: “사용자 1천/1만/10만 명에서 비용이 얼마인가?”
• 식별: 비용 급증 지점과 재무적 지속 가능성의 한계
• 제안: 최적화 전략과 비용 절감 옵션

확장성 확인

• 테스트: 각 구성요소가 처리할 수 있는 동시 사용자 수
• 식별: 병목(주로 데이터베이스, 캐시, 로드 밸런서)
• 제안: 읽기 복제본, 샤딩, 수평 확장 패턴

보안 검토

• 분석: STRIDE 위협(스푸핑, 변조, 부인, 정보 공개, 서비스 거부, 권한 상승)
• 표시: 공격 경로와 취약한 구성요소
• 권장: 인증, 암호화, 요청 빈도 제한, WAF 등의 완화 조치

5. 문서 생성

아키텍처를 전문 문서로 바꾸세요.

RFC(Request for Comments) 작성

• 자동 생성: 문제 정의, 솔루션 개요, 절충점, 비용 분석, 보안 고려사항
• 삽입: 아키텍처 다이어그램, 비용 차트, 위협 분석
• 편집 가능: HyperDocs로 섹션 개선

ADR(아키텍처 결정 기록) 작성

• 기록: 대안보다 이 아키텍처를 선택한 이유
• 연결: 관련 결정, 절충점, 가정
• 상태: 진행 중, 제안됨, 승인됨, 폐기됨 등

런북 작성

• 포함: 배포 단계, 모니터링 설정, 인시던트 대응 절차
• 자동 입력: 구성요소 의존성, 엔드포인트 정보, 경보 임계값

6. 팀과 공유

1. **“공유”**를 클릭하고 토큰 링크를 생성합니다
2. 팀원에게 보냅니다(계정 없이 브라우저에서 작동)
3. 검토자는 다음을 할 수 있습니다.
   • 전체 토폴로지 보기
   • 인라인 댓글과 피드백 추가
   • 분석 결과 확인(비용, 보안, 확장성)
   • 이전 버전과 비교
4. 댓글이 추가되면 알림을 받습니다

7. 프레젠테이션용 내보내기

1. **“내보내기”**를 클릭하고 형식을 선택합니다(PNG, SVG, PDF, PPT)
2. 테마를 선택하거나 맞춤 브랜딩을 만듭니다.
   • 색상, 글꼴, 배경 스타일
   • 로고 위치
   • 구성요소별 강조색
3. 바로 발표할 수 있는 자료를 다운로드합니다

핵심 개념

토폴로지

흐름으로 연결한 노드로 아키텍처를 시각화합니다. 각 노드는 EC2, Lambda, RDS 등의 클라우드 구성요소입니다.

노드

아키텍처의 개별 구성요소입니다. Architecto에는 AWS, GCP, Azure, 일반 서비스 아이콘 200개 이상이 미리 로드되어 있습니다.

흐름

동기 API 호출, 비동기 메시징, 데이터베이스 쿼리 등의 데이터 이동을 보여 주는 노드 간 연결입니다.

프로필

클라우드 공급자 구성입니다. Architecto에는 AWS(가격 데이터 포함), GCP, Azure, Kubernetes, Docker 프로필이 내장되어 있습니다.

분석 모듈

비용, 보안, 확장성, 성능, 규정 준수 등 아키텍처의 한 측면을 평가하는 전문 도구입니다.

테마

내보낼 때 적용되는 색상, 글꼴, 아이콘 스타일, 배경, 레이아웃 등의 시각 설정입니다.

일반적인 워크플로

아키텍처 검토 주기

1. 설계자가 초기 아키텍처를 작성
2. 토큰 링크로 검토자에게 공유
3. 검토자가 의견과 제안 추가
4. 설계자가 토폴로지를 개선하고 분석 재실행
5. 버전 비교로 변경 확인
6. 최종 승인을 ADR에 기록

마이그레이션 계획

1. 현재 온프레미스 또는 기존 클라우드 구성을 작성
2. 목표 다중 클라우드 아키텍처 설계
3. “아키텍처 차이” 도구로 이전 단계 계획
4. 현재와 목표의 비용 비교
5. 단계별 마이그레이션 런북 생성

인시던트 대응

1. SRE가 장애 지점을 표시한 토폴로지를 빠르게 작성
2. 대응팀에 링크로 공유
3. 의심 원인과 영향 서비스 등의 주석 추가
4. 사후에 런북으로 전환해 재발 방지

학습 경로

1. 초급 퀴즈로 시작(클라우드 기초, 컴퓨팅, 스토리지)
2. 간격 반복 플래시카드로 진행
3. 실제 아키텍처를 설계하며 적용
4. 팀 검토로 피드백 수신

다음 단계

• 핵심 개념 학습 → 핵심 개념 읽기
• 기능 탐색 → 기능 가이드 보기
• 패턴 확인 → 아키텍처 패턴 탐색
• 연동 확인 → 연동 보기

---

질문이 있으신가요? FAQ를 확인하거나 Discord 커뮤니티에 참여하세요.