What Happen When Pull Event On Bare

1 분 소요

Overview

클라이언트에서 git pull 명령이 실행되면, 서버에서는 Fetch 요청에 응답하는 과정만 담당한다.
이때 서버는 읽기 중심의 동작(read only)을 수행하며, 실제 Merge나 Rebase 등의 작업은 클라이언트 측에서 진행된다.

Key Terms Explained

Pack: Git 객체를 효율적으로 저장하기위한 압축 파일 형식으로, .pack 파일과 인덱스역할을 하는.idx 파일로 구성된다.
Bare Repository: .git 폴더만 존재하며, 작업 디렉터리(working tree)가 없는 저장소 형태로, 서버에서 원격 저장소로 사용된다.
git-upload-pack: 클라이언트의 Pull(혹은 Fetch) 요청을 처리하는 읽기 전용 엔드포인트
git-receive-pack: 클라이언트의 Push 요청을 처리하는 쓰기 전용 엔드포인트

Flow

Git 클라이언트가 git pull 수행시 서버에서는 fetch 요청에 응답하는 과정만 담당하며, 읽기 중심의 작업이 진행됨

sequenceDiagram
    autonumber
    participant C as Client (git pull)
    participant G as Git Server (JGit GitServlet)
    participant R as Bare Repo (.git) (FS)

    Note over C: git pull = fetch + (merge/rebase)<br/>서버는 fetch 단계만 처리

    C->>G: GET /<repo>.git/info/refs?service=git-upload-pack
    G->>R: refs 조회 + capability 확인
    R-->>G: refs 목록
    G-->>C: refs + capabilities (Discovery 단계)

    C->>G: POST /<repo>.git/git-upload-pack<br/>(want/have, shallow 옵션 등)
    G->>R: 객체 그래프 탐색 및 필요한 객체 계산
    Note over G,R: thin-pack / ofs-delta / bitmap index 등 최적화 수행

    G-->>C: side-band 스트림 시작<br/>ch1: pack 데이터<br/>ch2: 진행률<br/>ch3: 에러
    Note over C: packfile 수신 (.pack + .idx)

    C->>C: 로컬 객체 DB 갱신 및 인덱스 작성
    C->>C: (pull의 후반) merge 또는 rebase 수행

Flow Detail

1. Discovery

르라이언트가 git pull (Smart HTTP방식)을 수행하면, 내부적으로 서버의 git-upload-pack 엔드포인트로 refs 정보를 요청한다.

1-1. 클라이언트 요청

GET /<repo>.git/info/refs?service=git-upload-pack

refs 조회 요청

1-2 서버 응답

서버는 파일 시스템 내 Bare Repository를 탐색해 아래 정보를 클라이언트에게 전달한다.

HEAD
refs/heads/* (브랜치정보)
refs/tags/* (태그정보)

이 과정을 ref광고(Discovery) 라고 칭하며, 클라이언트가 이후에 Fetch 요청을 구성할 수 있도록 정보를 제공한다.

2. Fetch

클라이언트는 Discovery 단계에서 받은 refs 정보를 바탕으로, 서버가 가지고 있지만 로컬에는 없는 커밋들을 요청한다.

POST /<repo>.git/git-upload-pack

요청에는 want, have, shallow 옵션 등이 포함된다.

3. Negotiation (비교를 통한 동기화 결정)

클라이언트와 서버간의 refs 정보를 비교(handshake)
로컬에 없는 객체만 선별후 요청(효율적 데이터 전송)
서버는 필요한 객체를 계산한 후 packfile을 생성하여 응답

4. Packfile 전송 및 수신

서버는 side-band 스트림을 통해 데이터를 전송한다.

채널	내용
ch1	pack 데이터
ch2	진행률 정보
ch3	오류 메세지

클라이언트는 수신한 .pack 파일을 로컬 객체 DB에 반영하고 인덱스를 작성한다.

5. Merge or Rebase

Fetch가 완료되면, 클라이언트는 로컬 브랜치와 병합하거나 리베이스를 수행해 최종적으로 로컬 상태를 갱신한다.

Conclusion

서버는 refs 정보를 제공
클라이언트는 이를 기반으로 필요한 객체만 요청함.
서버는 Pack 파일을 생성 및 응답해 효율적 동기화를 지원
최종적으로 클라이언트는 Pack 파일을 받아 Merge나 Rebase를 수행함

Twitter Facebook LinkedIn

hr_k