Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.

codespace の作成と削除のトラブルシューティング

この記事では、ストレージや構成の issue など、codespace の作成または削除時に発生する可能性のある一般的な issue に対するトラブルシューティング手順について説明します。

codespace を作成する

codespace を作成するアクセス権がない

GitHub Codespaces は、すべてのリポジトリで利用できるわけではありません。 codespace を作成するためのオプションが表示されない場合は、そのリポジトリで GitHub Codespaces を使用できない可能性があります。 詳しくは、「リポジトリの codespace を作成する」を参照してください。

個人アカウントに GitHub Codespaces の毎月の使用料が残っている場合、または支払い方法と使用制限を設定している場合は、パブリック リポジトリの codespaces を作成できます。 ただし、リポジトリに変更をプッシュできる場合、またはリポジトリをフォークできる場合にのみ、プライベート リポジトリの codespace を作成できます。

個人アカウントに含まれる使用量と使用制限の設定について詳しくは、「GitHub Codespaces の請求について」および「GitHub Codespaces の使用制限の管理」を参照してください。

作成時に codespace が開かない

codespace を作成しても開かない場合:

  1. キャッシュまたはレポートの問題が発生した場合は、ページを再度読み込んでみてください。
  2. GitHub Codespaces ページ (https://github.com/codespaces ) に移動し、そこに新しい codespace が一覧表示されているかどうかを確認します。 このプロセスで、codespace が正常に作成されたが、ブラウザーに報告できなかった可能性があります。 新しい codespace が一覧表示されている場合は、そのページから直接開くことができます。
  3. 一時的な通信エラーを除外するように、リポジトリの codespace の作成を再試行します。

GitHub Codespaces を使用できるリポジトリの codespace をまだ作成できない場合は、サポートにお問い合わせください。 詳細については、サポートとの連携に関するページを参照してください。

codespace の作成に失敗する

codespace の作成に失敗する場合は、クラウドの一時的なインフラストラクチャの問題 (codespace の仮想マシンのプロビジョニングに関する問題など) が原因の可能性があります。 あまり一般的ではない失敗の理由は、コンテナーのビルドに 1 時間以上かかる場合です。 この場合、ビルドは取り消され、codespace の作成は失敗します。

注: 正常に作成されなかった codespace は使用できなくなり、削除する必要があります。 詳細については、「codespace の削除」を参照してください。

codespace を作成し、作成に失敗した場合:

  1. GitHub の [状態] ページ でアクティブなインシデントがないか確認します。

  2. GitHub Codespaces ページに移動し、codespace を削除して、新しい codespace を作成します。

  3. コンテナーがビルドされている場合は、ストリーミング中のログを確認し、ビルドがスタックしていないことを確認します。 1 時間以上かかるコンテナー ビルドは取り消され、作成が失敗します。

    これが発生する可能性がある一般的なシナリオの 1 つは、ユーザー入力のダイアログが表示され、回答を待つスクリプトが実行されている場合です。 この場合は、対話型プロンプトを削除して、ビルドを非対話型で完了できるようにします。

    : ビルド中にログを表示するには:

    • ブラウザーで、 [ログの表示] をクリックします。

    [ログの表示] リンクが強調された Codespaces Web UI のスクリーンショット

    • VS Code デスクトップ アプリケーションで、表示されている "リモート接続のセットアップ" の [codespace のビルド] をクリックします。

    [codespace のビルド] リンクが強調された VS Code のスクリーンショット

  4. ビルドに時間がかかるコンテナーがある場合は、プレビルドを使用して codespace の作成を速めることを検討してください。 詳しくは、「事前ビルドを構成する」をご覧ください。

codespace を削除する

codespace は、次の方法でのみ削除できます。

  • codespace を作成したユーザー。
  • Organization 所有の codespace の Organization 所有者。
  • 保持期間の終了時の自動的な削除。

詳しくは、「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 を使用して (すべての画像を削除する場合は -a を、すべてのボリュームを削除する場合は --volumes を付加します)、未使用の Docker イメージ、ネットワーク、コンテナーを削除します。
  • 追跡されていないファイルを作業ツリーから削除します: git clean -i

構成

開発コンテナー構成を変更してコンテナー エラーが発生した場合、codespace は回復モードで動作し、エラー メッセージが表示されます。

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

作成ログを確認し、必要に応じて開発コンテナーの構成を更新します。 詳しい情報については、「GitHub Codespaces のログ」を参照してください。

その後、codespace を再起動するか、コンテナーをリビルドしてみてください。 コンテナーの再構築について詳しくは、「開発コンテナーの概要」を参照してください。