연동

Architecto를 즐겨 쓰는 도구와 플랫폼에 연결

Architecto는 팀이 이미 사용하는 도구와 자연스럽게 연동됩니다.

버전 관리

GitHub

저장소를 가져오고 코드 변경 시 아키텍처 생성을 실행합니다.

설정:

연동 → GitHub로 이동합니다
GitHub 연결을 클릭합니다
Architecto의 저장소 접근을 승인합니다
특정 저장소 또는 전체를 선택합니다

사용 사례:

Terraform 파일을 다이어그램으로 가져오기
IaC 변경 시 아키텍처 자동 갱신
저장소 코드에서 아키텍처 생성
다이어그램을 풀 리퀘스트에 연결

작업:

- Import Terraform from GitHub
- Watch for changes in .tf files
- Create PR comments with diagram preview
- Sync architecture to GitHub discussion

GitLab

GitHub 연동과 유사한 기능 (출시 예정)

GitLab 저장소에서 가져오기
GitLab CI/CD 파이프라인 연동
다이어그램을 병합 요청과 동기화

코드형 인프라

Terraform

Terraform 파일을 파싱하고 아키텍처 다이어그램을 생성합니다.

동작 방식:

.tf 파일을 올리거나 GitHub를 연결합니다
Architecto가 공급자 리소스를 파싱합니다
리소스 정의에서 토폴로지를 생성합니다
각 리소스의 노드를 만듭니다
의존성에 따라 연결합니다

예시: 다음 Terraform 파일을 올리면:

resource "aws_vpc" "main" {
  cidr_block = "10.0.0.0/16"
}

resource "aws_lb" "main" {
  load_balancer_type = "application"
}

resource "aws_instance" "app" {
  instance_type = "t3.medium"
  count         = 3
}

resource "aws_rds_cluster" "db" {
  engine = "aurora-postgresql"
}

VPC → 로드 밸런서 → EC2 인스턴스 → RDS를 보여 주는 다이어그램이 생성됩니다.

CloudFormation

AWS CloudFormation 템플릿을 가져옵니다.

YAML/JSON 템플릿 파싱
스택에서 토폴로지 생성
모든 AWS 리소스 지원

Bicep

Azure 인프라 언어 지원 (출시 예정)

CDK(코드형 인프라)

AWS CDK 지원 (출시 예정)

협업 플랫폼

Discord

Discord에서 아키텍처를 공유하고 알림을 받습니다.

설정:

연동 → Discord로 이동합니다
Discord에 추가를 클릭합니다
워크스페이스를 선택하고 승인합니다
알림 채널을 선택합니다

기능:

Discord 채널에서 아키텍처 공유
다음 알림 수신:
- 나에게 공유된 아키텍처
- 공유 다이어그램에 추가된 댓글
- 팀 초대
Discord에서 아키텍처 검색
아키텍처 링크를 미리보기로 펼치기

예시:

/architecto share my-ecommerce-arch #team-architecture

Jira

아키텍처를 Jira 이슈와 연결하고 분석 결과로 티켓을 만듭니다.

설정:

연동 → Jira로 이동합니다
Jira Cloud ID를 입력합니다
API 토큰을 생성해 붙여넣습니다

기능:

아키텍처를 Jira 에픽과 스토리에 연결
분석 결과에서 티켓 생성:
- 비용 최적화 제안
- 확장성 권장사항
- 보안 완화 조치
- 규정 준수 문제
아키텍처 다이어그램을 Jira에 첨부
Architecto에서 이슈 상태 갱신

커뮤니케이션

이메일

아키텍처와 보고서를 이메일로 보냅니다.

팀 외부 사람에게 다이어그램 공유
분석 보고서 이메일 전송
새 아키텍처의 정기 이메일 요약
내보낸 파일을 이메일에 첨부

Teams (출시 예정)

Microsoft Teams 연동

Teams 채널에 공유
Teams 알림 수신
Teams 채팅에 다이어그램 삽입

분석과 모니터링

Datadog (출시 예정)

아키텍처 배포를 모니터링합니다.

New Relic (출시 예정)

성능 메트릭을 추적합니다.

Grafana (출시 예정)

메트릭과 로그를 시각화합니다.

클라우드 공급자

AWS

기본 AWS 연동(이미 포함됨)

AWS 서비스 아이콘 200개 이상
가격 데이터 연동
VPC와 보안 그룹 지원

Google Cloud Platform

GCP 연동(이미 포함됨)

GCP 서비스 아이콘
가격 데이터
VPC 지원

Microsoft Azure

Azure 연동(이미 포함됨)

Azure 서비스 아이콘 100개 이상
가격 데이터
가상 네트워크 지원

Kubernetes

Kubernetes와 컨테이너 오케스트레이션(이미 포함됨)

Pod, Deployment, Service 아이콘
다중 클러스터 지원
Helm 차트 시각화 (출시 예정)

API 테스트

Postman

API와 연동을 테스트합니다.

Postman 컬렉션
가져온 후 모든 엔드포인트 테스트
사전 설정된 인증

AI와 자동화 (출시 예정)

GitHub Actions

아키텍처 워크플로를 자동화합니다.

- name: Update Architecture
  uses: architecto/update-architecture@v1
  with:
    terraform-path: ./infrastructure
    api-key: ${{ secrets.ARCHITECTO_API_KEY }}

Zapier

Zapier로 1000개 이상의 앱과 연결합니다.

Zapier 이벤트로 작업 실행
연결된 앱으로 아키텍처 전송

맞춤형 연동

웹훅

웹훅으로 맞춤형 연동을 만듭니다.

POST /webhooks
{
  "url": "https://your-app.com/architecto-webhook",
  "events": ["architecture.created", "analysis.completed"]
}

API

REST API로 원하는 기능을 구축합니다.

전체 API 참조
Python, Node.js, Go, Ruby, Java SDK
GraphQL 지원 (출시 예정)

연동 설정 모범 사례

최소 권한 — 필요한 권한 범위만 승인
비밀정보 보호 — 환경 변수에 API 키 저장
먼저 테스트 — 스테이징 환경에서 연동 테스트
모니터링 — 연동 상태와 오류율 추적
문서화 — 팀 문서를 최신 상태로 유지

문제 해결

연동을 찾을 수 없나요?

연동 페이지 확인
GitHub에 기능 요청 등록
support@architecto.dev로 이메일 문의

연동이 작동하지 않나요?

API 키 만료 확인
웹훅 URL에 접근 가능한지 확인
연동 설정에서 오류 로그 확인
support@architecto.dev로 문의

다음 단계:

연동

이 페이지의 내용