Skip to main content

codespace の保持期間を制限する

組織が所有する Codespace の最大保持期間を設定できます。

この機能を使用できるユーザーについて

To manage retention constraints for an organization's codespaces, you must be an owner of the organization.

GitHub Team プランや GitHub Enterprise プランを利用している組織は、メンバーやコラボレーターによる GitHub Codespaces の使用料を支払うことができます。 これらの組織は、設定やポリシーにアクセスして、組織によって支払われる codespace を管理できます。 詳細については、「組織内の codespace を誰が所有し、支払うかの選択」および「GitHubのプラン」を参照してください。

概要

データの再利用可能部分.codespaces.自動削除 %}

GitHub ユーザーは、作成する codespace に対して 30 日未満の個人保持期間を設定できます。 詳しくは、「codespace の自動削除を構成する」をご覧ください。

組織の所有者として、組織が所有するリポジトリ用に作成されたcodespaceの最大保存期間に対する制約を構成できます。 これを使うと、codespace の停止後、自動的に削除されるまで未使用のまま放置されることで発生するストレージ コストを抑えることができます。 ストレージ料金の詳細情報については、「GitHub Codespaces の課金」を参照してください。 Organaization が所有するすべてのリポジトリまたは特定のリポジトリに対して、最大保持期間を設定できます。

メモ

リポジトリの最大保持ポリシーを設定すると、codespace を自動削除から除外することを防ぎます。 そのリポジトリ用に作成された codespace では、[Keep codespace] オプションを使用できなくなります。 詳しくは、「codespace の自動削除を構成する」をご覧ください。

オーガニゼーション単位でのポリシーとリポジトリ固有のポリシーの設定

ポリシーを作成するときに、ポリシーを Organaization 内のすべてのリポジトリに適用するか、指定したリポジトリにのみ適用するかを選びます。 Organaization 全体のポリシーを作成して、codespace の保持制約を設定する場合、特定のリポジトリを対象とするポリシーの保持制約を、Organaization 全体に対して構成されている制限よりも短くする必要があります。そうしないと、無効になります。 Organization 全体のポリシー、特定のリポジトリを対象とするポリシー、またはユーザーの個人設定の既定の保持期間のうち、最も短い保持期間が適用されます。

Organization 全体のポリシーを追加して、保持制約を設定する場合は、その保持期間を、許容できる最も長い期間に設定する必要があります。 その後、Organization 内の特定のリポジトリに対して個別のポリシーを追加して、その最大保持期間を短く設定できます。

メモ

Codespaces ポリシーは、organization が支払う Codespaces にのみ適用されます。 誰かが自分の費用で組織内のリポジトリの codespace を作成した場合、その codespace はこれらのポリシーに制約されません。 詳しくは、「組織内の codespace を誰が所有し、支払うかの選択」をご覧ください。

ポリシーを追加して codespace の最大保持期間を設定する

  1. GitHub の右上隅にあるプロフィール画像をクリックしてから、[ Your organizations] をクリックします。

  2. 組織をクリックして選択します。

  3. Organization 名の下で、[ Settings] をクリックします。 [設定] タブが表示されない場合は、 [] ドロップダウン メニューを選び、 [設定] をクリックします。

    組織のプロファイルのタブのスクリーンショット。 [設定] タブが濃いオレンジ色の枠線で囲まれています。

  4. サイドバーの [Code, planning, and automation] セクションで、[ Codespaces] を選択してから、[Policies] をクリックします。

  5. [Codespaces ポリシー] ページで、 [ポリシーの作成] をクリックします。

  6. 新しいポリシーの名前を入力します。

  7.        **[制約の追加]** をクリックし、 **[保持期間]** を選びます。
    
  8. 制約を編集するには、 をクリックします。

  9. 自動的に削除されるまで、codespace を停止したままにできる最大日数を入力し、 [保存] をクリックします。

    ドロップダウンのスクリーンショット。[最大値] というラベルが付いたフィールドが 8 日に設定されています。 この下に "キャンセル" ボタンと "保存" ボタンがあります。

    メモ

    • ここでいう 1 日とは、codespace を停止した時点から始まる 24 時間のことです。
    • 有効な範囲は 0 から 30 日です。
    • 期間を 0 に設定すると、codespace は、停止したとき、または非アクティブのためにタイムアウトしたとき、即座に削除されます。
  10. 既定では、ポリシーはすべてのリポジトリに適用されるように設定されます。組織内の一部のリポジトリにのみ適用したい場合は、 [すべてのリポジトリ] をクリックしてから、ドロップダウン メニューの [選択したリポジトリ] をクリックします。

    [すべてのリポジトリ] と [選択したリポジトリ] のオプションが表示されている、リポジトリ選択ドロップダウンのスクリーンショット。

    メモ

    "Maximum codespaces per user" 制約が既に含まれているポリシーに制約を追加する場合、選んだリポジトリにポリシーを適用することはできません。 これは、"ユーザーあたりの最大 codespace 数" 制約は、組織内のすべてのリポジトリに常に適用されるためです。

    [選択したリポジトリ] を選んだら、次のようにします。

    1. をクリックします。

      [選択したリポジトリ] というラベルのボタンの左側にある設定アイコン (歯車シンボル) のスクリーンショット。

    2. このポリシーを適用するリポジトリを選択します。

    3. リポジトリ リストの下部にある [リポジトリの選択] をクリックします。

      それぞれにチェックボックスが付いているリポジトリの一覧のスクリーンショット。 3 つのリポジトリが選ばれています。

  11. ポリシーに別の制約を追加する場合は、 [制約の追加] をクリックして、別の制約を選びます。 その他の制約については、次を参照してください。

  12. ポリシーへの制約の追加が終わったら、 [保存] をクリックします。

このポリシーは、貴社の課金対象となるすべての新しい codespace に適用されます。 保持期間の制約は、codespace の作成時にのみ適用されます。

ポリシーを編集する

既存のポリシーを編集できます。 たとえば、ポリシーの制約を追加または削除できます。

保持期間制約が codespace に適用されるのは、作成時のみです。 ポリシーを編集しても、既存の codespace には影響しません。

  1. [Codespaces ポリシー] ページを表示します。 詳しくは、「ポリシーを追加して codespace の最大保持期間を設定する」を参照してください。
  2. 編集するポリシーの名前をクリックします。
  3. "保持期間" 制約の横にある [] をクリックします。
  4. 必要な変更を行い、 [保存] をクリックします。

ポリシーを削除する

ポリシーはいつでも削除できます。 ポリシーを削除しても、既存の codespace には影響しません。

  1. [Codespaces ポリシー] ページを表示します。 詳しくは、「ポリシーを追加して codespace の最大保持期間を設定する」を参照してください。

  2. 削除するポリシーの右側にある削除ボタンをクリックします。

  3. 削除するポリシーの右側にある をクリックします。

    削除ボタン (ごみ箱アイコン) が濃いオレンジ色の枠線で強調されているポリシーのスクリーンショット。