Git LFS로 대용량 파일 관리하기: 개발자를 위한 완벽 가이드

서론: 대용량 파일과 Git의 딜레마

Git은 소스 코드 관리를 위한 훌륭한 도구지만, 대용량 파일을 다룰 때는 본연의 한계를 드러냅니다. WordPress 사이트, 게임 개발 프로젝트, 디자인 작업 등 큰 바이너리 파일이 포함된 프로젝트를 관리해본 개발자라면 이러한 문제를 직접 경험해보셨을 것입니다.

큰 파일들이 Git 저장소에 직접 포함되면 저장소 크기가 기하급수적으로 증가하고, 클론 및 풀 작업 시간이 길어지며, 로컬 저장소가 불필요하게 무거워집니다. 이런 문제를 해결하기 위해 Git LFS(Large File Storage)가 등장했습니다.

Git LFS란 무엇인가?

Git LFS는 Git 확장 프로그램으로, 대용량 파일을 효율적으로 관리할 수 있게 해줍니다. 일반적인 Git 워크플로우를 유지하면서도, 대용량 파일을 Git 저장소가 아닌 별도의 서버에 저장하는 방식으로 작동합니다.

핵심 개념은 간단합니다. Git LFS는 실제 파일 대신 해당 파일을 가리키는 포인터를 Git 저장소에 저장합니다. 이 포인터는 매우 작은 텍스트 파일로, 실제 콘텐츠는 LFS 서버에 저장됩니다. 이렇게 하면 Git 저장소 자체는 가볍게 유지하면서도 대용량 파일을 효과적으로 버전 관리할 수 있습니다.

Git LFS 설치 및 설정

Git LFS를 시작하는 것은 매우 간단합니다. 주요 운영 체제에서 다음과 같이 설치할 수 있습니다:

리눅스(Ubuntu/Debian)

sudo apt-get install git-lfs

macOS (Homebrew 사용)

brew install git-lfs

Windows

Git for Windows에 포함되어 있거나, Git LFS 웹사이트에서 직접 다운로드할 수 있습니다.

설치 후에는 시스템 전체에 Git LFS를 초기화해야 합니다:

git lfs install

이 명령은 .gitconfig 파일에 필요한 설정을 추가합니다.

프로젝트에 Git LFS 적용하기

설치 후에는 프로젝트에 Git LFS를 적용해야 합니다. 이는 다음 단계로 이루어집니다:

프로젝트 디렉토리로 이동:

cd your-repository

추적할 파일 유형 지정:

git lfs track "*.psd" "*.iso" "*.mp4"

이 명령은 지정한 확장자(예: psd, iso, mp4)를 가진 모든 파일을 Git LFS로 관리하도록 설정합니다. 특정 파일 패턴이나 경로도 지정할 수 있습니다.

.gitattributes 파일 커밋:

git add .gitattributes
git commit -m "Configure Git LFS tracking"

.gitattributes 파일에는 Git LFS로 추적할 파일 유형에 대한 정보가 저장됩니다. 이 파일을 커밋하고 푸시해야 팀의 다른 구성원도 동일한 LFS 설정을 사용할 수 있습니다.

이제 대용량 파일을 정상적으로 추가하고 커밋할 수 있습니다:

git add large-file.psd
git commit -m "Add large design file"
git push origin main

WordPress 사이트에 Git LFS 적용하기

WordPress와 같은 CMS 기반 웹사이트를 Git으로 관리할 때 Git LFS는 특히 유용합니다. 이미지, 동영상, 문서 등 수많은 미디어 파일을 효율적으로 관리할 수 있기 때문입니다.

WordPress 프로젝트에 Git LFS를 적용하는 전형적인 예는 다음과 같습니다:

미디어 파일 추적 설정:

git lfs track "wp-content/uploads/**/*.jpg"
git lfs track "wp-content/uploads/**/*.png"
git lfs track "wp-content/uploads/**/*.gif"
git lfs track "wp-content/uploads/**/*.pdf"
git lfs track "wp-content/uploads/**/*.mp4"

플러그인과 테마의 ZIP 파일도 추적할 수 있습니다:

git lfs track "wp-content/plugins/**/*.zip"
git lfs track "wp-content/themes/**/*.zip"

