git lfs install
Git LFS 설치 및 사용 가이드
개요
Git Large File Storage (LFS)는 Git에서 대용량 파일을 효율적으로 관리하기 위한 확장 기능입니다. 일반적인 Git은 텍스트 기반의 소스 코드를 처리하는 데 최적화되어 있지만, 이미지, 동영상, 이진 파일과 같은 큰 파일을 다룰 경우 성능 저하와 저장소 크기 증가 문제가 발생합니다. Git LFS는 이러한 문제를 해결하기 위해 대용량 파일을 서버에 저장하고, 로컬에는 단순한 포인터 파일만 유지하는 방식으로 작동합니다. 본 문서에서는 Git LFS의 설치 및 기본 사용 방법을 상세히 안내합니다.
1. Git LFS 설치
1.1. 설치 전 준비
Git LFS는 별도의 패키지로 제공되며, Git과 별도로 설치해야 합니다. 설치 전에 시스템에 Git이 이미 설치되어 있는지 확인하세요.
1.1.1. 운영체제별 설치 방법
- Windows: Git LFS 공식 사이트에서 설치 파일을 다운로드 후 실행합니다.
- macOS: Homebrew를 사용하여
brew install git-lfs명령어로 설치합니다. - Linux: 패키지 관리자(예: APT, YUM) 또는 공식 릴리스에서 바이너리를 다운로드해 설치합니다.
1.1.2. 설치 확인
설치 후 터미널에 다음 명령어를 입력하여 버전을 확인합니다:
git lfs version
2. Git LFS 설정 및 초기화
2.1. [git lfs install](/doc/%EA%B8%B0%EC%88%A0/%EC%86%8C%ED%94%84%ED%8A%B8%EC%9B%A8%EC%96%B4/%EB%B2%84%EC%A0%84%EA%B4%80%EB%A6%AC/git%20lfs%20install) 명령어
Git LFS를 사용하려면 프로젝트 루트 디렉토리에서 다음 명령어를 실행해야 합니다:
git lfs install
2.1.1. 훅 기능 설명
- pre-commit: 커밋 전에 대용량 파일을 서버로 업로드합니다.
- post-checkout: 클론 후 대용량 파일을 다운로드합니다.
- post-merge: 병합 후 필요한 경우 파일을 갱신합니다.
2.2. 리포지토리 초기화
git lfs install은 현재 디렉토리에만 적용됩니다. 다른 프로젝트에서 사용하려면 해당 디렉토리에서 다시 실행해야 합니다.
3. 대용량 파일 추적 설정
3.1. 파일 유형 지정
Git LFS는 특정 확장자(예: .psd, .mp4)를 기준으로 파일을 관리합니다. 다음 명령어로 파일 유형을 추가합니다:
git lfs track "/*.psd"
.psd 파일을 Git LFS로 추적하도록 설정합니다.
3.1.1. 추적 목록 확인
추적된 파일 유형은 .gitattributes 파일에 저장됩니다. 이 파일을 열면 다음과 같은 내용이 포함되어 있습니다:
*.psd filter=lfs diff=lfs merge=lfs -text
3.2. 커밋 및 푸시
설정 후 일반적인 Git 명령어로 작업합니다:
git add large-file.psd
git commit -m "Add large file"
git push origin main
4. 사용 예시 및 주의사항
4.1. 대용량 파일 다운로드
클론 후 Git LFS가 자동으로 파일을 다운로드합니다. 수동으로 실행하려면:
git lfs fetch origin main
4.2. 일반적인 오류 및 해결 방법
- 오류:
git lfs install실패 - 원인: Git LFS가 설치되지 않았거나, 권한 문제.
- 해결: 설치 후 재실행 또는 관리자 권한으로 실행합니다.
- 오류: 파일이 제대로 업로드되지 않음
- 원인:
.gitattributes파일에 잘못된 규칙이 포함됨. - 해결:
[git lfs track](/doc/%EA%B8%B0%EC%88%A0/%EC%86%8C%ED%94%84%ED%8A%B8%EC%9B%A8%EC%96%B4/%EB%B2%84%EC%A0%84%EA%B4%80%EB%A6%AC/git%20lfs%20track)명령어로 재설정합니다.
5. 참고 자료
결론
Git LFS는 대용량 파일을 효율적으로 관리하는 데 필수적인 도구입니다. 설치 및 설정 과정은 간단하지만, 올바른 사용법을 숙지하면 저장소 크기와 성능 문제를 줄일 수 있습니다. 추가로 Git LFS의 고급 기능(예: 서버 호스팅, 보안 설정)에 대해 탐구하는 것도 권장됩니다.
이 문서는 AI 모델(qwen3-30b-a3b)에 의해 생성된 콘텐츠입니다.
주의사항: AI가 생성한 내용은 부정확하거나 편향된 정보를 포함할 수 있습니다. 중요한 결정을 내리기 전에 반드시 신뢰할 수 있는 출처를 통해 정보를 확인하시기 바랍니다.