github 대용량 파일 push 오류 해결

2024. 7. 1. 08:00코딩 도구/오류 해결

반응형

오류 설명

  • 오류 메시지: 파일 크기가 GitHub에서 허용하는 최대 파일 크기를 초과했기 때문에 푸시가 거부되었다.
  • 파일 크기 한도: GitHub은 100MB 이상의 파일은 푸시할 수 없으며, 50MB 이상의 파일에 대해서는 경고를 표시한다.

문제 해결 방법

이 문제를 해결하기 위해 Git Large File Storage (Git LFS)를 사용한다.

Git LFS는 대용량 파일을 효율적으로 관리할 수 있도록 도와주는 도구이다. 

 

해결 과정

  1. Git LFS 설치: 먼저 Git LFS를 설치해야 합니다. 터미널에 아래 명령어를 입력한다. 
  2. 대용량 파일 추적 설정: Git LFS에 대용량 파일을 추적하도록 설정고, 오류 메시지에 나온 파일 경로를 사용한다.
  3. .gitattributes 파일 추가: Git LFS는 .gitattributes 파일을 생성하여 어떤 파일을 추적할지 기록한다. 이 파일을 Git에 추가한다.
  4. 변경 사항 커밋: 추적할 대용량 파일과 .gitattributes 파일을 커밋한다.
  5. 푸시: 이제 변경 사항을 원격 저장소에 푸시다.
git lfs install
git lfs track "gltfs/bookcase2/textures/Shelf_2_baseColor.png" 
git lfs track "gltfs/x-tree/scene.bin"
git add .gitattributes
git add gltfs/bookcase2/textures/Shelf_2_baseColor.png 
git add gltfs/x-tree/scene.bin 
git commit -m "Track large files with Git LFS"
git push origin main

전체 명령어 요약

git lfs install
git lfs track "gltfs/bookcase2/textures/Shelf_2_baseColor.png"
git lfs track "gltfs/x-tree/scene.bin"
git add .gitattributes
git add gltfs/bookcase2/textures/Shelf_2_baseColor.png
git add gltfs/x-tree/scene.bin
git commit -m "Track large files with Git LFS"
git push origin main

이 과정을 통해 GitHub에 대용량 파일을 성공적으로 푸시할 수 있었다.

반응형