Skip to main content

含まれている使用量の最大限の活用

個人アカウントに含まれる GitHub Codespaces の無料使用量について説明します。

個人の GitHub アカウントには、毎月無料で使用できる GitHub Codespaces のクォータが含まれています。

: GitHub Codespaces の無料使用量は、個人アカウントにのみ含まれています。 Organization または Enterprise アカウントには含まれません。

Codespaces の使用量には、コンピューティングとストレージの 2 種類があります。 毎月の請求期間中に、Codespaces を使用すると、コンピューティングとストレージの使用量が、コンピューティングまたはストレージが消費されるまで、個人の GitHub アカウントに含まれる無料使用量のクォータから差し引かれます。 これらの制限のいずれかに達すると、使用制限と支払い方法を設定しない限り、GitHub Codespaces の使用が制限されます。 クォータが更新されるまで、新しい codespace を作成したり、既存の codespace を開いたりすることは、課金対象となるためできません。 GitHub Codespaces の使用料金を支払っている Organization が所有するリポジトリにアクセスできるのであれば、そのリポジトリに対して codespace を作成できる場合があります。

毎月個人アカウントで提供される無料使用量は、オープンソースのコントリビューションを行ったり、サイド プロジェクトでの作業を無料で行ったりできるように設計されています。 これでは、毎日の作業を無料で行うには十分ではありません。

Codespaces コンピューティングについて

Codespaces コンピューティングはコア時間でカウントされます。これは、codespace がアクティブな時間の合計で、codespace のマシンの種類の乗数 (たとえば、2 コア マシンの場合は 2 の乗数、8 コア マシンの場合は 8 の乗数) で乗算されます。 codespace は、作成または起動するとアクティブになります。 codespace は、停止または削除したとき、または自動的に停止または削除されると、アクティブ状態を停止します。

非アクティブな期間が経過してから codespace が停止するまでの既定のアイドル タイムアウトは 30 分です。 必要に応じて、これを短縮することができます。 詳しくは、「GitHub Codespaces の請求について」の「コンピューティング使用量の課金について」セクションをご覧ください。

Codespaces ストレージについて

各 codespace のストレージ使用量は、github.com/codespaces の [あなたの codespace] ページで確認できます。

https://github.com/codespaces ページ上で 3 つの codespace リストが表示されているスクリーンショット。

: codespace 開発コンテナーが既定のイメージからビルドされている場合、このページに表示される codespace のサイズには、基本開発コンテナーのサイズは含まれません。 基本開発コンテナーのストレージは無料で提供されます。 詳しくは、後の「基本開発コンテナーのストレージ使用」をご覧ください。

課金の目的で、Codespaces ストレージは GB/月単位でカウントされます。 これは、各 codespace が作成から削除まで消費するストレージの合計と、プレビルド用のストレージの累積メジャーです。 詳しくは、「GitHub Codespaces の請求について」の「ストレージ使用量に対する課金」セクションをご覧ください。

毎月のストレージはどこに移動しましたか?

使用していない codespace を削除することで、個人アカウントに含まれる無料のストレージを不必要に使い切るのを防げます。 ただし、プレビルド構成を設定している場合、含まれているストレージは、毎月の課金サイクル中に減少し続ける可能性があります。

プレビルドは [Your codespaces] ページには表示されませんが、リポジトリ用に作成されたプレビルドでは、そのリポジトリ のcodespace が現在ない場合でもストレージが消費されます。 これを回避するには、設定したプレビルド構成を削除します。 詳細については、「GitHub Codespaces のプレビルドについて」および「事前ビルドの管理」を参照してください。

Codespaces の使用量について

GitHub 設定で、現在の月次請求期間のGitHub Codespaces の累積使用量を確認できます。 詳しくは、「Viewing your GitHub Codespaces usage」を参照してください。

課金ページの [Codespaces] セクションのスクリーンショット。[使用時間] と [ストレージ] の数値を確認できます。

[使用時間] セクションと [ストレージ] セクションを展開すると、プレビルドによるストレージの消費量などの詳細を確認できます。

より具体的な情報 (たとえば、ストレージを消費しているプレビルドを持つリポジトリを知りたい場合) を知るには、使用状況レポートを生成できます。 使用状況レポートは、CSV ファイルで電子メールで送信されます。 使用状況レポートの生成方法について詳しくは、「Viewing your GitHub Codespaces usage」をご覧ください。

Codespaces の使用状況を確認するには、レポートをフィルター処理して、Product 列に "Codespaces" が示される行のみを表示します。

Microsoft Excel の使用状況レポートのスクリーンショット。 [製品] 列のエントリはすべて "Codespaces - Linux" と読みます。

