Git LFS, 대용량 파일 관리의 양날의 검: 실질적 사용 후기와 장단점 분석

핵심 기술

이 글은 Git의 기본 제약을 넘어서는 대용량 파일(50.96MB MP4)을 효율적으로 관리하기 위해 Git LFS(Large File Storage)를 도입하고 사용하는 과정을 상세히 설명합니다. Git LFS는 대용량 바이너리 파일을 Git 저장소 외부의 별도 스토리지에 저장하고, Git 레포지토리에는 해당 파일의 포인터만 남겨 저장소의 경량성을 유지하는 솔루션입니다.

기술적 세부사항

• Git의 대용량 파일 한계: GitHub는 50MB 이상의 파일 푸시를 경고하며, 이는 저장소 크기 증가 및 성능 저하를 야기합니다. 원문 작성자는 50.96MB 파일을 푸시했으나, 이는 임시방편일 뿐 지속 가능한 해결책이 아님을 인지했습니다.
• Git LFS 설치: Git LFS는 Git 자체에 포함된 기능이 아니므로 별도의 설치가 필요합니다. Ubuntu 환경에서의 curl -s | sudo bash 또는 sudo apt update && sudo apt install git-lfs를 통한 설치 방법을 소개합니다.
• Git LFS 설정 및 사용:
  • git lfs track "*.mp4" 명령어로 .gitattributes 파일을 생성하거나 수정하여 특정 확장자(예: MP4)의 파일을 LFS로 관리하도록 설정합니다.
  • .gitattributes 파일 변경 사항을 커밋합니다: git add .gitattributes 및 git commit -m "Configure Git LFS for MP4 files".
  • 일반적인 git add 및 git commit 과정을 통해 LFS 파일이 관리됩니다: git add public/hero.mp4 및 git commit -m "Add hero video".
  • 푸시 시, LFS 객체는 별도로 업로드되고 (예: Uploading LFS objects: 100% (1/1), 53 MB), 메인 Git 푸시는 포인터 파일(약 527 bytes)만 전송합니다.
• Git LFS 작동 방식: LFS는 대용량 파일 자체를 Git 히스토리에서 분리하여 별도의 LFS 스토리지에 저장하고, Git에는 파일의 OID, 버전, 크기 정보 등을 담은 텍스트 포인터만 기록합니다.
• Git LFS 사용 시 고려사항 (단점):
  • 스토리지 및 대역폭 제한: GitHub는 무료 LFS 스토리지 용량을 1GB로 제한합니다.
  • 협업 문제: 팀원 모두가 Git LFS를 설치해야 하며, 미설치 시 발생하는 문제를 야기할 수 있습니다.
  • 클론 속도 저하: 추가적인 LFS 객체 다운로드로 인해 저장소 클론 속도가 느려질 수 있습니다.
  • 버전 관리의 한계: LFS는 파일의 전체 히스토리가 아닌 단일 버전을 관리하는 데 가깝습니다.
  • 백업 복잡성: 중요한 애셋이 별도 스토리지 시스템에 분산되어 백업 관리가 복잡해집니다.
• 대안 모색: 클라우드 스토리지(S3, GCS) 사용, 파일 압축 또는 별도 호스팅, 애셋 파이프라인 재설계 등을 대안으로 고려합니다.

개발 임팩트

Git LFS는 Git 저장소를 깨끗하게 유지하면서 대용량 바이너리 파일의 버전 관리를 가능하게 하여, Git의 기본적인 한계를 극복하는 데 도움을 줍니다. 이는 특히 게임 개발, 머신러닝 모델 관리, 미디어 파일 관리 등 대용량 파일이 필수적인 프로젝트에서 개발 워크플로우의 효율성을 높일 수 있습니다. 하지만 장기적으로는 애셋 관리 전략을 신중하게 수립하고, Git LFS 외의 전문적인 솔루션을 고려하는 것이 좋다는 교훈을 제공합니다.

커뮤니티 반응

원문에서는 Git LFS 사용이 즉각적인 문제를 해결했지만, 근본적인 해결책보다는 '문제를 뒤로 미룬 것' 같다는 개인적인 소회를 밝히고 있습니다. 이는 대용량 파일 관리에 대한 개발자들의 일반적인 고민과 유사하며, Git LFS의 편리함 뒤에 숨겨진 복잡성과 장기적인 관리 부담에 대한 커뮤니티의 공감을 이끌어낼 수 있는 내용입니다.