Skip to main content

포함된 사용량을 최대한 활용하기

개인 계정에 포함된 GitHub Codespaces의 무료 사용에 대해 알아보세요..

개인 GitHub 계정에는 매월 GitHub Codespaces의 무료 사용 할당량이 포함됩니다.

참고: GitHub Codespaces의 무료 사용은 개인 계정만 포함됩니다. 조직 또는 엔터프라이즈 계정은 포함되지 않습니다.

Codespaces 사용량에는 컴퓨팅과 스토리지의 두 가지 유형이 있습니다. 월별 청구 기간 동안, Codespaces을(를) 사용할 때 컴퓨팅 및 스토리지 사용량은 컴퓨팅 또는 스토리지가 소비될 때까지 개인 GitHub 계정에 포함된 무료 사용 할당량에서 차감됩니다. 이러한 제한 중 하나에 도달하면 지출 한도 및 결제 방법을 설정하지 않는 한 GitHub Codespaces의 사용이 제한됩니다. 할당량이 갱신될 때까지 청구되는 새 코드스페이스를 만들거나 기존 코드스페이스를 열 수 없습니다. GitHub Codespaces의 사용을 지불하는 조직이 소유한 리포지토리에 액세스할 수 있는 경우에도, 해당 리포지토리에 대한 코드스페이스를 만들 수 있습니다.

매월 개인 계정에 제공되는 무료 사용량은 오픈 소스 기여를 하거나, 사이드 프로젝트에서 무료로 작업할 수 있도록 설계되었습니다. 그것은 무료로 매일 일을 하기에 충분하도록 의도된 것은 아닙니다.

Codespaces 컴퓨팅 정보

Codespaces 컴퓨팅은 코어 시간 단위로 계산되는데, 이것은, 코드스페이스가 활성 상태인 시간, 코드스페이스의 컴퓨터 유형에 대한 승수입니다. 예를 들어, 2코어 컴퓨터의 경우 2승수, 8코어 컴퓨터의 경우 8의 승수)를 곱한 값입니다. 코드스페이스를 생성하거나 시작하면 코드스페이스가 활성화됩니다. 코드스페이스를 중지하거나 삭제하거나 자동으로 중지 또는 삭제할 때, 코드스페이스가 활성 상태가 중지됩니다.

기본 유휴 시간 제한, 즉 비활성 시간 후 코드스페이스를 중지하는 시간은 30분입니다. 필요하다면 이를 줄일 수 있습니다. 자세한 내용은 ‘GitHub Codespaces 청구 관련 정보’의 ‘컴퓨팅 사용량 청구 정보’ 섹션을 참조하세요.

Codespaces 스토리지 정보

github.com/codespaces ‘나의 코드스페이스’ 페이지에서 각 코드스페이스의 스토리지 사용량을 확인할 수 있습니다.

https://github.com/codespaces 페이지에 있는 세 개의 코드스페이스 목록의 스크린샷."

참고: 코드스페이스의 개발 컨테이너가 기본 이미지에서 구축된 경우, 이 페이지에 표시된 코드스페이스의 크기에는 기본 개발 컨테이너의 크기가 포함되지 않습니다. 기본 개발 컨테이너에 대한 스토리지는 무료로 제공합니다. 자세한 내용은 ‘기본 개발 컨테이너에 대한 스토리지 사용량’을 참조하세요.

청구를 위해 Codespaces 스토리지는 기가바이트-개월 단위로 계산됩니다. 이는 각 코드스페이스가 생성부터 삭제까지 사용하는 총 스토리지에 더해 사전 빌드에 대한 스토리지의 누적 측정값입니다. 자세한 내용은 ‘GitHub Codespaces 청구 관련 정보’의 ‘스토리지 사용량 청구’ 구역을 참조하세요.

제 월별 스토리지는 어디로 갔나요?

사용하지 않는 코드스페이스를 삭제하면 개인 계정에 포함된 무료 스토리지를 불필요하게 사용하지 않습니다. 그러나 사전 빌드 구성을 설정한 경우, 월별 청구 주기 동안 포함된 스토리지가 계속 감소할 수 있습니다.

