Git-LFS github에 대용량 파일 push하기

최근 진행했던 프로젝트를 깃허브에 커밋하는 과정에 문제가 발생했다.

 

> remote: error: File "파일명" is 288.83 MB; this exceeds Git Hub's file size limit of 100.00MB

 

즉, 100MB를 초과하는 파일은 업로드가 되지 않는다는 것이다.

이를 해결하기 위한 방법을 기록하고자 한다.

 

1. Git Large File Storage 다운로드

Git Large File Storage(이하 glfs)는 대용량 파일을 분할하여 커밋할 수 있게끔 도와주는 아주 고마운 프로그램이다.

https://git-lfs.github.com/

Git Large File Storage

위 링크로 들어가 다운로드 후, install을 진행하면 된다.

install 과정 또한 복잡하지 않아 초보자인 나도 금방 설치했다.

 

2. GLFS 사용하여 PUSH 하기

깃허브에 커밋하는 방법은 여러 가지가 있다.

대용량 파일을 커밋하기 위해서는 Windows의 명령 프롬프트에서 진행했다. (Mac은 나중에 다뤄보도록 하겠다.)

1) clone 되어 있는 파일 경로로 이동한다.

프로젝트 리포지토리와 클론되어 있는 경로이다.

2) git lfs install

정상적으로 완료되면 다음과 같은 문장이 뜬다.

3) git lfs track "파일명.확장자"

정상적으로 작동한다면 "Tracking 파일명"과 같은 문장이 뜰 것이다.

블로그를 쓰기 전에 추적 설정을 했기에 'already supported'라고 출력된다.

 

4) git add/commit/push

github에 추가하기 위한 명령어 3종 세트다.

> git add .

> git commit -m "Large files included"

> git push

위의 과정대로 커밋하도록 하자.

정상적으로 push가 되고 있는 화면이다.

> Uploading LFS objects: 0% (0/2)

대용량 파일을 2개 업로드했고, 다소 기다려야 완료된다.

 

 

한 번에 성공했다, 하지만 lfs를 사용하기 전 대용량 파일을 업로드하려고 했던 log가 남아있다면 에러가 걸릴 수도 있다.

이런 상황일 때는 모든 add/commit log를 깔끔하게 지워주면 작동한다고 한다.