GitHub Codespaces 관련 연결 문제 해결

GitHub Codespaces에 연결하기 위한 문제 해결 도움말

이 문서의 내용

503 codespace 서비스를 사용할 수 없음

codespace는 활동 없이 30분이 경과하면 중지되도록 설정되어 있습니다. codespace가 중지된 후 codespace를 조작하려고 하면 503 service unavailable 오류가 표시될 수 있습니다.

  • Visual Studio Code 또는 브라우저 창에 시작 단추가 표시되는 경우 시작을 클릭하여 codespace에 다시 연결합니다.
  • 창을 다시 로드하여 codespace를 초기화합니다. Visual Studio Code의 명령 팔레트에서 개발자: 창 다시 로드를 클릭합니다.

브라우저에서 연결할 수 없음

브라우저에서 codespace에 액세스할 수 없는 경우가 있습니다. 이 경우, https://github.com/codespaces로 이동하여 해당 페이지에서 codespace에 연결해 보세요.

  • codespace가 해당 페이지에 나열되지 않는 경우 연결할 codespace의 소유자인지 확인합니다. 직접 만든 codespace만 열 수 있습니다.
  • codespace가 나열되지만 해당 페이지에서 연결할 수 없는 경우 다른 브라우저를 사용하여 연결할 수 있는지 확인합니다.

오류 메시지로 진단

"오프라인 상태인 것 같습니다."

안정적인 인터넷 연결이 있고 회사 네트워크가 연결을 차단하지 않는지 확인합니다. 가능한 경우 디바이스에서 거부된 연결에 대한 로깅을 확인합니다.

거부된 연결이 표시되는 경우 /meta REST API 엔드포인트에서 문서화한 도메인이 방화벽에 의해 차단되지 않았는지 확인합니다. 자세한 내용은 "메타 데이터에 대한 REST API 엔드포인트"을(를) 참조하세요.

GitHub Codespaces에 필요한 할 도메인 목록을 얻으려면 GitHub CLI을(를) 사용하여 다음 명령을 실행합니다.

gh api meta | jq .domains.codespaces

"codespace 정보를 가져오는 데 문제가 있습니다."

이는 과도기적 오류입니다. 몇 분 정도 기다린 후 다시 시도하세요.

"연결을 인증할 수 없습니다."

이는 인증에 문제가 있음을 나타냅니다. 로컬 스토리지 및 쿠키를 지우고 다시 시도하세요.

여전히 연결할 수 없고 표시되는 메시지가 이 목록에 없으면 githubstatus.com에서 Codespaces의 서비스 가용성을 검사하세요. Codespaces 서비스를 사용할 수 있는 경우 지원에 문의해야 할 수 있습니다. 자세한 내용은 "GitHub Codespaces 관련 지원 작업"을(를) 참조하세요.

JupyterLab에서 codespace에 연결할 수 없음

JupyterLab에서 codespace를 사용하려면 codespace가 설치되어 있는지 확인해야 합니다. GitHub Codespaces에서 사용되는 기본 개발 컨테이너 이미지에는 JupyterLab이 포함되어 있지만 개발 컨테이너 구성을 사용자 지정한 경우 JupyterLab을 수동으로 설치해야 합니다.

코드스페이스가 데비안 기반 이미지를 사용하는 경우 python 기능을 devcontainer.json 파일에 추가하고 installJupyterlab 옵션을 true로 설정하여 개발 컨테이너에 JupyterLab을 설치할 수 있습니다. 그렇지 않으면 Dockerfile에 직접 설치합니다. 설치 지침은 JupyterLab 설명서의 설치를 참조하세요.

python 기능에 대한 자세한 내용은 devcontainers/features 리포지토리의 추가 정보 페이지를 참조하세요. devcontainer.json 파일 및 Dockerfile에 대한 자세한 내용은 "개발 컨테이너 소개"을 참조하세요.

계속 연결할 수 없으면 지원에 문의해야 할 수 있습니다. 자세한 내용은 "GitHub Codespaces 관련 지원 작업"을(를) 참조하세요.

Visual Studio Code용 GitHub Codespaces 확장에서 연결할 수 없음

Visual Studio Code 데스크톱에서 codespace에 연결할 수 없는 경우 다음 문제 해결 단계를 사용합니다.

  1. 최신 버전의 GitHub Codespaces 확장이 설치되어 있는지 확인합니다. 이 확장은 미리 보기 릴리스로 제공되며, 업데이트가 자주 릴리스됩니다.
    1. Visual Studio Code에서 “확장” 탭을 표시합니다.
    2. GitHub Codespaces 확장을 선택하여 확장의 개요 페이지를 표시합니다.
    3. 업데이트를 사용할 수 있는 경우 단추가 표시됩니다. X.X.X로 업데이트를 클릭하여 최신 버전으로 업그레이드합니다.
  2. Visual Studio Code 또는 Visual Studio Code Insiders 릴리스(야간 업데이트)의 안정적인 빌드를 사용하고 있는지 확인합니다. 참가자 릴리스를 사용하는 경우 안정적인 빌드를 설치해 보세요.
  3. 회사 네트워크가 연결을 차단하지 않는지 확인합니다.
    1. connect EACCES, connect ECONNREFUSED, getaddrinfo ENOTFOUND 또는 기타 유사한 오류와 같은 오류가 발생하면 방화벽이 연결 서비스에 대한 연결을 차단할 수 있습니다. 이를 확인하려면 이 URL을 방문하세요. 요청이 실패하거나 데이터가 표시되지 않으면 시스템 관리자와 협력하여 방화벽의 IP 허용 목록에 *.visualstudio.com를 추가해야 할 수 있습니다.
    2. 오류 Tunnel service HTTPS certificate is invalid. This may be caused by the use of a self-signed certificate or a firewall intercepting the connection가 표시되면 방화벽이 TLS 검사를 수행하면서 GitHub에서 확인할 수 없는 자체 서명된 인증서를 삽입하는 것일 수 있습니다. 이 문제를 해결하려면 시스템 관리자가 *.visualstudio.com가 검사를 우회하도록 허용하거나 방화벽이 로컬 컴퓨터에 주입하는 루트 CA를 설치해야 합니다.

계속 연결할 수 없으면 지원에 문의해야 할 수 있습니다. 자세한 내용은 "GitHub Codespaces 관련 지원 작업"을(를) 참조하세요.

codespace에 대기 시간 이슈가 있음

codespace가 특히 느린 것 같거나 대기 시간 이슈가 있는 경우 멀리 떨어진 지역에서 생성되었을 수 있습니다. 이 문제를 해결하기 위해 GitHub Codespaces 지역을 수동으로 설정할 수 있습니다.