基本開発コンテナーのストレージ使用

開発コンテナー構成をリポジトリに追加しない場合、または構成で使用する開発コンテナー イメージが指定されていない場合は、GitHub によって既定の Linux イメージからコンテナーが作成されます。 既定の開発コンテナー イメージから構築された基本開発コンテナーのストレージは無料で、含まれているストレージを消費しません。 ストレージの使用量は、リポジトリ内のファイルと、その後 codespace に追加するすべてのファイル (VS Code 拡張機能を含む) にのみ基づきます。 代替の基本イメージを使用する場合、結果のコンテナーと codespace 内のすべてのファイルが、使用されたストレージとしてカウントされます。 既定の Linux イメージに何が含まれているかについては、devcontainers/images リポジトリをご覧ください。

codespace の開発コンテナーを作成するために使用されたイメージを確認できます。 codespace のターミナルで、このコマンドを実行します。

Shell
devcontainer-info

現在の codespace の開発コンテナーが既定のイメージからビルドされた場合、このコマンドの出力には次の情報が含まれます。

- Definition ID: universal
- Source code repository: https://github.com/devcontainers/images

許可された使用量をさらに活用するためのヒント

  • codespaces では、その実行中にコンピューティング使用量が消費されます。 codespace を使用していない場合は、codespace を停止すると、不要なコンピューティングの使用が回避されます。 詳しくは、「codespace の停止と開始」を参照してください。

  • 個人用設定の Codespaces のアイドル タイムアウトを、既定の 30 分未満に短縮することができます。 これにより、codespace が自動的に停止するまでの非アクティブ期間が短縮されます。 これで、コンピューティング使用量を節約できます。 詳しくは、「GitHub Codespaces のタイムアウト期間を設定する」を参照してください。

  • codespace が存在している間は、ストレージが消費されます。 使用が完了し、もう使用しないことがわかっている codespace は削除する必要があります。 詳しくは、「codespace を削除する」を参照してください。

    : codespace を削除しても、現在の請求月の使用済みストレージ量は、累積値であるため削減されません。

  • 削除し忘れた codespace が自動的に削除されるように、保持期間を構成します。 既定の保持期間は 30 日です。 詳しくは、「codespace の自動削除を構成する」を参照してください。

  • Visual Studio Code 拡張機能はストレージを消費します。 必要な拡張機能のみをインストールしてください。 codespace でこのコマンドを実行すると、拡張機能でどれくらいの領域が使用されているかを確認できます。

    Shell
    du -h -s ~/.vscode-remote/extensions
    
  • GitHub の請求ページと https://github.com/settings/billing に移動してコンピューティングとストレージの使用状況を監視し、「Codespaces」セクションの数値を確認します。

    : ストレージは 1 時間ごとに計算され、既存のストレージ使用量に追加されます。 したがって、消費されたストレージは、1 か月間の請求期間で累積されます。 つまり、請求期間中は、請求ページに表示される値が増加するか、変わらないかのどちらかです。 新しい請求期間が開始されると、使用量は 0 にリセットされます。 codespace またはプレビルドを削除しても、当月の使用量は減少しませんが、ストレージ使用量が蓄積される速度は低下します。

  • 必要な数のバージョンとリージョンに対してのみプレビルドを使用していることを確認します。 詳細については、「GitHub Codespaces のプレビルドについて」および「GitHub Codespaces の請求について」を参照してください。

    : 含まれているストレージが使い果たされている場合、使用制限を設定するか、含まれている使用量クォータが更新されるまで、新しいプレビルドは無効になります。

  • リポジトリの設定でプレビルドを構成したが、そのリポジトリに GitHub Codespaces を使用していない場合は、そのリポジトリのプレビルドで不要なストレージ容量が消費されないように、プレビルド構成を削除することを検討してください。 プレビルド構成を削除すると、関連付けられているすべてのプレビルドが削除され、その時点以降のストレージ消費量が削減されます。 詳しくは、「事前ビルドの管理」を参照してください。

    リポジトリの設定の [Codespaces] ページでプレビルド構成を確認できます。 詳しくは、「プレビルドの構成」を参照してください。

    または、使用状況レポートを確認して、プレビルドを持つリポジトリを確認することもできます。 詳しくは、前述の「Codespaces の使用量について」をご覧ください。

  • codespace の既定の開発コンテナー イメージから構築されたコンテナーのストレージは無料で、含まれているストレージを消費しません。 そのため、より特殊なイメージを指定するのではなく、開発コンテナー構成で既定のイメージを使用することで、開発コンテナーでストレージ容量が消費されるのを回避できます。 詳しくは、「開発コンテナーの概要」と上の「基本開発コンテナーのストレージ使用」をご覧ください。