Skip to main content

GitHub Codespaces に接続できない問題を解決する

GitHub Codespaces への接続に関するトラブルシューティングのヘルプ。

503 codespace サービスを使用できない

codespace は、30 分間アクティビティがないと停止するように設定されています。 停止した後で 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 を手動でインストールする必要があります。

codespace で Debian ベースのイメージが使用されている場合は、installJupyterlab オプションを true に設定して python 機能を devcontainer.json ファイルに追加することで、開発コンテナーに JupyterLab をインストールできます。 それ以外の場合は、Dockerfile に直接インストールします。 インストール手順については、JupyterLab ドキュメントの「インストール」を参照してください。

python 機能の詳細については、devcontainers/features リポジトリの README ページを参照してください。 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 リリース (夜間更新) のどちらを使用しているかを確認します。 Insiders リリースを使っている場合は、安定したビルドをインストールしてみます。
  3. 企業ネットワークで接続がブロックされていないことを確認します。
    1. connect EACCESconnect ECONNREFUSEDgetaddrinfo 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 のリージョンを手動で設定することができます。