GitHub 저장소 미러링

저장소 미러링(repository mirroring)은 Git 저장소의 모든 브랜치, 태그, 참조를 다른 원격 저장소에 그대로 복제해서 두 저장소를 동일한 상태로 유지하는 작업이다. GitHub에서 GitLab으로 이전하거나, 사내 서버에 백업 사본을 두거나, 내부 저장소를 외부에 공개 미러로 제공할 때 사용한다. 핵심 도구는 git clone --mirror와 git push --mirror이며, 지속적인 동기화는 예약 작업으로 자동화한다.

미러링의 개념과 일반 클론과의 차이

일반적인 git clone은 기본 브랜치를 체크아웃하고 원격 브랜치를 원격 추적 참조로만 가져온다. 반면 미러 클론은 작업 디렉터리가 없는 베어 저장소(bare repository)로 만들어지며, 모든 브랜치와 태그를 포함한 원본의 참조(ref) 전체를 로컬 참조로 그대로 복사한다. 또한 원본에서 삭제된 참조는 미러에서도 삭제되도록 설정되므로, 미러는 원본의 완전한 거울이 된다.

git clone --bare와의 차이도 알아 두면 좋다. 베어 클론은 참조를 한 번 복사할 뿐이지만, 미러 클론은 remote 설정에 모든 참조를 갱신하는 fetch 규칙이 걸려 있어서 이후 git remote update 한 번으로 원본의 최신 상태를 통째로 따라갈 수 있다. 미러링은 이 성질을 이용해 원본에서 가져오고 대상에 밀어 넣는 두 단계로 이루어진다.

미러링 실제 절차

저장소를 다른 곳으로 옮기거나 복제하는 기본 절차는 다음과 같다. 먼저 대상 플랫폼에 빈 저장소를 만들어 두어야 한다.

# 1. 원본을 미러 클론한다 (모든 브랜치와 태그 포함)
git clone --mirror https://github.com/<원본계정>/<저장소>.git
cd <저장소>.git

# 2. 대상 저장소로 전체를 밀어 넣는다
git push --mirror https://github.com/<대상계정>/<저장소>.git

일회성 이전이 아니라 지속적인 동기화가 목적이라면 미러 클론을 유지한 채 주기적으로 갱신과 푸시를 반복한다.

# 원본의 최신 상태를 가져온다 (삭제된 참조도 반영)
git remote update --prune

# 대상에 다시 밀어 넣는다
git push --mirror https://github.com/<대상계정>/<저장소>.git

git push --mirror는 대상에만 있는 참조를 삭제하는 파괴적인 명령이므로, 대상 저장소에서 독자적인 커밋이 일어나는 상황과 함께 쓰면 안 된다. 미러 대상은 항상 읽기 전용으로 취급하는 것이 원칙이다. 브랜치와 태그만 밀고 싶다면 다음처럼 범위를 좁힐 수도 있다.

git push target-remote --all    # 모든 브랜치
git push target-remote --tags   # 모든 태그