오늘의 오류

[git에러] this exceeds GitHub's file size limit of 100.00 MB 에러 (GH001: Large files detected. You may want to try Git Large File Storage)

애해 2023. 12. 31. 13:31
728x90

# 발생 상황

프로젝트를 GitHub에 올리려는 과정에서 발생

 

# 발생 원인

GitHub에서 레포지토리의 용량이 클 경우 전체 인프라에 영향을 미치므로 파일 크기 제한을 100MB로 걸어놓음 

 

# 해결 방안

Git LFS(Git Large File Storage)를 사용 

 

1. Git LFS를 프로젝트 루트경로에서 설치한다. 

$ git lfs install

 

 

2. Git LFS에 저장할 파일들을 추가한다. 

git lfs track 명령어로 파일을 추가하면 자동으로 .attributes 파일이 생성된다.

$ git lfs track 경로/파일명
// 예를 들면 git lfs track documents/test.zip

 

 

3. GitHub에 원격 레포지토리에 push한다. 

$ git push origin <원격브랜치명>

 

 

💢 하지만! 오류가 발생하는 경우가 있다

한번에 오류없이 push가 됐으면 좋았을텐데.... pure한 git history가 아니면 오류난다. 

git lfs에 올리려는 파일이 이전 커밋에 포함되어 있는 경우 해당 파일을 commit한 이력을 삭제한 후 push 해야한다.

git reset --mixed “HEAD^” 	// 1개의 이력 삭제(^사용할 경우 “” 써줘야 함)
git reset --mixed “HEAD^^”  // 2개의 이력 삭제
git reset --mixed HEAD~5 	// 5개의 이력 삭제
git reset {commit의 hash값}  // 특정 커밋 이력 삭제

 

반응형