Skip to main content

Git Large File Storage 구성

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

Platform navigation

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

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

Note

GitHub Enterprise Server에 큰 파일을 푸시하기 전에 엔터프라이즈에서 Git LFS를 사용하도록 설정했는지 확인합니다. 자세한 내용은 엔터프라이즈에서 Git Large File Storage 구성을(를) 참조하세요.

  1. Terminal(터미널)Terminal(터미널)Git Bash를 엽니다.

  2. 현재 작업 디렉터리를 Git LFS에서 사용하려는 기존 리포지토리로 변경합니다.

  3. 리포지토리의 파일 형식을 Git LFS와(과) 연결하려면 git lfs track 다음에 Git LFS에 자동으로 업로드할 파일 확장명 이름을 입력합니다.

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

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

    Git LFS와(과) 연결하려는 모든 파일 유형은 git lfs track으로 추가해야 합니다. 이 명령은 리포지토리의 .gitattributes 파일을 수정하고 대용량 파일을 Git LFS에 연결합니다.

    Note

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

    • Git LFS와(과) 연결된 전역 .gitattributes 파일을 사용하면 다른 Git 프로젝트에 기여할 때 충돌이 발생할 수 있습니다.
    • 리포지토리에 .gitattributes 파일을 포함하면 포크 또는 새 클론을 만드는 사용자가 Git LFS을(를) 사용하여 보다 쉽게 공동 작업할 수 있습니다.
    • 리포지토리에 .gitattributes 파일을 포함하면 Git LFS 개체를 ZIP 파일 및 tarball 보관 파일에 선택적으로 포함할 수 있습니다.
  4. 연결한 확장과 일치하는 파일을 리포지토리에 추가합니다.

    git add path/to/file.psd
    
  5. 파일을 커밋하고 GitHub Enterprise Server에 푸시합니다.

    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
    

추가 참고 자료