codespace 만들기
codespace를 만들 수 있는 액세스 권한 없음
모든 리포지토리에서 GitHub Codespaces를 사용할 수 있는 것은 아닙니다. 해당 리포지토리에서 codespace 만들기 버튼을 찾을 수 없다면, GitHub Codespaces 기능을 사용할 수 없는 상태입니다.
개인 계정에서 GitHub Codespaces의 월별 포함 사용량을 초과한 후 기본 결제 방법과 지출 한도를 설정하면, 모든 퍼블릭 리포지토리에 대해 codespace를 만들 수 있습니다.
개인 계정이 소유한 프라이빗 리포지토리의 경우, 최소한 읽기 권한이 있다면 해당 리포지토리에 대한 Codespace를 생성할 수 있습니다. 조직이 소유한 리포지토리가 개인 또는 내부 저장소인 경우, 조직 또는 상위 Enterprise의 설정에 따라 해당 리포지토리에서 codespace를 생성할 수 있는지가 결정됩니다.
리포지토리의 codespace를 생성할 수 없다면, 다음 조직 또는 Enterprise 설정 중 하나가 원인일 수 있습니다.
- 조직 및 Enterprise 소유자는 조직의 프라이빗 및 내부 리포지토리에 대한 GitHub Codespaces 액세스 권한을 부여할 사용자를 지정할 수 있습니다. 자세한 내용은 조직에 Github Codespaces를 사용 또는 사용 안 함으로 설정을(를) 참조하세요.
- 조직 및 enterprise 관리자는 조직 내의 모든 또는 특정 개인 및 내부 리포지토리에서 포크 기능을 비활성화할 수 있습니다. 리포지토리에 대한 읽기 권한만 있으면서 포크 권한이 없다면, 해당 리포지토리의 Codespace를 생성할 수 없습니다. 자세한 내용은 조직에 대한 포크 정책 관리을(를) 참조하세요.
- 관리형 사용자 계정이면 리포지토리가 조직 소유 리포지토리의 포크이고 조직의 비용으로 GitHub Codespaces을(를) 사용할 수 있는 경우가 아니면 개인 리포지토리에 대한 codespace를 만들 수 없습니다. 자세한 내용은 Enterprise Managed Users 정보을(를) 참조하세요.
Codespace 생성 가능 여부에 영향을 미치는 조직 및 Enterprise 설정에 대한 자세한 내용은 조직에 Github Codespaces를 사용 또는 사용 안 함으로 설정을(를) 참조하세요.
개인 계정의 사용량 관리 및 지출 한도 설정 방법은 GitHub Codespaces 청구 및 예산을 설정하여 요금제 제품에 대한 지출을 제어합니다.을(를) 참조하세요.
codespace를 만들었는데 열리지 않음
codespace를 만들었는데 열리지 않는 경우:
- 캐싱 또는 보고 문제가 있는 경우 페이지를 다시 로드해 보세요.
- GitHub Codespaces 페이지(https://github.com/codespaces)로 이동하여 새 Codespace가 나열되어 있는지 확인하세요. 프로세스에서 codespace를 성공적으로 만들었지만 브라우저에 다시 보고하지 못했습니다. 새 codespace가 나열되면 해당 페이지에서 직접 열 수 있습니다.
- 일시적인 통신 오류를 제외하려면 리포지토리에 대한 codespace 만들기를 다시 시도합니다.
GitHub Codespaces를 사용할 수 있는 리포지토리에 대한 codespace를 만들 수 없는 경우 지원에 문의해야 할 수 있습니다. 자세한 내용은 GitHub Codespaces 관련 지원 작업을(를) 참조하세요.
Codespace 영역을 만들지 못했습니다.
codespace 생성에 실패하는 경우, 이는 클라우드 환경의 일시적인 인프라 장애(가상 머신 프로비저닝 오류 등)가 원인일 수 있습니다. 컨테이너 빌드에 1시간 이상 소요될 경우 실패가 발생하는 것이 일반적입니다. 이렇게 되면 빌드가 중단되며, 결과적으로 codespace 생성에 실패하게 됩니다.
참고 항목
생성에 실패한 codespace는 사용이 불가능하므로 반드시 삭제해야 합니다. 자세한 내용은 Codespace 삭제을(를) 참조하세요.
codespace를 생성했지만 생성에 실패한 경우:
-
GitHub의 상태 페이지 에서 현재 진행 중인 인시던트가 있는지 확인하세요.
-
GitHub Codespaces 페이지로 이동하여 codespace를 삭제하고 새로운 codespace를 생성합니다.
-
컨테이너 빌드 과정에서 스트리밍되는 로그를 모니터링하여 빌드가 정상적으로 진행되고 있는지 확인하세요. 1시간을 초과하는 컨테이너 빌드는 자동으로 취소되어 생성에 실패하게 됩니다.
사용자의 입력을 기다리는 메시지를 표시하고 응답을 대기하는 스크립트가 실행될 때가 이러한 상황이 발생하는 일반적인 시나리오 중 하나입니다. 이를 위해 빌드를 비대화형으로 진행할 수 있도록 대화형 프롬프트를 제거합니다.
참고 항목
빌드 중에 로그를 확인하려면 다음 단계를 따르세요.
-
**브라우저**에서 빌드 프로세스 초기 단계에서 지연이 발생할 경우, 자동으로 ‘codespace 설정’ 안내 페이지로 전환됩니다. **로그 보기**를 클릭하세요.
-
**VS Code 데스크톱 응용 프로그램**에서 표시되는 "원격 연결 설정" 팝업 메시지에서 **codespace 빌드**를 클릭합니다.
로그 메시지가 VS Code의 터미널에 출력됩니다.
- 컨테이너 빌드에 많은 시간이 소요된다면, 사전 빌드 기능을 활용해 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를 재시작하거나 컨테이너를 새로 빌드하여 변경 사항을 적용할 수 있습니다. 컨테이너를 다시 빌드하는 방법에 대한 자세한 내용은 개발 컨테이너 소개을(를) 참조하세요.