codespace の自動削除を構成する

既定では、 GitHub Codespaces は停止した後に自動的に削除され、30 日間非アクティブなままです。

ただし、 GitHub Codespaces にはストレージ料金が発生するため、 GitHub Codespacesの個人用設定で既定の期間を変更することで、保有期間を短縮することもできます。ストレージ料金の詳細情報については、「GitHub Codespaces の課金」を参照してください。

メモ

個人の codespace 保持期間を設定したかどうかにかかわらず、codespace は不要になったら削除することを習慣にすることをお勧めします。「codespace を削除する」を参照してください。

自動削除は、codespace にプッシュされていない変更が含まれているかどうかに関係なく行われます。 codespace の自動削除を防ぐには、codespace をもう一度開くだけです。 codespace に接続するたびに保持期間がリセットされ、codespace を停止すると、保持期間のカウントダウンが再開されます。

リポジトリが組織に属している場合、組織の所有者が組織全体の保持期間を設定している可能性があります。この期間の方が個人設定の既定の保持期間より短い場合は、このリポジトリ用に作成した codespace には、Organaization の保持期間が適用されます。「codespace の保持期間を制限する」を参照してください。

codespace ごとに独自の保持期間があります。そのため、codespace によって保持期間が異なる場合があります。たとえば、次の場合です。

codespace を作成した後、既定の保持期間を変更し、別の codespace を作成した。
GitHub CLIを使用してコードスペースを作成し、別の保持期間を指定しました。
組織の設定で保持期間が構成されている、組織が所有するリポジトリの codespace を作成した。作成した codespace の所有権は、[Your codespaces] ページに表示されます。

メモ

保持期間は日数で指定します。 1 日とは、codespace を停止した時点から始まる 24 時間を意味します。

codespace の既定の保持期間を設定する

GitHub の任意のページの右上隅にあるプロフィール写真をクリックし、[ Settings] をクリックします。
サイドバーの [Code, planning, and automation] セクションで、 [Codespaces] をクリックします。
[既定の保持期間] に、停止後に codespace を保持する既定の日数を入力します。

既定の保持期間は 0 から 30 日の間で設定できます。

警告

期間を0に設定すると、コードスペースは停止したとき、または非アクティブのためにタイムアウトしたときに即座に削除されます。「GitHub Codespaces のタイムアウト期間の設定」を参照してください。
[保存] をクリックします。

GitHub CLIを使用してコードスペースを作成する場合は、この既定値をオーバーライドできます。より短い保持期間を指定する Organaization で codespace を作成した場合、個人設定は、Organaization レベルの値によってオーバーライドされます。

1 日を超える保持期間を設定すると、削除の 1 日前にメール通知を受け取ります。

自動削除までの残り時間を確認する

codespace が間もなく自動的に削除される予定かどうかを確認できます。

非アクティブなコードスペースがリテンション期間の終わりに近づいている場合、これはhttps://github.com/codespacesの[](https://github.com/codespaces)のコードスペースの一覧に示されます。

3 つの codespace の一覧のスクリーンショット。その 3 つ目には [4 日後に期限切れ] というラベルが付けられ、濃いオレンジ色の枠線で強調表示されています。

codespace の自動削除を回避する

個人設定で定義されている保持期間よりも長く保持したい codespace がある場合があります。それを行うには、[Keep codespace] オプションを使います。このオプションを選択すると、codespace は無期限に、手動で削除するまで保持されます。

メモ

Keep codespace オプションは、組織の保持ポリシーの影響を受けた組織所有のコードスペースでは使用できません。

コードスペースにはストレージコストが発生します。または、コードスペースが個人の GitHub アカウントによって所有されている場合は、含まれているストレージ許容量を消費します。そのため、codespace を無期限に保存する場合のコストへの影響に注意する必要があります。「GitHub Codespaces の課金」を参照してください。

GitHub の左上隅にあるを選択し、 コードスペースをクリックして、github.com/codespaces の [Your codespaces] ページに移動します。
自動削除から除外するコードスペースの右側にある [] をクリックし、[コード空間を保持] をクリックします。

自動削除から除外したコードスペースは、ブックマークアイコン () を使用してコードスペースの一覧に表示されます。

codespace 一覧のセクションのスクリーンショット。ブックマークアイコンのラベルが付いた codespace が表示されています。

codespace の保持期間を設定する

GitHub CLI をインストールすると、それを使用して GitHub Codespaces で操作できます。 GitHub CLI のインストール手順については、GitHub CLI リポジトリを参照してください。

codespace の作成時に codespace 保持期間を設定するには、--retention-period サブコマンドで codespace create フラグを使います。期間を日数で指定します。 0 から 30 日の期間を指定してください。

gh codespace create --retention-period DAYS

codespace の作成時に保持期間を指定しない場合は、既定の保持期間と Organization の保持期間のどちらか短い方が使用されます。既定の保持期間の設定の詳しい情報については、このページの [Web ブラウザー] タブをクリックしてください。

メモ

GitHub CLI の詳細については、「GitHub CLI について」を参照してください。

保持期間を設定する

GitHubでは、Web ブラウザーで既定の保持期間を設定できます。または、 GitHub CLI を使用してコード空間を作成する場合は、その特定のコード空間の保持期間を設定できます。詳しい情報については、上記の該当するタブをクリックしてください。

codespace が間もなく自動削除されるかどうかを確認する

Visual Studio Code デスクトップアプリケーションで、コードスペースが間もなく自動的に削除される予定かどうかを確認できます。

VS Code のアクティビティバーで、[リモートエクスプローラー] アイコンをクリックします。
メモ

リモートエクスプローラーがアクティビティバーに表示されない場合:
1. コマンドパレットにアクセスします。たとえば、Shift + Command + P (Mac) / Ctrl + Shift + P (Windows/Linux) を押します。
2. 次のコマンドを入力します: details
3. [コードスペース: 詳細] をクリックします。
リモートエクスプローラーの右上にあるドロップダウンメニューから GitHub Codespaces を選択します (まだ選択されていない場合)。
[GitHub Codespaces] の下で、目的の codespace の上にマウスポインターを置きます。 codespace に関する情報を示すポップアップボックスが表示されます。

codespace の保持期間が終わりに近づいている場合は、いつその期間が期限切れになるかを示す行が含まれます。

Tool navigation

この記事で