콘텐츠로 이동

25. 개발 환경 (Codespaces) 구축

준비 작업 - Github Repository 생성

  • 먼저, Github에 접속하여 새로운 Repository를 생성합니다.
  • 우측 상단의 + 아이콘을 클릭한 후 New repository를 선택합니다.
  • 구성값
    • Repository name: mcp-server (원하는 이름으로 변경 가능)
    • Choose visibility: Public (Smithery는 공개 레포지토리만 배포 가능)
    • Add README file: On (최초 레포지토리 생성시 README 파일이 포함되도록 설정)

Github Codespaces란

  • Github에서 제공하는 클라우드 기반 개발 환경
  • 별도의 로컬 개발 환경 설정 없이 웹 브라우저에서 바로 코드 작성, 실행
  • Visual Studio Code기반의 편집기 제공

Codespace 생성 방법

  • Github 리포지토리 루트에서 Code 버튼 클릭
  • Codespaces 탭 선택 후 Create 버튼 또는 + 버튼 클릭

Codespace 생명주기

  1. 활성

    • 코드스페이스가 실행 중
  2. 유휴 (일시 중지)

    • 코드스페이스 일시 중지
    • 재시작 시 기존 작업 파일들은 그대로 보존 됨 (단, 메모리는 초기화 되어 있음)
    • 일정 시간 이상 활동이 없으면 자동으로 유휴 상태가 됨 (기본값: 30분)
  3. 종료 (삭제)

    • 코드스페이스 삭제
    • 코드스페이스에 있던 모든 파일은 삭제되어 복구 불가
    • 일정 기간 이상 활동이 없으면 자동으로 삭제 됨 (기본값: 30일)

Codespace 생명주기 관리

Codespaces Setting (Settings > codespaces)

  1. Default idle timeout

    • 일정 시간 동안 활동이 없으면 코드스페이스가 일시 중단됩니다.
    • 최대 값은 240 분(4시간)입니다.
  2. Default retention period

    • 비활성 코드스페이스는 마지막으로 중지된 날로부터 30일이 지나면 자동으로 삭제됩니다.
    • 최대값은 30 일입니다.

Codespace 요금 및 무료 할당량

무료 할당량

  • Github 무료 개인 계정의 경우 월별 120시간 (코어당) 및 15GB (월) 제공

    일반적으로 2코어를 사용하므로 월 60시간 무료 사용 가능

  • Github pro 유료 개인 계정의 경우 월별 180시간 (코어당) 및 20GB (월) 제공

    일반적으로 2코어를 사용하므로 월 90시간 무료 사용 가능

비용

  • 무료 할당량이 초과되면 사용한 시간 및 스토리지 용량에 따라 비용 청구

    카드 등록이 안되어 있으면 무료 할당량 초과 시 코드스페이스 사용이 정지되고 다음 달에 다시 무료 할당량이 초기화 됨

  • 컴퓨팅: 2코어 기준으로 시간당 $0.18

  • 스토리지: 1GB/월 기준으로 $0.07