codespace コンピューターに対して最小仕様を設定する

リソース不足のコンピューターの種類が、リポジトリの GitHub Codespaces に使用されないようにすることができます。

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

People with write permissions to a repository can create or edit the codespace configuration.

この記事の内容

概要

作成した codespace は、それぞれ別の仮想マシンにホストされます。リポジトリから codespace を作成すると、通常はさまざまな種類の仮想マシンから選べます。マシンの種類ごとにリソース (プロセッサコア、メモリ、ストレージ) が異なり、既定では、リソースが最も少ないコンピューターの種類が使用されます。詳しくは、「codespace のマシンの種類を変更する」をご覧ください。

プロジェクトで特定のレベルのコンピューティング能力が必要な場合は、それらの要件を満たすコンピューターの種類のみを、既定で使用、またはユーザーが選択できるように、GitHub Codespaces を構成することができます。 devcontainer.json ファイル内でこれを構成します。

発行されていない codespace (GitHub Enterprise Cloud のリポジトリにリンクされていないテンプレートから作成された codespace) は、常に同じ仕様の仮想マシン上で実行されます。発行されていない codespace のマシンの種類を変更することはできません。

Important

一部のコンピューターの種類へのアクセスは、organization レベルで制限される場合があります。通常、これは、より高いレートで課金される、よりリソースの多いコンピューターをユーザーが選択することを防ぐために行われます。リポジトリがコンピューターの種類に関する組織レベルのポリシーの影響を受ける場合は、ユーザーが選択できるコンピューターの種類がなくなるような最小仕様を設定しないようにする必要があります。詳しくは、「コンピューターの種類へのアクセスを制限する」をご覧ください。

コンピューターの最小仕様の設定

リポジトリに作成された codespace は、devcontainer.json ファイルに設定を追加することで構成できます。リポジトリに devcontainer.json ファイルがまだ含まれていない場合、今から追加できます。「開発コンテナー構成のリポジトリへの追加」をご覧ください。
devcontainer.json ファイルを編集し、ファイルの最上位レベルにある JSON オブジェクト内に hostRequirements プロパティを追加します。次に例を示します。
JSON
```
"hostRequirements": {
   "cpus": 8,
   "memory": "8gb",
   "storage": "32gb"
}
```
```
"hostRequirements": {
   "cpus": 8,
   "memory": "8gb",
   "storage": "32gb"
}
```
次のいずれかの、またはすべてのオプションを指定できます: cpus、memory、storage。

リポジトリで現在使用可能な、GitHub Codespaces のコンピューターの種類の仕様を確認するには、コンピューターの種類の選択肢が表示されるまで、codespace の作成プロセスをステップ実行します。詳しくは、「リポジトリの codespace を作成する」をご覧ください。
ファイルを保存し、リポジトリの必要なブランチに加えた変更をコミットします。

ここで、リポジトリのそのブランチ用に codespace を作成し、作成設定オプションに進むと、指定したリソースと一致するか、またはそれを超えるコンピューターの種類のみを選択できるようになります。

参考資料

開発コンテナーの概要