💡 Github에 대용량 데이터를 올리기 위한 방법을 알아보자!!

1. 🙋🏻개요

나의 개인 Repository에 대용량 데이터를 Upload 하기 위해서 commit - push를 진행하였는데, 위와 같은 오류가 발생하였다..(20분이나 걸렸는데..ㅎ)
아마 오류를 읽어봤을 때, 한번에 올릴 수 있는 데이터의 크기를 넘어가서 발생하는 거 같았다. ( 나중에 찾아보니 한번에 올릴 수 있는 데이터의 크기는 최대 100MB까지 가능한 거 같다.)

2. ✨해결책

1. git-lfs 설치

# Mac HomeBrew 기준
brew install git-lfs

우선 대용량 데이터를 올리기 위해서는 git-lfs가 필요하기 때문에 설치를 진행하였다.
나는 터미널에서 바로 설치하였지만, 직접 사이트에 접속해서 할 수도 있다고 한다.

2. 전송할 대용량 파일을 lfs로 설정하고 보내기

// 1. lfs로 관리할 대용량 파일 설정해주기
// (주의 사항, 현재 파일 안의 파일 내부에 대용량 데이터가 속해있으면 경로까지 입력 필요)
$ git lfs track 파일명
// git lfs track "cv_models/FRcnn/output/model_final.pth"


// 2. 변경된 내용 스테이징
$ git add .gitattributes
$ git add .


// 3. 커밋
$ git commit -m "커밋 메세지"

// 4. 푸시
$ git push origin main

위 방식을 따라서 진행하면 대용량 데이터 파일이 잘 업로드 된다.
첫번째 방식에서 주의해야 할 점은 내가 올리려는 파일 내부에 대용량 파일이 있으면, 직접적인 경로를 넣어줘야 한다는 점이다!!
추가적으로 lfs 파일을 제외한 다른 여러 파일도 함께 commit & push가 가능하다.

3. 👍🏻결과

위와 같이 100MB가 넘는 대용량 파일이 잘 업로드 된것을 확인할 수 있었다. (이 파일의 크기는 무려 320MB 였다고 한다.. ㅎ)