GitHub 에 100mb 이상 파일 올리기 : 클리앙

오래간만에 작업중인 유니티 프로젝트를 새로운 레포에 올리고있는데,

용량 제한 에러가 나오더군요.

잘못된 형식의 이미지 링크입니다.

저처럼 유니티 + 파이어 베이스로 개발을 하시는 분들은 아마 GitHub 에 백업을 하시는 경우 겪으실 문제일 것 같습니다.

GitHub 는 정책상 단일 파일이 100MB이상을 올릴수 없기 때문에 나오는 에러인데요.

이에 대한 해결 수단으로 lfs 익스텐션이 있습니다.

위사이트에서 파일을 받아 설치를 하고

git lfs track " 파일.확장자"

git add .gitattributes

으로 설정을 하고 커밋 + 푸시를 진행하면 분할? 과정등을 거치면서 깃허브에 파일을 올릴 수 있습니다.

조금 번거롭긴 하지만 프로젝트를 올릴 수 있어서 다행이기도 합니다.

하지만 저처럼 기존의 파일을 커밋후 푸쉬를 시도한적이 있으면 로그가 남아서 lfs 를 써도 변환 과정후에 푸쉬가

실패하는 메시지를 다시 만나볼 수 있습니다.

이경우엔

bfg 클리너라는 것으로 해당 로그를 삭제한 후에 진행을 하셔야합니다.

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

이런식으로 100메가 이상의 파일을 올리는 것에 대한 로그를 삭제하라? 뭐 이런걸 진행하는 듯 합니다.

다만, 이경우에도 에러가 나는 경우가 있는데, 정확하게 에러는 아니고 해당 로그를 찾지 못하는 경우가 있는듯 합니다.

이때는

git repack && git gc

명령어로 정리를 해주고 다시 위의 bfg 를 수행해주면 진행이 잘됩니다.

로그가 정리된뒤에 다시 푸시를 진행해보시면 lfs 가 잘 작동하면서 깃헙에 파일이 잘 올라간 것을 볼 수있습니다.

잘못된 형식의 이미지 링크입니다.

해당 과정을 보기 쉽게 동영상으로 제작해뒀습니다.

개인블로그에 정리한 내용도 올려봅니다.

T1 Canna님이 리플로 달아주셔서 추가내용을 적습니다.

Git-Lfs 는 완전 무료는 아니고 무료 계정의 경우 1달에 1GB의 대역폭을 무료로 제공하고 그 이후는 유료로 사용이 가능하다고하네요.

자세한 내용은 아래 링크를 참조하시면 좋을 것 같습니다.

Account -> Setting -> Biiling & Plan 에서 현재 남아있는 용량과 추가 구매 용량등을 확인할 수 있습니다.

잘못된 형식의 이미지 링크입니다.

위 페이지에서 나온 내용으로는 50기가 대역폭 + 스토리지 용량을 5$ 단위로 구매가 가능 한것 같네요.

구매한 달에만 사용이 가능하고 사용하지 않은 용량은 이월은 불가능 하다고 하네요.

이상으로 간략하게 깃허브에 100mb이상의 파일을 올리는 팁에 대해서 적어봤습니다.

저도 전부터 검색해서 사용하기도 하고 자주 사용했는데, 해당 문제를 겪을때마다 깜빡 깜빡해서

겸사 겸사 정리하고 영상도 찍어봤네요.

혹시 필요하신분들한텐 도움 되시길 바랍니다.

팁과강좌