‘나의 코드스페이스’ 페이지에는 사전 빌드가 나열되지 않지만, 리포지토리용으로 만든 사전 빌드는 현재 해당 리포지토리에 대한 코드스페이스가 없는 경우에도 스토리지를 사용합니다. 이를 방지하기 위해, 설정한 사전 빌드 구성을 삭제할 수 있습니다. 자세한 내용은 "GitHub Codespaces 사전 빌드 관련 정보" 및 "사전 빌드 관리"을 참조하세요.

Codespaces 사용량 이해하기

GitHub 설정에서 현재 월별 청구 주기 대한 누적 GitHub Codespaces 사용량을 검사할 수 있습니다. 자세한 내용은 "GitHub Codespaces 사용량 확인"을(를) 참조하세요.

‘사용 시간’ 및 ‘스토리지’에 대한 수치를 보여 주는 청구 페이지 ‘Codespaces’ 구역의 스크린샷

‘사용 시간’ 및 ‘스토리지’ 구역을 확장하여 자세한 내용을 확인할 수 있는데, 예를 들어 사전 빌드에서 사용한 스토리지의 양을 확인할 수 있습니다.

예를 들어 스토리지를 사용하는 사전 빌드가 있는 리포지토리를 알고 싶다면, 사용량 보고서를 생성할 수 있습니다. 사용량 보고서는 CSV 파일이며 전자 메일로 보냅니다. 사용량 보고서를 생성하는 방법에 대한 자세한 내용은 ‘GitHub Codespaces 사용량 확인’을(를) 참조하세요.

Codespaces 사용량을 보려면 보고서를 필터링하여 Product열에 ‘Codespaces’를 멘션하는 행만 표시하세요.

Microsoft Excel의 사용량 보고서 스크린샷. ‘제품’ 열의 모든 항목은 ‘Codespaces - Linux’를 읽습니다.

기본 개발 컨테이너의 스토리지 사용량

리포지토리에 개발 컨테이너 구성을 추가하지 않거나 구성에서 사용할 개발 컨테이너 이미지를 지정하지 않는 경우 GitHub은(는) 기본 Linux 이미지에서 컨테이너를 만듭니다. 기본 개발 컨테이너 이미지에서 빌드된 기본 개발 컨테이너의 스토리지는 무료이며 포함된 스토리지를 이용하지 않습니다. 스토리지 사용량은 리포지토리의 파일 및 VS Code 확장을 포함하여 이후에 코드스페이스에 추가하는 모든 파일을 기반으로 합니다. 대체 기본 이미지를 사용하는 경우, 결과 컨테이너와 코드스페이스의 모든 파일이 사용된 스토리지로 계산될 것입니다. 기본 Linux 이미지에 포함된 내용에 대한 자세한 정보는 devcontainers/images 리포지토리를 참조하세요.

코드스페이스의 개발 컨테이너를 만드는 데 사용된 이미지를 검사할 수 있습니다. 코드스페이스의 터미널에서 다음 명령을 실행합니다.

Shell
devcontainer-info

현재 코드 영역에 대한 개발 컨테이너가 기본 이미지에서 빌드된 경우, 이 명령의 출력에는 다음 정보가 포함됩니다.

- Definition ID: universal
- Source code repository: https://github.com/devcontainers/images

