Mobile Factory Tech Blog

技術好きな方へ！モバイルファクトリーのエンジニアたちが楽しい技術話をお届けします！

大規模リポジトリで git fetch 後に OOM が発生する問題と対処法

Git

駅奪取チームでエンジニアをしている id:kebhr です。

大きな git リポジトリで git コマンドを実行した際、OOM Killer によって git プロセスが強制終了される問題に遭遇しました。その原因と対処法について共有します。

TL;DR

git maintenance の自動実行が原因で OOM が発生する場合は、以下のコマンドで無効化できます。

git config --local maintenance.auto false

背景

私たちのチームでは、画像や JS/CSS などの静的ファイルを専用の EC2 インスタンス (t3a.small) から配信しています（以降、「static インスタンス」と呼びます）。これらの静的ファイルは GitHub 上のリポジトリで管理されており、画像ファイルを含むため、リポジトリのサイズは大きくなっています。

static インスタンスは静的ファイルの配信に特化しており、通常は nginx が動作するだけなので、コストを抑えるために t3a.small（メモリ 2GB）という小さなインスタンスタイプを選択しています。

運用フローは以下の通りです：

  1. インスタンス起動時：ユーザーデータで GitHub から最新のリポジトリを git fetch
  2. 運用中：本番環境への変更を rsync で同期（git は使用しない）

問題の発生

2025 年 4 月頃から、static インスタンスの起動時に git プロセスが OOM Killer によって強制終了される事象が発生するようになりました。

Apr  9 10:05:02 ip-10-55-5-153 kernel: [  268.544103] Out of memory: Killed process 1965 (git) total-vm:3838224kB, anon-rss:1392756kB, file-rss:536kB, shmem-rss:0kB, UID:5000 pgtables:3928kB oom_score_adj:0

原因の調査

当初、git fetch が失敗していると考えましたが、実際には git fetch は正常に完了していました。そのため、別のプロセスが原因と考えました。

開発環境で再現させながらプロセスツリーを監視したところ、git fetch の後に自動実行される git maintenance のサブプロセスが OOM の原因であることが判明しました。

   2246 ?        Ss     0:00 /usr/lib/git-core/git maintenance run --auto --no-quiet --detach
   2247 ?        S      0:00  \_ /usr/lib/git-core/git gc --auto --no-quiet --no-detach
   2251 ?        S      0:00      \_ /usr/lib/git-core/git repack -d -l --cruft --cruft-expiration=2.weeks.ago --keep-pack=pack-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.pack
   2252 ?        Sl     1:56          \_ /usr/lib/git-core/git pack-objects --local --delta-base-offset .git/objects/pack/.tmp-2251-pack --keep-true-parents --honor-pack-keep --keep-pack=pack-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.pac

git maintenance について

git maintenance は、リポジトリへの書き込み操作（fetch、commit、merge、rebase など）の後に自動的に実行される最適化処理です。リポジトリのパフォーマンスを維持するために、不要なオブジェクトの削除やパックファイルの再編成を行います。

しかし、大きなリポジトリでは pack-objects プロセスが大量のメモリを消費し、メモリ容量の小さいインスタンスでは OOM を引き起こす可能性があります。

対処法

git の maintenance.auto オプションを false に設定することで、自動実行を無効化できます。

git config --local maintenance.auto false

この設定により、git fetch などの操作後も git maintenance は実行されなくなります。

まとめ

メモリ容量が限られた環境で大きな git リポジトリを扱う場合、git maintenance の自動実行が OOM の原因となることがあります。特に、今回のケースのように「起動時に一度だけ git fetch を実行し、その後は git を使用しない」という運用では、maintenance.auto を無効化しても実用上の問題はありません。

ただし、この対処法は以下の条件下でのみ有効です：

  • git fetch や git pull を定期的に実行しない環境
  • リポジトリの更新を git 以外の方法（rsync など）で行う環境

通常の開発環境や、定期的に git 操作を行う環境では、メンテナンスの無効化は推奨されません。その場合は、メモリに余裕のあるインスタンスタイプへの変更や、定期的な手動メンテナンスの実施を検討してください。

モバファクでは中途採用・新卒採用ともに絶賛募集中です。
会社の情報については、モバファクブログでも発信しています。
技術好きな方、モバファクにご興味をお持ちの方は、ぜひご応募ください！
・モバファクブログ：https://corpcomn.mobilefactory.jp/
・採用サイト：https://recruit.mobilefactory.jp/