Codespaces 만들기 및 삭제 문제 해결

이 문서에서는 스토리지 및 구성 문제를 포함하여 Codespace를 만들거나 삭제할 때 발생할 수 있는 일반적인 문제에 대한 문제 해결 단계를 제공합니다.

이 기사에서

codespace 만들기

codespace를 만들 수 있는 액세스 권한 없음

GitHub Codespaces 는 모든 리포지토리에 사용할 수 없습니다. 코드스페이스를 만드는 옵션이 표시되지 GitHub Codespaces 않으면 해당 리포지토리에 사용할 수 없습니다.

개인 계정의 GitHub Codespaces 월간 남은 사용량이 있거나 결제 방법 및 지출 한도를 설정한 경우 공용 리포지토리에 대한 코드스페이스를 만들 수 있습니다.

개인 계정이 소유한 프라이빗 리포지토리의 경우, 최소한 읽기 권한이 있다면 해당 리포지토리에 대한 Codespace를 생성할 수 있습니다. 리포지토리가 프라이빗 이고 조직이 소유하고 있는 경우 조직 또는 상위 엔터프라이즈의 설정에 따라 해당 리포지토리에 대한 코드스페이스를 만들거나 만들지 못할 수 있습니다.

리포지토리의 codespace를 생성할 수 없다면, 다음 조직 또는 Enterprise 설정 중 하나가 원인일 수 있습니다.

  • 조직 및 엔터프라이즈 소유자는 조직의 개인 GitHub Codespaces및 내부 수 있는 사용자를 선택할 수 있습니다. 자세한 내용은 조직에 GitHub Codespaces 사용 또는 사용 안 함을(를) 참조하세요.
  • 조직 및 엔터프라이즈 소유자는 조직의 개인 리포지토리 중 일부 또는 전부에 대해 포크를 사용하지 않도록 설정할 수 있습니다. 리포지토리에 대한 읽기 권한만 있으면서 포크 권한이 없다면, 해당 리포지토리의 Codespace를 생성할 수 없습니다. 자세한 내용은 조직에 대한 포크 정책 관리을 참조하세요.

Codespace 생성 가능 여부에 영향을 미치는 조직 및 Enterprise 설정에 대한 자세한 내용은 조직에 GitHub Codespaces 사용 또는 사용 안 함을(를) 참조하세요.

개인 계정의 사용량 관리 및 지출 한도 설정 방법은 GitHub Codespaces 청구 및 예산을 설정하여 요금제 제품에 대한 지출을 제어합니다.을(를) 참조하세요.

codespace를 만들었는데 열리지 않음

codespace를 만들었는데 열리지 않는 경우:

  1. 캐싱 또는 보고 문제가 있는 경우 페이지를 다시 로드해 보세요.
  2. 페이지 GitHub Codespaces 로 이동하여 새 코드 영역이 목록에 있는지 확인합니다https://github.com/codespaces. 프로세스에서 codespace를 성공적으로 만들었지만 브라우저에 다시 보고하지 못했습니다. 새 codespace가 나열되면 해당 페이지에서 직접 열 수 있습니다.
  3. 일시적인 통신 오류를 제외하려면 리포지토리에 대한 codespace 만들기를 다시 시도합니다.

여전히 GitHub Codespaces을 사용할 수 있는 리포지토리에 대해 codespace를 만들 수 없는 경우, 지원에 문의해야 할 수 있습니다. 자세한 내용은 GitHub Codespaces에 대한 지원 작업을(를) 참조하세요.

Codespace 영역을 만들지 못했습니다.

codespace 생성에 실패하는 경우, 이는 클라우드 환경의 일시적인 인프라 장애(가상 머신 프로비저닝 오류 등)가 원인일 수 있습니다. 컨테이너 빌드에 1시간 이상 소요될 경우 실패가 발생하는 것이 일반적입니다. 이렇게 되면 빌드가 중단되며, 결과적으로 codespace 생성에 실패하게 됩니다.

참고

생성에 실패한 codespace는 사용이 불가능하므로 반드시 삭제해야 합니다. 자세한 내용은 Codespace 삭제을(를) 참조하세요.

