1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

複数のAIエージェントに同じ仕事を取らせない ― git push を「着手の印」にするときの落とし穴2つ

1
Posted at

はじめに

Claude Code のセッションを何本も並べて、共有リポジトリの「受付箱」(dispatch/ フォルダに置いた依頼ファイル)から仕事を拾わせる運用をしています。30 分おきにエージェントを起こし、それぞれが「まだ誰も手を付けていない依頼」を 1 件選んで作業します。

ここで必ず問題になるのが 同じ依頼を 2 本のエージェントが同時に拾うこと です。ロック用のサーバーや DB を立てるほどでもないので、リモートの git ブランチをロック代わりにしました。

# 依頼 job-123 を取る
git push origin HEAD:refs/heads/claim/job-123   # 成功したら自分のもの
# 終わったら外す
git push origin --delete claim/job-123

「ブランチの作成は早い者勝ちだから、push が通ったほうが勝ち」という発想です。ところが、これをそのまま書くと 2 本とも push が成功します。この記事では、実際にはまった落とし穴 2 つと、直したあとの 3 行を紹介します。

落とし穴1: 同じコミットを push すると「Everything up-to-date」で成功する

エージェント A も B も、着手の印として origin/main をそのまま push していました。

# A
git push origin origin/main:refs/heads/claim/job1
#  * [new branch]      origin/main -> claim/job1

# B(A の直後)
git push origin origin/main:refs/heads/claim/job1
# Everything up-to-date
echo $?   # 0

B の push は 拒否されず、終了コード 0 です。リモートのブランチが既に同じコミットを指しているので、git から見ると「更新するものが無い=成功」だからです。「push が失敗したら次の依頼へ」と書いたスクリプトは、B にもそのまま作業を始めさせてしまいます。

--force-with-lease=<ref>:(期待値を空にすると「そのブランチがまだ無いこと」を条件にできる)を足しても同じでした。

git push --force-with-lease=refs/heads/claim/job2: origin origin/main:refs/heads/claim/job2
# Everything up-to-date   ← 更新が無いので、条件の確認そのものが走らない

落とし穴2: + を付けると lease の条件が無視される

「拒否されないなら強制で上書きして確かめよう」と + を付けたくなりますが、これは逆効果です。

git push --force-with-lease=refs/heads/claim/job3: origin +$c:refs/heads/claim/job3
#  + 73ab1fe...caabbc1 ... -> claim/job3 (forced update)

既にあるブランチを 黙って上書き しました。git push --help にもあるとおり、refspec の先頭の + は --force-with-lease の条件より強く効きます。先に取った A の印が消え、A と B の両方が作業する最悪の状態になります。

直し方: エージェントごとに「自分だけのコミット」を作って、+ なしで push する

原因はどちらも「全員が同じコミットを push している」ことと「強制している」ことです。そこで、印ごとに中身の無いコミットを 1 個作り、メッセージに自分の名前を入れます。git commit-tree を使うと作業ツリーを汚さずに作れます。

slug=job-123
c=$(git commit-tree -p origin/main -m "claim $slug by $AGENT_NAME $(date -Iseconds)" 'origin/main^{tree}')
git push origin "$c:refs/heads/claim/$slug" || { echo "取られていた"; exit 1; }
  • 1 本目: ブランチが無いので [new branch] で成功。
  • 2 本目: 自分のコミットは 1 本目のコミットの子孫ではないので non-fast-forward で拒否(終了コード 1)。

手元で確かめた結果です(git 2.43)。

A:  * [new branch]      73ab1fe -> claim/job3        rc=0
B:  ! [rejected]        ...     -> claim/job3 (non-fast-forward)   rc=1
B(lease あり・+ なし): ! [rejected] ... (stale info)      rc=1

リモートの ref の更新はサーバー側で 1 件ずつ原子的に行われるので、同時に push しても勝つのは 1 本だけです。念のため --force-with-lease=refs/heads/claim/$slug: を足しておくと、「無いはずのブランチがあった」ことが stale info という分かりやすい理由で返ってきます(+ は付けない)。

おまけ: 印に情報を持たせる

コミットメッセージに名前と時刻を入れたので、「誰がいつから持っているか」がリモートだけで分かります。

git ls-remote --heads origin 'claim/*'          # 取られている依頼の一覧
git log -1 --format='%s' origin/claim/job-123    # 誰がいつ取ったか

時刻が古すぎる印は、エージェントが途中で落ちた跡です。見張り役がこれを見つけて外せば、次の起動で別のエージェントが拾い直せます。

まとめ

やり方 2 本目の push ロックになるか
全員が origin/main を push Everything up-to-date(rc=0) ならない
同じコミット+--force-with-lease=ref: Everything up-to-date(rc=0) ならない
+ を付けて push 上書き(forced update) 先の印を消す
自分だけのコミットを + なしで push rejected(rc=1) なる

git の push は「更新が無ければ成功」「+ は条件より強い」という 2 つの性質があり、ロックとして使うときはどちらも裏目に出ます。印ごとに一意なコミットを作るだけで、追加のサーバー無しに複数エージェントの取り合いを防げました。

1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?