Skip to content
← リリースに戻る · 2.1.268
新機能 / v2.1.268

--remove-session-state追加

CHANGELOG 原文(英語)

Added claude self-hosted-runner --remove-session-state (default off): delete each session's per-session directories under <base-dir>/_sessions/ when the session ends
公式の変更履歴を開く ↗

日本語での補足

claude self-hosted-runner --remove-session-state(デフォルトはオフ)を追加。セッション終了時に<base-dir>/_sessions/配下の各セッション専用ディレクトリを削除するようになった。

ドキュメント

ドキュメントの抜粋(参考訳)

事前にウォームアップされたチェックアウトを再利用する

大規模なリポジトリでは、クローンの処理がセッション起動時間の大半を占めることがあります。コールドクローンを省くには、ランナーが自身のクローンを保持するパスに、自分でクローンを用意してください。checkout フックがない場合、ランナーはリポジトリごとに1つの正規クローンを <base-dir>/<repo-owner>/<repo> に保持し、セッションをまたいで再利用します。

  • --capacity 1 の場合: ランナーは対象の ref を fetch し、HEAD を detach してそこへハードリセットします。変更がほとんどない場合はほぼ瞬時に完了します。
  • --capacity が1より大きい場合: ランナーはそのクローンに fetch した後、セッションごとにそこから個別のワークツリーをチェックアウトします。事前にウォームアップしたクローンでダウンロードは省けますが、チェックアウトは省けません。

クローンはイメージ内または永続ボリューム上に用意します。

  • イメージ内にクローンを含める: ランナーイメージのそのパスにクローンを組み込んでビルドします。新しいコンテナはディスクを再利用しなくても、常にウォームなクローンから開始します。
  • 永続ボリューム上にクローンを配置する: --lock-to-account で1人のユーザーのアカウントに事前ロックしたランナーでは、--base-dir を永続ボリュームに向けることで、そのディスクを常にそのアカウント専用にできます。事前ロックされたランナーは Claude Tag のチャンネルセッションを受け付けないため、この方法はそれらを扱うランナーには適用できません。

--base-dirの外にあるクローンを使うには、--capacity 1で、その実際のパスを--repository-folderに渡してください。例えば--repository-folder acme/api=/volumes/warm/apiのようにします。ランナーは、セッションごとにそのクローンのトラッキング済みファイルをリセットします。各ランナーには、すべてのランナーで同じパスに置いた専用のコピーを与えてください。各ランナーは新しいコピーで起動するか、--lock-to-accountで固定フリートのランナーを事前ロックしてください。

再利用の仕組みが保証すること、しないこと:

  • クローンの深さ: クローンは --depth を付けずに作成してください(--single-branch を付けるかどうかは任意です)。ランナーは、origin リモートを持つクローンへの fetch 時には --depth を渡しません。これは CLAUDE_RUNNER_FETCH_DEPTH を設定していても同じです。フルクローンの場合、各セッションはクローンに不足しているコミットのみをダウンロードします。シャロークローンの場合、クローンの最も古いコミットより前に分岐したブランチでのセッションは、そのブランチの履歴全体をダウンロードします。

  • トラッキング済みの変更はリセットされるが、未トラッキングのファイルは残る: --capacity 1 では、各セッションは前回のセッションでのトラッキング済みの変更を消し去るハードリセットから始まります。ただしランナーは git clean を実行しないため、ロックされた所有者の以前のセッションによる未トラッキングのファイルはツリーに残ったままです。

  • セッションごとのディレクトリも残る: チェックアウトと並んで、ランナーは実行するすべてのセッションについて、<base-dir>/_sessions/ 配下にセッションごとのエントリを作成します。セッションの Claude 設定ディレクトリには、会話のトランスクリプトのローカルコピーが保存されます。その隣には、セッションにアップロードされたファイルがある場合、それらが置かれます。セッションディレクトリ自体もそこにあり、セッション実行中のセッションごとのワークツリーと checkout フックのチェックアウトを保持するほか、Claude がそこに書き込んだその他のものも保持します。

    既定では、セッションが終了してもランナーはこれらをそのまま残すため、ランナープロセスより長く存在するディスクでは蓄積していきます。すべてのセッションはランナー自身のユーザーとして実行されるため、そのディスクを利用する後続のセッションはどれもそれらを読み取れます。永続的な --base-dir を維持する場合は、この増加分を見込んでボリュームのサイズを決めてください。同じことは、Docker Compose のレシピを含め、同じファイルシステム上でランナーを再起動するあらゆる構成にも当てはまります。

  • --remove-session-state を指定すると、セッションごとのディレクトリは残らない: --remove-session-state を指定してランナーを起動すると、各セッションの終了時にそのセッションごとのディレクトリを削除するようになります。この削除はベストエフォートであり、クリーンアップが実行される前にランナーが強制終了された場合、ディレクトリは残ります。正規クローンや、一時ディレクトリなどホスト上の他の場所にセッションが書き込んだファイルは、いずれにせよ残ります。

  • git プロキシを使うと、リセットがチェックアウトになる: --use-anthropic-git-proxy を指定すると、ランナーは各セッションの前にクローンの .git/ をサニタイズします。オブジェクトストアとシャロー状態は保持し、インデックスは削除します。インデックスがないため、各セッションはほぼ瞬時のリセットの代わりにフルなワークツリーのチェックアウトから始まります。それでもランナーは既存のクローンへの fetch を行うだけで、リポジトリを再クローンすることはありません。プロキシ配下ではサブモジュールの事前ウォームアップはサポートされません。

  • git プロキシを使うと、reftable での事前ウォームアップは ref を失う: ランナーが各セッションの前に .git/ をサニタイズする際、.git/refs/ は保持しますが .git/reftable/ ディレクトリは削除します。そのため、git の reftable ref 形式で事前ウォームアップしたクローンは、この処理で ref を失います。クローンの事前ウォームアップは、代わりに git の files ref 形式で行ってください。

  • 長時間かかるクローンに回避策は不要: ランナーは各 git 操作を、一律のタイムアウトではなく、120秒間進捗がない場合のウォッチドッグと 30 分のハードキャップで制限します。そのため、進捗を報告し続けている遅いコールドクローンは完了まで実行されます。

ランナーが自分のクローンを使っていることを確認する

ランナーが自分のクローンを使っていることを確認するには、--log-level debug を指定して起動し、そのリポジトリでセッションを開始します。ランナーは Prefetched repo found at とそのクローンのパスをログに出力します。代わりに No prefetched repo, fresh init at が出力された場合、その行にあるパスには使用可能なクローンが見つからなかったことを意味します。自分のクローンがそのパスにあり、ランナーのユーザーが所有者になっており、origin という名前のリモートを持っていることを確認してください。

ランナーが自分のクローンを見つけているのに、セッションの起動が依然として遅い場合は、そのクローンがシャローになっていないか確認してください。

取得日 · 2026-11-20

変更の詳細