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 を作成した。
codespace を GitHub CLI を使って作成し、異なる保持期間を指定した。
組織の設定で保持期間が構成されている、組織が所有するリポジトリの codespace を作成した。作成した codespace の所有権は、[Your codespaces] ページに表示されます。

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

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

GitHub で、任意のページの右上隅にある自分のプロフィール写真をクリックしてから、 [設定] をクリックします。
サイドバーの [コード、プラン、自動化] セクションで、[ Codespaces] をクリックします。
[既定の保持期間] に、停止後に codespace を保持する既定の日数を入力します。

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

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

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

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

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

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

非アクティブな codespace の保持期間が終わりに近づくと、GitHub の codespace のリスト (https://github.com/codespaces) にその旨が示されます。

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

codespace の自動削除を回避する

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

注: [Keep codespace] オプションは、組織のアイテム保持ポリシーの影響を受ける組織所有の codespace では使用できません。

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

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

自動削除から除外した codespace は、codespace の一覧でブックマークアイコン () で示されます。

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

codespace の保持期間を設定する

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

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

gh codespace create --retention-period DAYS

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

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

保持期間を設定する

GitHub において、Web ブラウザーでデフォルトの保持期間を設定できます。また、codespace を GitHub CLI を使って作成する場合は、その特定の codespace の保持期間を設定できます。詳しい情報については、上記の該当するタブをクリックしてください。

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

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

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

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

参考資料

「codespace のカスタマイズ」
「Codespaces を管理する」

Tool navigation

この記事の内容