1 つ以上のメンテナンス タスクを実行します。1 つ以上の --task オプションが指定されている場合、それらのタスクはその順序で実行されます。そうでない場合、タスクは maintenance.<task>.enabled のどの設定オプションが true であるかによって決定されます。デフォルトでは、maintenance.gc.enabled のみが true です。

現在のリポジトリでメンテナンスの実行を開始します。これは register サブコマンドと同じ設定更新を実行し、その後、バックグラウンドスケジューラを更新して、1 時間ごとに git maintenance run --scheduled を実行します。

バックグラウンドメンテナンススケジュールを停止します。バックグラウンドメンテナンスが後で再開される場合に備えて、現在のリポジトリはメンテナンス対象リポジトリのリストから削除されません。

Git 設定値を初期化し、スケジュールされたメンテナンスがこのリポジトリで実行されるようにします。これは、現在のユーザーのグローバル設定、または --config-file オプションで指定された設定の maintenance.repo 設定変数にリポジトリを追加し、maintenance.<task>.schedule の推奨設定値を有効にします。有効化されるタスクは、フォアグラウンドプロセスを妨げることなくバックグラウンドで安全に実行できます。

現在のリポジトリをバックグラウンドメンテナンスから削除します。これは、リポジトリを設定リストから削除するだけです。バックグラウンドメンテナンスプロセスが実行を停止するわけではありません。

commit-graph ジョブは、commit-graph ファイルをインクリメンタルに更新し、書き込まれたデータが正しいことを検証します。インクリメンタル書き込みは、前の commit-graph-chain ファイルにあった .graph ファイルを期限切れにしないため、並行 Git プロセスと並行して安全に実行できます。それらは、期限切れの遅延に基づいて、後で実行される際に削除されます。

prefetch タスクは、登録されているすべてのリモートから最新のオブジェクトでオブジェクトディレクトリを更新します。各リモートに対して、git fetch コマンドが実行されます。設定された refspec は、要求されたすべての ref を refs/prefetch/ 内に配置するように変更されます。また、タグは更新されません。

不要なファイルをクリーンアップし、ローカルリポジトリを最適化します。「GC」は「ガーベージコレクション」を意味しますが、このタスクは多くの小さなタスクを実行します。このタスクは、すべての Git オブジェクトを単一のパックファイルに再パックするため、大きなリポジトリではコストがかかる場合があります。また、古いデータを削除するため、一部の状況では中断を伴う場合があります。Git のガーベージコレクションの詳細については、git-gc[1] を参照してください。

loose-objects ジョブは、ルーズオブジェクトをクリーンアップし、パックファイルに配置します。並行する Git コマンドとの競合状態を防ぐため、2 段階のプロセスに従います。まず、すでにパックファイルに存在するルーズオブジェクトを削除します。並行する Git プロセスは、ルーズオブジェクトの代わりにパックファイルからオブジェクトデータを調べます。次に、ルーズオブジェクトのバッチを含む新しいパックファイル（"loose-"で始まる）を作成します。

incremental-repack ジョブは、multi-pack-index 機能を使用してオブジェクトディレクトリを再パックします。並行する Git コマンドとの競合状態を防ぐため、2 段階のプロセスに従います。まず、git multi-pack-index expire を呼び出して、multi-pack-index ファイルによって参照されていないパックファイルを削除します。次に、git multi-pack-index repack を呼び出して、いくつかの小さなパックファイルを選択してより大きなものに再パックし、その後、小さなパックファイルを参照する multi-pack-index エントリを新しいパックファイルを参照するように更新します。これにより、小さなパックファイルは次の git multi-pack-index expire の実行時に削除される準備ができます。小さなパックファイルの選択は、大きなパックファイルの予想サイズがバッチサイズ以上になるように行われます。詳細については、git-multi-pack-index[1] の repack サブコマンドの --batch-size オプションを参照してください。デフォルトのバッチサイズは 0 で、これはすべてのパックファイルを単一のパックファイルに再パックしようとする特別なケースです。

pack-refs タスクは、ルーズな参照ファイルを収集し、単一のファイルにまとめます。これにより、多くの参照を反復処理する必要がある操作が高速化されます。詳細については、git-pack-refs[1] を参照してください。

reflog-expire タスクは、期限切れのしきい値よりも古い reflog エントリを削除します。詳細については、git-reflog[1] を参照してください。

rerere-gc タスクは、rerere キャッシュ内の古いエントリに対してガーベージコレクションを呼び出します。詳細については、git-rerere[1] を参照してください。

worktree-prune タスクは、古くなったワークツリーまたは壊れたワークツリーを削除します。詳細については、git-worktree[1] を参照してください。

run サブコマンドと組み合わせると、特定のしきい値が満たされた場合にのみメンテナンス タスクを実行します。たとえば、gc タスクは、ルーズ オブジェクトの数が gc.auto 設定に格納されている数を超えるか、パックファイルの数が gc.autoPackLimit 設定を超えるときに実行されます。--schedule オプションとは互換性がありません。

run サブコマンドと組み合わせると、各 <task> の maintenance.<task>.schedule 設定値で指定された特定の時間条件が満たされた場合にのみメンテナンス タスクを実行します。この設定値は、maintenance.<task>.lastRun 設定値に従って、そのタスクが最後に実行されてからの秒数を指定します。テストされるタスクは、--task=<task> オプションで提供されるタスク、または maintenance.<task>.enabled が true に設定されているタスクです。

