Skip to main content

コンピューターの種類へのアクセスを制限する

ユーザーが Organization で codespace を作成するときに選択できるコンピューターの種類に制約を設定できます。

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

To manage access to machine types for the repositories in an organization, you must be an owner of the organization.

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

概要

通常、codespace を作成する際に、codespace を実行するコンピューターの仕様を選択できます。 ニーズに最も適したコンピューターの種類を選択できます。 詳しくは、「リポジトリの codespace を作成する」をご覧ください。

GitHub Codespaces の使用料を支払う場合、コンピューターの種類の選択が支払い額に影響します。 codespace のコンピューティング コストは、選んだコンピューターの種類のプロセッサのコア数に比例します。 たとえば、16 コアのマシンで codespace を 1 時間使用する場合のコンピューティング コストは、2 コアのマシンの 8 倍になります。 価格について詳しくは、「GitHub Codespaces の課金」を参照してください。

組織の所有者である場合、使用可能なマシンの種類に制約を設定することができます。 たとえば、Organaization 内の作業で大量のコンピューティング能力やストレージ スペースが必要ない場合は、ユーザーが選択できるオプションのリストから、リソースの多いコンピューターを削除できます。 これを行うには、組織の GitHub Codespaces 設定でポリシーを1つ以上定義します。

コンピューターの種類の制約を設定するときの動作

定義したポリシーに準拠しなくなった既存の codespace がある場合、これらの codespace は停止またはタイムアウトになるまでは動作し続けます。ユーザーが codespace を再開しようとすると、現在選択されているコンピューターの種類がこの組織では許可されなくなったことを通知し、別のコンピューターの種類を選択するように求めるメッセージが表示されます。

Organaization 内の個々のリポジトリの GitHub Codespaces 構成で必要とされる高性能のコンピューターの種類を削除すると、そのリポジトリに codespace を作成できなくなります。 だれかが codespace を作成しようとすると、リポジトリの GitHub Codespaces 構成要件を満たす有効なコンピューターの種類が使用できないことを示すメッセージが表示されます。

メモ

リポジトリ内の devcontainer.json 構成ファイルを編集できるユーザーは、そのリポジトリの codespace に使用できるコンピューターの最小仕様を設定できます。 詳しくは、「codespace コンピューターに対して最小仕様を設定する」をご覧ください。

コンピューターの種類に対してポリシーを設定した場合に、特定のリポジトリで GitHub Codespaces を使えないとき、次の 2 つのオプションがあります。

  • 影響を受けるリポジトリから制限を明確に取り除くようにポリシーを調整できます。
  • 新しいポリシーが原因でアクセスできなくなった codespace があるユーザーは、その codespace をブランチにエクスポートできます。 このブランチには、codespace からの変更がすべて含まれます。 その後、準拠しているコンピューターの種類を使用してこのブランチで新しい codespace を開くか、このブランチでローカルで作業できます。 詳しくは、「変更をブランチにエクスポートする」をご覧ください。

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

ポリシーを作成するときに、ポリシーを Organaization 内のすべてのリポジトリに適用するか、指定されたリポジトリにのみ適用するかを選択します。 Organaization 全体のポリシーを設定する場合は、個々のリポジトリに対して設定するポリシーはすべて、Organaization レベルに設定した制限に収まるようにする必要があります。 ポリシーを追加することで、コンピューターの選択をさらに制限します。

たとえば、コンピューターの種類を 2 コアまたは 4 コアに制限する Organaization 全体のポリシーを作成できます。 その後、リポジトリ A に対して、2 コアのコンピューターに制限するポリシーを設定できます。 リポジトリ A のポリシーを 2、4、または 8 コアのコンピューターに制限するように設定すると、8 コアのコンピューターへのアクセスは Organaization 全体のポリシーによって禁止されるため、2 コアと 4 コアのコンピューターのみ選択できます。

Organaization 全体のポリシーを追加する場合は、Organaization 内のどのリポジトリにも使用できるように、コンピューターの種類を最大の選択肢に設定してください。 その後、リポジトリ固有のポリシーを追加することで、選択肢をさらに制限できます。

メモ

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

使用可能なコンピューターの種類を制限するポリシーを追加する

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

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

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

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

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

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

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

  7.        **[制約の追加]** をクリックし、 **[コンピューターの種類]** を選択します。
    
  8. をクリックして制約を編集し、使用したくないコンピューターの種類の選択をすべて解除します。

    4 種類のコンピューターのオプションを含む [許可された値] のドロップダウンのスクリーンショット。 2 コアと 4 コア コンピューターのオプションが選択されています。

  9. ダイアログ ボックスの外側をクリックして閉じます。

  10. 既定では、ポリシーはすべてのリポジトリに適用されるように設定されます。組織内の一部のリポジトリにのみ適用したい場合は、 [すべてのリポジトリ] をクリックしてから、ドロップダウン メニューの [選択したリポジトリ] をクリックします。

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

    メモ

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

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

    1. をクリックします。

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

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

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

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

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

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

このポリシーは、貴社の課金対象となるすべての新しい codespace に適用されます。 コンピューターの種類の制約は、だれかが停止した codespace の再起動またはアクティブな codespace への再接続を試みたときに、既存の codespace にも適用されます。

ポリシーを編集する

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

  1. [Codespaces ポリシー] ページを表示します。 詳しくは、「使用可能なコンピューターの種類を制限するポリシーを追加する」を参照してください。
  2. 編集するポリシーの名前をクリックします。
  3. "コンピューターの種類" 制約の横にある [] をクリックします。
  4. 必要な変更を行い、 [保存] をクリックします。

ポリシーを削除する

  1. [Codespaces ポリシー] ページを表示します。 詳しくは、「使用可能なコンピューターの種類を制限するポリシーを追加する」を参照してください。

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

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

参考資料