github 대용량 파일 push 오류 해결
2024. 7. 1. 08:00ㆍ코딩 도구/오류 해결
반응형
오류 설명
- 오류 메시지: 파일 크기가 GitHub에서 허용하는 최대 파일 크기를 초과했기 때문에 푸시가 거부되었다.
- 파일 크기 한도: GitHub은 100MB 이상의 파일은 푸시할 수 없으며, 50MB 이상의 파일에 대해서는 경고를 표시한다.
문제 해결 방법
이 문제를 해결하기 위해 Git Large File Storage (Git LFS)를 사용한다.
Git LFS는 대용량 파일을 효율적으로 관리할 수 있도록 도와주는 도구이다.
해결 과정
- Git LFS 설치: 먼저 Git LFS를 설치해야 합니다. 터미널에 아래 명령어를 입력한다.
- 대용량 파일 추적 설정: Git LFS에 대용량 파일을 추적하도록 설정고, 오류 메시지에 나온 파일 경로를 사용한다.
- .gitattributes 파일 추가: Git LFS는 .gitattributes 파일을 생성하여 어떤 파일을 추적할지 기록한다. 이 파일을 Git에 추가한다.
- 변경 사항 커밋: 추적할 대용량 파일과 .gitattributes 파일을 커밋한다.
- 푸시: 이제 변경 사항을 원격 저장소에 푸시다.
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에 대용량 파일을 성공적으로 푸시할 수 있었다.
반응형
'코딩 도구 > 오류 해결' 카테고리의 다른 글
MySQL : SELECT 쿼리 결과의 1000개 행 제한을 푸는 방법 (2) | 2024.07.15 |
---|---|
Intellij IDEA: (스프링) 코드가 실행될 때 문제없이 작동하는데, 코드 편집기에서 빨간줄 오류 (1) | 2024.06.30 |