개요

웹 애플리케이션으로 사용 가능한 Cloudcraft의 Auto Layout 기능은 AWS 환경의 다이어그램을 자동으로 생성하는 강력한 도구입니다. 이 기능을 통해 문서화 프로세스를 크게 간소화하고 새로운 팀원을 쉽게 온보딩할 수 있습니다.

이 가이드에서는 일반적인 명령줄 유틸리티와 Cloudcraft 개발자 API를 통해 이 기능을 활용하는 방법을 단계별로 알아보겠습니다.

사전 필수 조건

• 유효한 Cloudcraft Pro 구독
• 읽기-쓰기 권한이 있는 API 키
• 스캔하려는 AWS 또는 Azure 계정의 계정 ID
• Unix와 유사한 환경(Linux, macOS 또는 Linux용 Windows 하위 시스템) 대한 액세스
• 명령줄 작업에 익숙함
• API 사용에 대한 기본 지식

계정 스냅샷 생성하기

Snapshot AWS account 또는 Snapshot Azure account 엔드포인트를 사용하여 AWS 또는 Azure 계정의 스냅샷을 생성하세요. 이 프로세스는 Cloudcraft UI의 Scan Now 버튼 기능을 그대로 반영하며, 스냅샷을 JSON 형식으로 출력합니다.

터미널에서 다음 명령을 실행하세요.

curl \
  --url 'https://api.cloudcraft.co/PROVIDER/account/ACCOUNT_ID/REGION/json' \
  --tlsv1.2 \
  --proto '=https' \
  --silent \
  --header "Authorization: Bearer API_KEY"

PROVIDER를 azure 또는 aws와 같은 클라우드 공급자로 변경하고, ACCOUNT_ID를 Cloudcraft의 AWS 또는 Azure 계정 ID로 변경합니다. REGION은 원하는 스캔 지역으로, API_KEY는 Cloudcraft API키로 변경합니다.

명령을 실행하면 AWS 계정 스냅샷의 JSON 형식이 표시됩니다. 이 출력을 파일에 직접 저장하려면 다음 명령을 사용하세요.

curl \
  --url 'https://api.cloudcraft.co/PROVIDER/account/ACCOUNT_ID/REGION/json' \
  --tlsv1.2 \
  --proto '=https' \
  --silent \
  --header "Authorization: Bearer API_KEY" > '/tmp/account-infra.json'

스냅샷은 임시 디렉터리에 파일 이름 account-infra.json으로 저장됩니다.

새 블루프린트 생성

다음으로, Create blueprint API 엔드포인트를 사용하여 Cloudcraft 계정에 새 블루프린트를 생성하세요. 저장된 스냅샷 데이터는 이 요청의 페이로드 역할을 합니다.

터미널에서 다음 명령을 실행하세요.

curl \
  --request 'POST' \
  --url 'https://api.cloudcraft.co/blueprint' \
  --tlsv1.2 \
  --proto '=https' \
  --silent \
  --header 'Content-Type: application/json' \
  --header "Authorization: Bearer API_KEY" \
  --data '@/tmp/account-infra.json'

API_KEY를 Cloudcraft API 키로 바꿉니다.

완료되면 클라우드 인프라스트럭처를 반영하는 새로운 블루프린트가 Cloudcraft 계정에 생성되어 Scan Now 및 Auto Layout 버튼을 사용한 것과 같은 효과가 재현됩니다.

프로세스와 관련해 문제가 발생하거나 질문이 있을 경우 Cloudcraft 지원팀에 문의하세요.