용량 문제로 Git 리포지토리 push 실패

✅ 서론

몇 달 전 발생했던 에러이다.

해결법을 정리해두면 좋을 것 같아서 포스팅한다.

 

✅ 에러 상황

자바의 스윙 라이브러리로 아주 간단한 게임을 하나 만들었다.

배포용 설치파일을 만들어서 원격 리포지토리에 push를 시도했다.

그러나 설치파일 용량이 큰 관계로, push에 실패하고 에러 메시지가 출력되었다.

 

✅ 에러 해결

방법을 찾아보니 Git LFS(Large File Storage)를 사용하면 된다고 한다.

Git LFS는 용량이 큰 파일을 GitHub 리포지토리가 아니라 별도의 서버에 올리고, 원래 위치에는 포인터만 남기는 방식으로

용량이 큰 파일을 리포지토리에 push할 수 있게 해준다고 한다.

 

계정당 2GB까지만 지원해준다고 하니 꼭 필요할 때만 써야겠다.

 

나같은 경우는 원격 리포지토리에 배포 파일을 반드시 올릴 필요는 없었지만,

이 기회에 Git LFS 를 이용해보고 싶어서 해당 파일을 업로드 해보았다.

---

Git LFS로 파일 업로드 방법

1. Git LFS 설치하기

나는 macOS 유저이기 때문에 homebrew로 설치해 주었다.

터미널에 `brew install git-lfs`를 입력해 주었다.

 

그다음, 현재 작업중인 깃 리포지토리 내에서 git lfs를 사용하겠다고 선언했다.

터미널에 `git lfs install` 를 입력해주었다.

 

리포지토리 외부 경로에서 해당 명령어를 실행하면 전역적으로 모든 리포지토리에서 Git LFS를 쓸 수 있다고 한다.

그러나 나는 내가 작업중인 리포지토리 내부에서 해당 명령어를 실행해주었다.

 

그러면 "Git LFS initialized." 라는 로그가 찍힌다.

 

2. 마지막 커밋 취소

파일 용량 때문에 마지막 커밋에 배포파일이 추가되지 않았다.

터미널에 `git reset HEAD^` 명령어를 입력하여 마지막 커밋을 취소해 주었다.

 

3. 용량이 큰 파일들을 Git LFS로 트래킹하도록 설정

터미널에 `git lfs track "파일경로"`를 입력하면, 해당 파일을 Git LFS로 트래킹하도록 설정할 수 있다.

나는 배포 파일과 용량이 큰 wav 파일들을 트래킹하도록 설정하였다.

참고로, wav파일은 bgm과 효과음 원본 파일이다.

 

cat .gitattributes 명령어를 실행하면 트래킹 대상 목록 확인도 가능하다.

 

4. 트래킹한 파일들을 스테이징하고 다시 커밋, push하기

 

늘 하던대로 git add와 git commit 명령어를 이용하여, 원하는 파일들을 스테이징하고 커밋해주면 된다.

 

커밋하기 전 Git LFS를 사용하여 스테이징된 파일 목록을 확인하고 싶다면 `git lsf ls-files` 명령어를 실행하면 된다.

 

그 다음, git push 명령어를 사용하여 원격 리포지토리에 다시 push 를 시도해 주었다.

그러자 정상적으로 push가 완료되었다.