Git · GitHub 기초집LESSON 20

Git LFS와 대용량 파일 관리

난이도입문 → 초급

예상 시간30분

선수지식이전 강의

20강. Git LFS와 대용량 파일 관리

1. 이번 강의에서 해결할 문제

영상, PSD, 빌드 압축 파일을 일반 Git에 반복 커밋하면 저장소가 영구적으로 커지고 GitHub의 파일 제한에 걸릴 수 있습니다. 필요한 원본만 LFS로 관리하고 생성물은 제외합니다.

2. 학습 목표

3. 핵심 개념

Git LFS는 저장소에는 작은 포인터 파일을 두고 실제 대용량 객체는 별도 저장소에 보관합니다. GitHub의 저장 용량과 대역폭 할당량이 적용되며, GitHub Pages는 LFS 객체를 사이트 파일 공급 방식으로 사용할 수 없습니다. 빌드 결과는 보통 .gitignore가 우선입니다.

4. 단계별 명령어와 예시

추적 예시: assets/source/*.psd

PowerShell
git lfs install
git lfs track "assets/source/*.psd"
Get-Content .gitattributes
git add .gitattributes
git add assets/source/example.psd
git lfs ls-files
git commit -m "chore: track design sources with Git LFS"
git push

이미 일반 Git 이력에 들어간 큰 파일을 옮기는 작업은 과거 커밋을 다시 쓰며 협업자에게 영향을 줍니다. 백업과 합의 없이 git lfs migrate를 실행하지 말고 GitHub 공식 “Moving a file in your repository to Git LFS” 절차를 따릅니다.

5. 명령어가 동작하는 이유

git lfs track은 .gitattributes에 필터 규칙을 추가합니다. 이후 add할 때 LFS 클라이언트가 실제 파일을 객체 저장소로 보내고 Git index에는 포인터 내용을 넣습니다. 규칙도 협업자에게 필요하므로 함께 커밋합니다.

6. 자주 하는 실수와 안전한 해결법

7. 직접 실습

8. 이해 점검 질문 3개

9. 핵심 요약

MINI QUIZ