[문제해결] GitHub - git lfs (100mb 이상 업로드)
프로젝트를 push하는데 이런 오류가 떴다
처음으로 100mb를 넘어봐서 그런지 당황스러웠다..
오류 해석
이 오류 메시지는 GitHub의 파일 크기 제한을 초과하여 파일을 푸시하려고 할 때 발생하는 문제입니다. GitHub은 기본적으로 100MB보다 큰 파일의 푸시를 허용하지 않습니다. 여기서 src/assets/video/bg.mp4 파일의 크기가 101.58MB로 제한을 초과하게 됩니다.
이러한 큰 파일을 GitHub에 푸시하려면 Git Large File Storage (LFS)를 사용하는 것이 좋습니다. Git LFS는 대용량 파일을 관리하고 저장하는 데 도움이 되는 도구입니다. LFS를 사용하여 파일을 업로드하면 이 파일들은 Git 저장소에서 분리되어 별도의 서버에 저장되며, Git 저장소에는 해당 파일들에 대한 참조만 포함됩니다.
해결
- git lfs version 를 쳐서 이미 설치가 되어있는지 확인
- brew install git-lfs
이 명령어는 Homebrew를 사용하여 Git LFS를 설치합니다. Homebrew가 설치되어 있지 않다면, 먼저 Homebrew를 설치한 후에 위의 명령어를 실행해야 합니다.
설치가 완료되면 다시 git lfs install 명령어를 실행해 보세요. Git LFS가 정상적으로 설치되었다면 Git LFS 명령어를 사용할 수 있게 될 것입니다.
- git lfs install
Updated Git hooks.
Git LFS initialized.
라고 나왔다.
Git LFS가 정상적으로 설치되었고 초기화되었습니다. 이제 Git LFS를 사용하여 대용량 파일을 관리하고 업로드할 수 있을 것입니다.
- git lfs track "경로"
나는 "src/assets/video/bg.mp4" 에 있는 파일이 100mb가 넘어서 경로 설정했다.
- git add .
커밋: 변경 내용을 커밋합니다.
- git commit -m "Add large file using LFS"
푸시: 변경 내용을 원격 저장소로 푸시합니다.
- git push origin main
