저는 Claude Code 세션을 여러 개 열어 공유 리포지토리의 '작업 요청 폴더'(dispatch/ 폴더에 놓인 요청 파일)에서 작업을 가져가게 하는 운영을 하고 있습니다. 30분마다 에이전트를 깨워 각각이 '아직 아무도 손대지 않은 요청'을 1건 선택하여 작업하게 합니다.
여기서 반드시 문제가 되는 것이 같은 요청을 두 개의 에이전트가 동시에 가져가는 것입니다. 잠금용 서버나 DB를 구축할 필요는 없었기 때문에, 원격 git 브랜치를 잠금(lock) 대용으로 사용했습니다.
# 요청 job-123을 가져감
git push origin HEAD:refs/heads/claim/job-123 # 성공하면 내 것임
# 끝나면 제거함
...
'브랜치 생성은 빠른 자가 이긴다(first come, first served)니까, push가 통과되는 쪽이 승자'라는 발상입니다. 그런데 이것을 그대로 작성하면 두 개 모두 push에 성공합니다. 본문에서는 실제로 빠졌던 함정 2가지와 이를 수정한 후의 3줄 코드를 소개합니다.
에이전트 A도 B도, 착수 표시로 origin/main를 그대로 push하고 있었습니다.
# A
git push origin origin/main:refs/heads/claim/job1
# * [new branch] origin/main -> claim/job1
...
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 ← 업데이트가 없으므로, 조건 확인 자체가 실행되지 않음
'거부되지 않으면 강제로 덮어써서 확인해 보자'라는 생각으로 +를 붙이고 싶지만, 이는 역효과입니다.
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하고 있다'는 점과 '강제(forcing)'를 사용했다는 것입니다. 그래서, 각 표시마다 내용물이 없는 커밋 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; }
- 첫 번째 실행: 브랜치가 없으므로
[new branch]로 성공. - 두 번째 실행: 자신의 커밋이 첫 번째 커밋의 자손이 아니므로 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
원격(remote) ref의 업데이트는 서버 측에서 1건씩 원자적(atomically)으로 이루어지기 때문에, 동시에 push하더라도 성공하는 것은 단 하나뿐입니다. 만약을 위해 --force-with-lease=refs/heads/claim/$slug:를 추가해 두면, "존재하지 않아야 할 브랜치가 있었다"는 것이 stale info라는 명확한 이유로 반환됩니다 (+는 붙이지 않습니다).
커밋 메시지에 이름과 시간을 넣었기 때문에, "누가 언제부터 가지고 있는지"를 원격 저장소만으로 알 수 있습니다.
git ls-remote --heads origin 'claim/*' # 할당된 작업 목록 확인
git log -1 --format='%s' origin/claim/job-123 # 누가 언제 가져갔는지 확인
시간이 너무 오래된 마커는 에이전트가 도중에 다운되었던 흔적입니다. 감시자(watchdog) 역할을 하는 시스템이 이를 발견하고 제거해 준다면, 다음 시작 시 다른 에이전트가 작업을 다시 가져갈 수 있습니다.
| 방법 | 두 번째 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는 "업데이트가 없으면 성공", "+는 조건보다 강하다"라는 두 가지 속성을 가지고 있어, 이를 잠금(lock) 메커니즘으로 사용하면 둘 다 역효과를 냅니다. 마커마다 고유한 커밋을 생성하는 것만으로도 추가 서버 없이 여러 에이전트의 작업 경쟁을 막을 수 있었습니다.