.gitattributes 파일을 커밋하고 WordPress 파일을 추가합니다:

git add .gitattributes
git commit -m "Configure Git LFS for WordPress media"
git add .
git commit -m "Add WordPress site files"
git push origin main

Git LFS의 고급 기능

마이그레이션: 기존 저장소를 LFS로 변환

이미 대용량 파일이 포함된 Git 저장소가 있다면, 이를 Git LFS로 마이그레이션할 수 있습니다:

git lfs migrate import --include="*.psd,*.iso" --everything

이 명령은 지정된 파일 유형(여기서는 psd와 iso)에 대한 모든 이전 버전을 Git LFS 형식으로 변환합니다. --everything 플래그는 모든 브랜치와 태그에 적용됩니다.

특정 파일 그룹에 대한 맞춤 설정

특정 디렉토리나 파일 그룹에 대해 다른 LFS 설정을 적용할 수 있습니다:

git lfs track "large-files/**/*" --lockable

--lockable 플래그는 해당 파일들이 한 번에 한 사용자만 편집할 수 있도록 잠금 기능을 활성화합니다. 이는 바이너리 파일의 병합 충돌을 방지하는 데 유용합니다.

Git LFS 사용 시 주의사항

1. 저장소 크기 제한

많은 Git 호스팅 서비스(GitHub, GitLab 등)는 LFS 저장소 크기나 대역폭에 제한을 두고 있습니다. 특히 무료 플랜을 사용하는 경우 이러한 제한에 주의해야 합니다.

2. 클론 시간 최적화

저장소를 처음 클론할 때 LFS 파일을 제외하여 시간을 절약할 수 있습니다:

GIT_LFS_SKIP_SMUDGE=1 git clone repository-url

이후 필요한 LFS 파일만 선택적으로 가져올 수 있습니다:

git lfs pull --include="path/to/needed/files/*"

3. .gitignore와의 조합

효율적인 워크플로우를 위해 .gitignore와 Git LFS를 함께 사용하는 전략을 고려하세요. 예를 들어, 캐시 파일이나 임시 대용량 파일은 .gitignore에 추가하고, 버전 관리가 필요한 대용량 에셋만 Git LFS로 관리하는 것이 좋습니다.

실제 워크플로우 예시: 웹 프로젝트

실제 웹 프로젝트에서 Git LFS를 사용하는 예시 워크플로우를 살펴보겠습니다:

프로젝트 초기 설정:

mkdir my-web-project
cd my-web-project
git init
git lfs install

추적할 대용량 파일 유형 설정:

git lfs track "*.jpg" "*.png" "*.mp4" "*.pdf"
git add .gitattributes
git commit -m "Initialize Git LFS tracking"

개발 작업 진행:

# 소스 코드 작업
vim index.html
git add index.html
git commit -m "Add homepage structure"

# 대용량 이미지 파일 추가
cp ~/designs/banner.jpg assets/images/
git add assets/images/banner.jpg
git commit -m "Add banner image"

원격 저장소에 푸시:

git remote add origin git@github.com:username/my-web-project.git
git push -u origin main

Git LFS는 자동으로 대용량 파일을 LFS 서버에 업로드하고, Git 저장소에는 포인터만 저장합니다.

결론: 대용량 파일의 효율적 관리

Git LFS는 대용량 파일을 포함한 프로젝트를 효율적으로 관리할 수 있는 강력한 도구입니다. 웹사이트, 게임 개발, 디자인 프로젝트 등 다양한 분야에서 Git의 장점을 그대로 유지하면서 대용량 파일 관리의 문제를 해결해줍니다.

이 글에서 소개한 기본 개념과 명령어를 토대로, 실제 프로젝트에 Git LFS를 적용해 보시기 바랍니다. 프로젝트의 성격과 팀의 요구사항에 맞게 Git LFS 설정을 최적화하면, 더욱 효율적인 버전 관리와 협업이 가능해질 것입니다.

대용량 파일 관리의 어려움은 모든 개발자가 직면하는 문제입니다. Git LFS를 통해 이러한 문제를 해결함으로써, 우리는 더 나은 개발 경험과 효율적인 협업을 실현할 수 있습니다.