codespace를 생성했지만 생성에 실패한 경우:

  1. GitHub의 상태 페이지에서 발생 중인 인시던트를 확인하십시오.

  2. 페이지로 이동하여 GitHub Codespaces코드스페이스를 삭제하고 새 코드스페이스를 만듭니다.

  3. 컨테이너 빌드 과정에서 스트리밍되는 로그를 모니터링하여 빌드가 정상적으로 진행되고 있는지 확인하세요. 1시간을 초과하는 컨테이너 빌드는 자동으로 취소되어 생성에 실패하게 됩니다.

    사용자의 입력을 기다리는 메시지를 표시하고 응답을 대기하는 스크립트가 실행될 때가 이러한 상황이 발생하는 일반적인 시나리오 중 하나입니다. 이를 위해 빌드를 비대화형으로 진행할 수 있도록 대화형 프롬프트를 제거합니다.

참고

빌드 중에 로그를 확인하려면 다음 단계를 따르세요. * 브라우저에서 빌드 프로세스 초기 단계에서 지연이 발생할 경우, 자동으로 ‘codespace 설정’ 안내 페이지로 전환됩니다. 로그 보기를 클릭하세요.

브라우저의 "codespace 설정" 페이지의 스크린샷. 짙은 주황색 윤곽선이 ‘로그 보기’ 필드를 강조합니다.

데스크톱 애플리케이션에서 VS Code 표시되는 "원격 연결 설정" 팝업 메시지에서 코드스페이스 빌드를 클릭합니다.

"원격 연결 설정: codespace 빌드"를 읽는 VS Code의 팝업 메시지 스크린샷

로그 메시지는 VS Code에서 터미널에 출력됩니다.

  1. 컨테이너 빌드에 많은 시간이 소요된다면, 사전 빌드 기능을 활용해 codespace 생성 시간을 단축할 수 있습니다. 자세한 내용은 사전 빌드 구성을(를) 참조하세요.

codespace 삭제

Codespace는 아래의 경로를 통해서만 삭제가 가능합니다.

  • codespace를 만든 사람
  • 조직 소유의 codespace에 대한 조직 소유자
  • 보존 기간이 끝날 때 자동 삭제

자세한 내용은 Codespace 삭제 및 Codespace의 자동 삭제 구성을(를) 참조하세요.

컨테이너 스토리지

codespace를 만들 때 스토리지가 한정되어 있으므로 시간이 지남에 따라 공간을 확보해야 할 수 있습니다. 터미널에서 GitHub Codespaces 다음 명령 중 어느 것을 실행하여 스토리지 공간을 확보해 보세요.

  • sudo apt autoremove를 사용하여 더 이상 사용되지 않는 패키지를 제거합니다.
  • sudo apt clean을 사용하여 apt 캐시를 정리합니다.
  • sudo find / -printf '%s %p\n'| sort -nr | head -10을 사용하여 codespace에서 가장 큰 상위 10개 파일을 확인하세요.
  • 빌드 아티팩트 및 로그와 같은 불필요한 파일을 삭제합니다.

몇 가지 더 파괴적인 옵션:

  • docker system prune을 사용하여 사용하지 않는 Docker 이미지, 네트워크 및 컨테이너를 제거합니다(모든 이미지를 제거하려면 -a, 모든 볼륨을 제거하려면 --volumes 추가).
  • 작업 트리에서 추적되지 않은 파일(git clean -i)을 제거합니다.

구성

개발 컨테이너 구성 변경으로 인해 컨테이너 오류가 발생하는 경우 codespace는 복구 모드로 실행되고 오류 메시지가 표시됩니다.

This codespace is currently running in recovery mode due to a container error.

빌드 로그를 꼼꼼히 살펴본 후, 필요한 경우 개발 컨테이너 설정을 수정하세요. 자세한 내용은 GitHub Codespaces 로그을(를) 참조하세요.

그 후에는 codespace를 재시작하거나 컨테이너를 새로 빌드하여 변경 사항을 적용할 수 있습니다. 컨테이너를 다시 빌드하는 방법에 대한 자세한 내용은 개발 컨테이너 소개을(를) 참조하세요.