Git LFS 이전: 이미 커진 저장소의 이력·팀 클론·복구를 함께 점검
AI Editter
대용량 ZIP을 삭제해 커밋했는데 clone 시간이 그대로라면 파일이 과거 커밋에 남아 있을 가능성이 큽니다. 현재 작업 폴더 크기와 Git이 보관하는 기록의 크기는 다릅니다. 먼저 어느 쪽이 큰지 구분해야 불필요하게 기록을 바꾸지 않습니다.
기록 재작성은 커밋 ID를 바꿉니다. 개인 저장소에서의 정리와 여러 개발자·CI·열린 PR이 사용하는 저장소의 정리는 운영 난도가 다릅니다. 아래 절차는 분석용 복제본에서 원인을 찾고, 팀이 정한 전환 시간에만 원격 변경을 진행하는 방식입니다.
앞으로 올릴 파일과 이미 커진 이력을 구분
Git LFS 추적 규칙을 추가했다고 과거 커밋의 대용량 파일이 자동으로 모두 이동하지는 않습니다. 신규 파일부터 LFS로 보낼지, 과거 이력까지 재작성할지 먼저 결정해야 합니다. 이력 재작성은 커밋 ID와 다른 사람의 클론에 영향을 주므로 개인 저장소의 간단한 정리 명령과 같은 절차로 처리하면 안 됩니다. 호스팅 서비스의 LFS 저장·다운로드 한도도 이관 전에 확인합니다.
파일·객체·LFS 저장 공간을 따로 조사
git count-objects -vH
git lfs ls-files
git rev-parse --is-shallow-repository
LFS 명령은 Git LFS가 설치된 환경에서 사용합니다. shallow clone은 전체 이력이 없으므로 저장소 전체 분석에 적합하지 않을 수 있습니다. 브랜치와 태그도 분석 범위에 포함되는지 확인합니다.
| 큰 항목 | 검토할 조치 |
|---|---|
| 빌드 산출물·배포 ZIP | 릴리스 저장소나 객체 스토리지로 분리 |
| 버전 관리가 필요한 바이너리 | LFS 이관 |
| 캐시·임시 파일 | 추적 중단과 ignore 규칙 |
| 원래 정상인 긴 소스 이력 | clone 전략·부분 clone 검토 |
| 노출된 비밀키 | 먼저 폐기·교체, 이후 기록 정리 |
비밀키는 기록에서 지워도 이미 복제되었을 수 있습니다. 용량 최적화와 자격 증명 대응을 같은 문제로 처리하지 않습니다.
삭제 커밋과 과거 기록 정리의 차이
삭제 커밋은 이후 버전에서 파일을 없앱니다. 과거 버전으로 돌아갈 수 있도록 이전 내용은 남습니다. git gc만 실행해도 모든 과거의 큰 파일이 사라진다는 설명은 맞지 않습니다. 여전히 참조되는 객체는 보관 대상입니다.
git filter-repo --analyze는 분석용 복제본에서 경로·확장자별 정보를 살펴볼 때 유용합니다. 도구 설치와 버전은 git-filter-repo 공식 저장소에서 확인합니다. 분석 결과로 삭제할 파일과 앞으로 LFS로 관리할 파일을 구분합니다.
LFS로 바꿔도 기존 이력은 자동 변환되지 않는다
git lfs track은 이후 추적 규칙을 지정하는 데 쓰입니다. 과거 커밋의 바이너리를 변환하려면 별도의 migration이 필요합니다. GitHub의 기존 파일을 LFS로 옮기는 설명과 Git LFS migrate 문서를 함께 확인합니다.
분석용 새 복제본에서 먼저 대상 크기를 조사할 수 있습니다.
git lfs migrate info --everything
그 뒤 변환할 확장자·경로와 포함할 refs를 결정합니다. everything을 사용한 변환은 범위가 넓으므로 운영 저장소에서 즉시 실행할 명령으로 제공하지 않습니다. 대상 패턴이 정해진 후 disposable 복제본에서 변환하고, 변경 전후 결과를 비교해야 합니다.
LFS에도 저장 공간·대역폭·호스팅 플랜의 제약이 있습니다. Git pack이 작아졌더라도 개발 환경에서 매번 모든 LFS 파일을 다운로드하면 전체 다운로드 비용과 시간이 예상만큼 줄지 않을 수 있습니다.
원격 변경 전에 남길 전환 기록
| 기록 | 필요한 이유 |
|---|---|
| 변경 전 branch·tag의 커밋 ID | 비교·복구 기준 |
| 원본 저장소 별도 보관 | 변경 전 객체 복구 |
| LFS 원본 객체 백업 | Git refs만으로 파일 본문 복구 불가 |
| 열린 PR·CI·배포 참조 | 이전 커밋 ID를 쓰는 곳 조사 |
| write 중단 시간 | 분석 이후 새 커밋 유입 방지 |
| 보호 규칙 변경·복원 담당 | 원격 갱신을 제한된 시간에 수행 |
Git bundle이나 mirror가 모든 LFS 본문까지 자동 보관한다고 가정하면 안 됩니다. LFS 객체를 포함해 오프라인 복구가 가능한지 실제로 검사합니다.
변환한 복제본에서 확인할 결과
파일 이름이 있다는 것만 확인하지 않습니다. LFS pointer가 실제 바이너리로 내려받아지는지, 대표 태그의 파일 해시가 원본과 같은지, clean clone에서 빌드·테스트가 통과하는지 확인합니다.
| 시험 | 비교할 값 |
|---|---|
| 새 clone | Git 전송량·LFS 전송량·총 소요 시간 |
| 대표 과거 태그 | 파일 본문·빌드 가능 여부 |
| 최신 브랜치 | 테스트·배포 산출물 |
| CI | LFS 다운로드 설정·권한·캐시 |
| 협업 복귀 | 이전 이력이 다시 합쳐지지 않는지 |
원격의 실제 용량은 서버의 객체 정리 정책과 숨은 참조 때문에 즉시 줄지 않을 수 있습니다. 로컬 수치가 줄었다는 이유로 원격 정리가 완료됐다고 판단하지 않습니다.
기록 재작성 후에는 팀이 정한 방법으로 새로 clone하는 편이 혼란을 줄일 수 있습니다. 개인의 미반영 작업은 별도로 보관하고 새 이력 위에 검토해 옮깁니다. 오래된 브랜치를 그대로 merge해 정리한 객체가 다시 들어오지 않도록 전환 안내까지 작업에 포함합니다.