Skip to main content

Git Large File Storage (Git 대용량 파일 저장소) 구성

Git LFS이(가) 설치되면 이를 리포지토리의 큰 파일과 연결해야 합니다.

Platform navigation

리포지토리에 있는 기존 파일 중 GitHub와 함께 사용하려는 파일이 있다면, 먼저 해당 파일을 리포지토리에서 제거한 다음 로컬에서 Git LFS에 추가해야 합니다. 자세한 내용은 리포지토리의 파일을 Git Large File Storage로 이동을(를) 참조하세요.

성공적으로 업로드되지 않은 참조된 Git LFS 파일이 있는 경우 오류 메시지가 표시됩니다. 자세한 내용은 Git 대용량 파일 스토리지 업로드 실패 해결을(를) 참조하세요.

참고

GitHub Enterprise Server에 큰 파일을 푸시하기 전에 엔터프라이즈에서 Git LFS이(가) 활성화되어 있는지 확인하세요. 자세한 내용은 엔터프라이즈용 Git Large File Storage 구성을(를) 참조하세요.

  1. 터미널터미널Git Bash를 엽니다.

  2. 현재 작업 디렉터리를 Git LFS와 함께 사용하려는 기존 리포지토리로 변경하세요.

  3. 리포지토리의 파일 형식을 Git LFS에 연결하려면 lfs에 자동으로 업로드할 파일 확장명 이름 앞에 git Git LFS track를 입력하세요.

    예를 들어 .psd 파일을 연결하려면 다음 명령을 입력합니다.

    $ git lfs track "*.psd"
    > Tracking "*.psd"
    

Git LFS와 연결하려는 모든 파일 형식은 git lfs track로 추가해야 합니다. 이 명령은 리포지토리의 .gitattributes 파일을 수정하고 큰 파일을 Git LFS와 연결합니다.

참고

로컬 .gitattributes 파일을 리포지토리에 커밋하는 것이 좋습니다.

Git LFS와 연결된 전역 .gitattributes 파일에 의존하면 다른 Git 프로젝트에 기여할 때 충돌이 발생할 수 있습니다.

  • 리포지토리에 .gitattributes 파일을 포함하면 포크 또는 새 클론을 만드는 사용자가 더 쉽게 공동 작업할 수 있습니다 Git LFS.
  • 리포지토리에 .gitattributes 파일을 포함하면 Git LFS 필요에 따라 ZIP 파일 및 tarball 보관 파일에 개체를 포함할 수 있습니다.
  1. 연결한 확장과 일치하는 파일을 리포지토리에 추가합니다.

    git add path/to/file.psd
    
  2. 파일을 커밋하고 GitHub에 푸시하세요:

    git commit -m "add file.psd"
    git push
    

    파일 업로드에 대한 몇 가지 진단 정보가 표시됩니다.

    > Sending file.psd
    > 44.74 MB / 81.04 MB  55.21 % 14s
    > 64.74 MB / 81.04 MB  79.21 % 3s
    

추가 참고 자료