대용량 파일 업로드(LFS) 사용

Classic/VPC 환경에서 이용 가능합니다.

Git 리포지토리에 업로드할 수 있는 파일 용량은 최대 500 MB로 제한되지만, Git LFS(Large File System)를 활용하면 Git 리포지토리에서 대용량 파일(파일 당 최대 5 GB)의 버전 관리를 수행할 수 있습니다. Git LFS는 대용량 파일에 대한 메타데이터(metadata)만 리포지토리에 커밋하고 실제 파일 내용은 별도의 원격 저장소에 저장하는 방식으로 작동합니다.

Git LFS 사용을 위한 요구 사항

Git LFS를 이용하려면 Git 클라이언트와 Git LFS를 로컬 PC에 설치해 주십시오.

• GIT 공식 사이트에서 Git 클라이언트 설치 파일을 다운로드해 설치하고 자세한 사용법을 확인해 주십시오.
• GIT LFS 공식 사이트에서 Git LFS 설치 파일을 다운로드해 설치하고 자세한 사용법을 확인해 주십시오.
• Git LFS는 HTTPS 연결만을 지원하며, SSH 연결은 지원하지 않습니다.

대용량 파일 업로드

Git LFS를 이용해 대용량 파일을 업로드하는 방법은 다음과 같습니다.

이 사용 가이드에서는 로컬 리포지토리에서 Git LFS를 초기화한 후 특정 파일에 대해 트래킹을 설정하고 원격 리포지토리로 업로드(push)하는 방법을 간략한 예제로 설명합니다. Git LFS 사용 방법에 대한 자세한 내용은 GIT LFS 공식 사이트를 참고해 주십시오.
:::

1. 로컬 PC에서 Git Client를 실행한 후 작업할 리포지토리 경로로 이동해 주십시오.
2. Git LFS 초기화를 수행해 주십시오.

   $ git lfs install
   
   Git LFS initialized.
   

3. 업로드할 대용량 파일에 트래킹을 설정한 후 .gitattributes 파일을 커밋 목록에 추가해 주십시오.
   • 와일드카드(*)를 이용해 복수 파일을 지정할 수도 있습니다.
   • .gitattributes 파일에는 파일에 대한 트래킹 내역이 기록됩니다.

   $ git lfs track "*.psd"
   Tracking "*.psd"
   
   $ git add .gitattributes
   

4. 업로드할 대용량 파일을 커밋한 후 리모트 리포지토리로 업로드(push)해 주십시오.

   $ git add sample.psd
   
   $ git commit -m "Added design file"
   
   $ git push origin master
   

파일 잠금

Git LFS의 파일 잠금(lock) 기능을 이용하면 특정 계정을 사용하는 경우에만 잠긴 파일을 수정하거나 업로드할 수 있도록 설정할 수 있습니다.

파일 잠금 기능을 설정하는 방법은 다음과 같습니다.

$ git config lfs.{Git URL}/info/lfs.locksverify true

파일 잠금 사용 예

파일 잠금을 활성화한 후에는 파일 잠금 기능을 설정한 서브 계정에서만 파일을 업로드하거나 파일의 잠금을 해제할 수 있습니다.

• '서브 계정 1'에서 잠금 설정

  $ git lfs lock "test.txt"
  Locked test.txt
  
  $git lfs locks
  test.txt {sub_account_name} ID:15
  

• '서브 계정 2'에서 파일 업로드(오류 발생)

  $ git add test.txt
  
  $ git commit -m "Modify file"
  
  $ git push origin master
  Unable to push locked files:
  * test.txt - {sub_account_name} (refs: master)
  ERROR: Cannot update locked files.
  

파일 잠금 설정 해제 예

• '서브 계정 1'에서 잠금 설정 해제(해제 성공)

  $ git lfs unlock test.txt
  Unlocked test.txt
  

• '서브 계정 2'에서 잠금 설정 해제(오류 발생)

  $ git lfs unlock test.txt
  test.txt is locked {Sub Account1}