Skip to main content

GitHub Codespaces のタイムアウト期間を設定する

個人用設定ページで、GitHub Codespaces の既定のタイムアウトを設定できます。

アイドル タイムアウトについて

非アクティブな期間が経過すると、codespace の実行が停止します。 既定では、この期間は 30 分間ですが、GitHub で、個人用設定での既定のタイムアウト期間をより長くまたは短く指定することができます。 更新された設定は、作成した新しい codespace に、または次回開始するときに既存の codespace に適用されます。 また、GitHub CLI を使って codespace を作成するときに、タイムアウトを指定することもできます。

警告: codespace コンピューティング使用量は、codespace がアクティブな期間に対して課金されます。 codespace を使ってはいないものの、実行中のままであり、まだタイムアウトしていない場合は、codespace を使っているかどうかにかかわらず、codespace がアクティブだった合計時間に対して課金されます。 詳しくは、「GitHub Codespaces の請求について」を参照してください。

非アクティブが定義済み

Codespaces アイドル タイムアウトのコンテキストでは、非アクティブは、ユーザーのプレゼンスを示すアクティビティの欠如として定義されています。 マウスの入力や使用など、コードスペースとの個人的な対話によって、アイドル タイムアウト期間がリセットされます。 ターミナル アクティビティ (入力または出力) もアイドル タイムアウト期間をリセットします。 たとえば、codespace からポートに Web アプリを発行し、ページ要求が codespace のターミナルで出力を生成する場合、ターミナルの出力が発生するたびにタイムアウトがリセットされます。 ただし、ポートを共有した後に codespace と対話せず、ターミナル出力が生成されない場合、構成された期間が経過すると、codespace はタイムアウトになります。

Organization が所有するリポジトリのタイムアウト期間

Organization は、そのリポジトリの一部またはすべてから作成された codespace に対して、最大アイドル タイムアウト ポリシーを設定できます。 Organization ポリシーによって最大タイムアウトが設定され、それがユーザーによって設定された既定のタイムアウトよりも短い場合、ユーザーが設定したものではなく、Organization のタイムアウトが使用されます。 このことは、codespace が作成されるとユーザーに通知されます。 詳しくは、「アイドル タイムアウトの期間を制限する」を参照してください。

既定のタイムアウト期間を設定する

  1. 任意のページで、右上隅にあるプロファイルの画像をクリックし、次に[設定]をクリックします。

    Screenshot of a user's account menu on GitHub. The menu item "Settings" is outlined in dark orange.

  2. サイドバーの [コード、プラン、自動化] セクションで、[ Codespaces] をクリックします。

  3. [既定のアイドル タイムアウト] の下に必要な時間を入力し、 [保存] をクリックします。 時間は 5 分から 240 分 (4 時間) の間で指定する必要があります。

    Codespaces 設定の [既定のアイドル タイムアウト] セクションのスクリーンショット。「90 分」と入力されています。

codespace のタイムアウト期間を設定する

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

codespace の作成時にタイムアウト期間を設定するには、codespace create サブコマンドで idle-timeout 引数を使用します。 時間を分単位で指定します (後ろに m を付けます)。 時間は 5 分から 240 分 (4 時間) の間で指定する必要があります。

gh codespace create --idle-timeout 90m

codespace を作成するときにタイムアウト期間を指定しない場合は、既定のタイムアウト期間が使用されます。 既定のタイムアウト期間の設定については、このページの [Web ブラウザー] タブをクリックしてください。 現在、GitHub CLI を使用して既定のタイムアウト期間を指定することはできません。

タイムアウト期間を設定する

既定のタイムアウト期間は、Web ブラウザー内の GitHub.com で設定できます。 また、codespace を GitHub CLI を使って作成する場合は、その特定の codespace のタイムアウト期間を設定できます。 詳しくは、上記の該当するタブをクリックしてください。

参考資料