Git LFS (Git Large File Storage) 사용법, 대용량 레포지토리 clone 받는 법

Git LFS란 ?

GitHub는 100MB 이상의 파일을 올릴 수 없다.

Git LFS는 대용량 파일을 다루기 위한 오픈소스 프로젝트이다. 

Git LFS는 대용량의 파일들을 Git 내부의 텍스트 포인터로 대체하고, 파일의 내용은 원격 서버에 저장하도록 한다.

Git Large File Storage

 

 

Git LFS 레포지토리 clone 오류?

LFS로 등록된 레포지토리를 그대로 clone 받으면

Git LFS 서버를 추적할 수 있는 텍스트 포인터만 저장되고, 원래의 코드들은 불러오지 않을 수 있다.

아래와 같은 과정으로 해결할 수 있다.

 

1. macOS 에서 git-lfs 설치하기

brew install git-lfs

 

2. Repository clone

git-lfs를  install 하기 전의  repo에는 lfs 가 적용되지 않는다.

이전에 받은 repository는 지우고 다시 git clone을 해주고, 해당 repository로 이동한다.

git clone "url"
cd 레포지토리명

 

3. Repository 에 git lfs 적용

git lfs install

해당 repository에서 git lfs를 다운로드 해준다.

** 만약, 이전에 해당 업로드 파일에 대한 git add 기록이 존재한다면 unstaging 해준다.

git rm -r --cached "*"

 

4. git lfs pull 을 통해 large file 풀어주기

git lfs pull

 git lfs pull 까지 해주면 이제 lfs 가 적용된 파일들이 잘 열릴 것이다. 

 

 

참고
https://git-lfs.com/
https://wooono.tistory.com/284
https://sanghyu.tistory.com/178