허용된 사용량을 더 효율적으로 활용하는 팁

  • 코드스페이스는 실행되는 동안 컴퓨팅 사용량을 이용합니다. 코드스페이스를 사용하지 않는 경우, 코드스페이스를 중지함으로써 불필요한 컴퓨팅 사용을 방지할 수 있습니다. 자세한 내용은 "Codespace 중지 및 시작"을(를) 참조하세요.

  • 개인 설정에서 Codespaces의 유휴 시간 제한을 기본인 30분 미만으로 줄일 수 있습니다. 이렇게 하면 코드스페이스가 자동으로 중지되기 전에 비활성 시간이 단축됩니다. 이러면 컴퓨팅 사용량을 절약할 수 있습니다. 자세한 내용은 "Github Codespaces의 시간 제한 기간 설정"을(를) 참조하세요.

  • 코드스페이스는 존재하는 동안 스토리지를 이용합니다. 사용을 종료했고 다시 사용하지 않을 것임을 아는 코드스페이스를 삭제해야 합니다. 자세한 내용은 "Codespace 삭제"을(를) 참조하세요.

    참고: 코드스페이스를 삭제해도 이것은 누적 수치이기 때문에, 현재 달의 청구에 사용된 스토리지 용량이 감소하지는 않습니다.

  • 삭제하지 않은 코드스페이스가 자동으로 삭제되도록 보존 기간을 구성하세요. 기본 보존 기간은 30일입니다. 자세한 내용은 "Codespace의 자동 삭제 구성"을(를) 참조하세요.

  • Visual Studio Code 확장 이용 스토리지. 필요한 확장만 설치하고 있는지 확인하세요. 코드스페이스에서 이 명령을 실행함으로써 확장에서 사용되는 공간의 양을 확인할 수 있습니다.

    Shell
    du -h -s ~/.vscode-remote/extensions
    
  • GitHub.com의 청구 페이지로 이동하고, https://github.com/settings/billing, ‘Codespaces‘ 구역의 수치를 검토하여, 컴퓨팅 및 스토리지 사용량을 모니터링하세요.

    참고: 스토리지는 매 시간마다 계산되고 기존 스토리지 사용량에 추가됩니다. 따라서 사용된 스토리지는 월간 청구 주기 동안 누적됩니다. 이것이 의미하는 바는, 청구 기간 동안 청구 페이지에 표시되는 값은 오직 증가하거나 동일하게 유지된다는 것입니다. 새 청구 주기가 시작하면 사용량이 영으로 다시 설정됩니다. 코드스페이스 또는 사전 빌드를 삭제해도 당월의 사용량 수치가 줄어들지는 않지만, 스토리지 사용량이 누적되는 속도는 줄어듭니다.

  • 필요한 만큼의 버전과 지역에 대해서만 사전 빌드를 사용하고 있는지 확인하세요. 자세한 내용은 "GitHub Codespaces 사전 빌드 관련 정보" 및 "GitHub Codespaces 청구 관련 정보"을 참조하세요.

    참고: 포함된 스토리지 사용량이 소진된 경우, 지출 한도 또는 포함된 사용 할당량 갱신을 설정할 때까지 새로운 사전 빌드를 사용할 수 없습니다.

  • 리포지토리의 설정에서 사전 빌드를 구성했지만 해당 리포지토리에 GitHub Codespaces을(를) 사용하지 않는 경우 해당 리포지토리의 사전 빌드가 포함된 스토리지 허용량을 불필요하게 사용하지 않도록 미리 빌드 구성을 삭제하는 것이 좋습니다. 사전 빌드 구성을 삭제하면 연결된 모든 사전 빌드가 삭제되어, 해당 시점부터 스토리지 이용이 줄어듭니다. 자세한 내용은 "사전 빌드 관리"을(를) 참조하세요.

    리포지토리 설정의 Codespaces 페이지에서 사전 빌드 구성을 확인할 수 있습니다. 자세한 내용은 "사전 빌드 구성"을(를) 참조하세요.

    또는 사용량 보고서를 검토하여 사전 빌드가 있는 리포지토리를 검사할 수 있습니다. 자세한 내용은 위의 ‘Codespaces 사용량 이해하기’를 참조하세요.

  • codespace에 대해 기본 개발 컨테이너 이미지에서 빌드된 컨테이너의 스토리지는 무료이며 포함된 스토리지를 줄이지 않습니다. 따라서 보다 전문적인 이미지를 지정하는 대신, 개발 컨테이너 구성에서 기본 이미지를 사용하여 개발 컨테이너가 스토리지 허용량을 이용하는 것을 방지할 수 있습니다. 자세한 내용은 위의 ‘개발 컨테이너 소개’ 및 ‘기본 개발 컨테이너에 대한 스토리지 사용량’을 참조하세요.