[Git] Repository 미러링 (저장소 커밋 포함 복사)

🪞 미러링

A 저장소에서 작업한 내용을 B 저장소로 옮기고 싶을 때가 있다.

깃랩 저장소에서 작업한 내용을 깃허브로 이전해야 한다든가.. 그 반대라든가.. 등등

단순히 파일을 옮겨서 B 저장소에 옮기면 된다고 생각할 수도 있지만, 그렇게 하면 기존의 A 저장소에서 작업했던 커밋 내역들은 옮겨지지 않는다.

그럴 때 "미러링"을 이용하면 A 저장소의 브랜치나 커밋 내역도 함께 복사된다.

 

🔍 미러링 과정

A  저장소 -> B 저장소로 복사하는 상황이다.

 

1. B 리포지토리를 만든다.

 

2. A 리포지토리의 Bare Repository를 생성한다.

git clone --mirror <A 저장소 URL>

Bare Repository는 코드 파일(워크트리)이 없고, Git 데이터만 포함한다.

원본 저장소의 모든 브랜치와 태그, Git 설정을 포함한 참조 데이터(refs)를 완전히 복사한다.

 

cd <A 저장소 이름>.git

clone 받은 A 저장소의 이름으로 새로 생긴 폴더로 이동한다.

 

3. 푸시할 리포지토리를 B 리포지토리로 변경한다.

git remote set-url --push origin <B 저장소 URL>

원격 저장소(origin)의 푸시 URL을 설정한다.

fetch URL을 기존 상태(A 저장소)로 유지하고 push URL만 B 저장소로 변경한다.

 

4. B 저장소로 동기화한다.

git push --mirror

로컬 저장소(A)의 모든 참조(브랜치, 커밋 등)를 원격 저장소(B)로 동기화한다.

이제 원격 저장소가 로컬 저장소의 완벽한 복제본이 된다.

 

🗂️ 대용량 파일 오류

예전에는 대용량 파일이 없어 위 내용대로 하면 미러링이 됐었는데 이번에는 대용량 파일 때문에 오류가 발생했다.

 

자 그럼 대용량 파일이 있다면 이어서 따라 해 보자..

 

4. lfs 설치

git lfs install

 

5. BFG Repo-Cleaner 설치

BFG Repo-Cleaner를 방문해서 bfg-1.14.0.jar 파일을 다운로드한다.

해당 파일은 Bare Repository인 <A 저장소 이름>.git 폴더와 같은 위치에 두면 된다.

 

6. 대용량 파일 찾기

 git filter-branch --tree-filter 'git lfs track "*.gif"' -- --all

나 같은 경우는 gif 파일들이 문제였어서 확장자를 gif로 지정해 줬다.

"*"로 하면 모든 파일을 대상으로 찾는다.

 

6. 대용량 파일 변환 및 제거

java -jar ../bfg-1.14.0.jar --convert-to-git-lfs '*.gif'

대용량 파일을 효율적으로 관리하기 위해 모든 gif 파일을 Git LFS로 변환한다.

대용량 파일은 LFS 스토리지로 이동하고 Git 저장소에는 작은 포인터 파일만 저장된다.

 

java -jar ../bfg-1.14.0.jar --strip-blobs-bigger-than 100M

히스토리에서 100MB 이상의 파일을 완전히 제거한다.

 

위 과정을 마치니 미러링이 성공적으로 완료되었다!