[Git] 100MB이상 커밋하기 Git-LFS

문제 발생

Github로 수정 내용을 저장소에 올리는 과정에서 특정 파일의 크기가 100MB가 넘어가면 Git에서 commit을 reject한다. 이를 해결 하기 위해선 100MB가 넘어가는 파일을 커밋하는 과정에서 제외하거나 Git LFS를 사용해야 한다.

Git LFS

LFS로 관리 받는 파일은 실제 리포지토리가 아닌 다른 저장소로 옮겨지고 실제 리포지토리는 메타데이터를 통해 다른 저장소에 있는 파일을 가리키는 방식으로 대용량 파일을 관리한다.

관리하는 파일 하나당 최대 크기가 있다. 해당 크기는 사용하는 GitHub Product에 따라 다르다.

Product	최대 파일 크기
GitHub Free	2GB
GitHub Pro	2GB
GitHub Team	4GB
GitHub Enterprise Cloud	5GB

사용법

1. 관리파일 설정

$ git lfs install
$ git lfs track "파일명"
$ git lfs track "*.png"

lfs를 다운 받고 추적하려는 파일을 설정한다.

2. .gitattribute 파일 커밋

$ git add .gitattribute
$ git commit -m "Add gitattribute"
$ git push -u origin main

파일을 track하면 .gitattribute라는 파일이 생성된다. 이 또한 커밋을 해줘야한다.

https://oneseat.tistory.com/ https://github.com/git-lfs/git-lfs https://docs.github.com/ko/repositories/working-with-files/managing-large-files/about-git-large-file-storage