stderr に進行状況やその他の情報を報告しません。

このオプションが 1 回以上指定されている場合、指定されたタスクのみが指定された順序で実行されます。--task=<task> 引数が指定されていない場合、maintenance.<task>.enabled が true に設定されているタスクのみが考慮されます。許容される <task> 値のリストについては、「タスク」セクションを参照してください。

start サブコマンドと組み合わせると、git maintenance run を 1 時間ごと、毎日、毎週実行するためのスケジューラを指定します。<scheduler> の可能な値は、auto、crontab (POSIX)、systemd-timer (Linux)、launchctl (macOS)、および schtasks (Windows) です。auto が指定されている場合、適切なプラットフォーム固有のスケジューラが使用されます。Linux では、systemd-timer が利用可能であればそれが使用され、そうでなければ crontab が使用されます。デフォルトは auto です。

このブーリアン設定オプションは、一部のコマンドが通常の作業の後に git maintenance run --auto を実行するかどうかを制御します。デフォルトは true です。

多くの Git コマンドは、リポジトリにデータを書き込んだ後に自動メンテナンスをトリガーします。このブーリアン設定オプションは、この自動メンテナンスがフォアグラウンドで発生するか、メンテナンスプロセスがデタッチしてバックグラウンドで実行を継続するかどうかを制御します。

この文字列設定オプションは、バックグラウンドメンテナンスの推奨スケジュールをいくつか指定する方法を提供します。--task=<task> 引数が指定されていない場合、これは git maintenance run --schedule=X コマンド中に実行されるタスクのみに影響します。さらに、maintenance.<task>.schedule 設定値が設定されている場合、その値は maintenance.strategy によって提供される値の代わりに使用されます。可能な戦略文字列は次のとおりです。

このブーリアン設定オプションは、git maintenance run に --task オプションが指定されていないときに、名前が <task> であるメンテナンス タスクが実行されるかどうかを制御します。--task オプションが存在する場合、これらの設定値は無視されます。デフォルトでは、maintenance.gc.enabled のみが true です。

この設定オプションは、git maintenance run --schedule=<frequency> コマンド中に指定された <task> が実行されるかどうかを制御します。値は「hourly」、「daily」、または「weekly」のいずれかである必要があります。

この整数設定オプションは、git maintenance run --auto の一部として commit-graph タスクをどのくらいの頻度で実行すべきかを制御します。ゼロの場合、commit-graph タスクは --auto オプションでは実行されません。負の値は、タスクを毎回強制的に実行します。それ以外の場合、正の値は、コミットグラフファイルにない到達可能なコミットの数が maintenance.commit-graph.auto の値以上である場合にコマンドを実行すべきであることを意味します。デフォルト値は 100 です。

この整数設定オプションは、git maintenance run --auto の一部として loose-objects タスクをどのくらいの頻度で実行すべきかを制御します。ゼロの場合、loose-objects タスクは --auto オプションでは実行されません。負の値は、タスクを毎回強制的に実行します。それ以外の場合、正の値は、ルーズオブジェクトの数が maintenance.loose-objects.auto の値以上である場合にコマンドを実行すべきであることを意味します。デフォルト値は 100 です。

この整数設定オプションは、loose-objects タスク中にパックファイルに書き込まれるルーズオブジェクトの最大数を制御します。デフォルトは5万です。制限なしを示すには、値 0 を使用します。

この整数設定オプションは、git maintenance run --auto の一部として incremental-repack タスクをどのくらいの頻度で実行すべきかを制御します。ゼロの場合、incremental-repack タスクは --auto オプションでは実行されません。負の値は、タスクを毎回強制的に実行します。それ以外の場合、正の値は、マルチパックインデックスにないパックファイルの数が maintenance.incremental-repack.auto の値以上である場合にコマンドを実行すべきであることを意味します。デフォルト値は 10 です。

この整数設定オプションは、git maintenance run --auto の一部として reflog-expire タスクをどのくらいの頻度で実行すべきかを制御します。ゼロの場合、reflog-expire タスクは --auto オプションでは実行されません。負の値は、タスクを毎回強制的に実行します。それ以外の場合、正の値は、「HEAD」reflog の期限切れ reflog エントリの数が maintenance.loose-objects.auto の値以上である場合にコマンドを実行すべきであることを意味します。デフォルト値は 100 です。

この整数設定オプションは、git maintenance run --auto の一部として rerere-gc タスクをどのくらいの頻度で実行すべきかを制御します。ゼロの場合、rerere-gc タスクは --auto オプションでは実行されません。負の値は、タスクを毎回強制的に実行します。それ以外の場合、正の値は、"rr-cache" ディレクトリが存在し、古くなっているかどうかにかかわらず、少なくとも 1 つのエントリがある場合にコマンドが実行されることを意味します。このヒューリスティックは将来的に改善される可能性があります。デフォルト値は 1 です。

この整数設定オプションは、git maintenance run --auto の一部として worktree-prune タスクをどのくらいの頻度で実行すべきかを制御します。ゼロの場合、worktree-prune タスクは --auto オプションでは実行されません。負の値は、タスクを毎回強制的に実行します。それ以外の場合、正の値は、剪定可能なワークツリーの数が値を超えた場合にコマンドを実行すべきであることを意味します。デフォルト値は 1 です。