본 문서에서는 Bitbucket 사용에 대한 제약 사항 및 가이드를 제공합니다.

개요

Bitbucket은 클라우드 기반 코드 저장소 관리 서비스입니다. 로컬 설치형 서비스 등에서는 관리적인 문제, 엔지니어링 실수에 의한 장애, 주기적인 백업의 필요성 등 개발 이외에 발생할 수 있는 이슈들이 발생할 수 있습니다. 따라서 클라우드 기반 서비스를 도입하여 개발에만 최대한 집중할 수 있도록 하였습니다.

클라우드 기반 서비스의 단점이라고 할 수 있는 것은, 제약조건이 있다는 점입니다. 따라서 해당 내용을 숙지하여 효율적인 사용을 하도록 해야겠습니다.

제약사항

단일 저장소 최대 크기 제한

• 2GB 초과시 → 알림 제공
• 4GB 초과시 → 푸쉬 불가
• 10GB 초과시 → 모든 기능 불가

단일 Push 당 최대 용량 제한

• 3.5GB 이하 가능

아카이브 다운로드 제한

• 2G 이하

시간당 다운로드 요청 건수

• 5000 건 이하

대용량 파일 사용 방안 : LFS

LFS를 설치하고, 특정 확장자를 등록하는 것으로 사용할 수 있음

LFS 사용 가이드

설치

git lfs install

설치하면 .gitconfig 파일이 홈디렉토리 하위에 생성되어 모든 저장소에 적용됨

대용량 파일 트래킹

다음 명령어로 트래킹 할 수 있습니다.

git lfs track '<pattern>'

pattern 예시

• " path/to/some/folders/*" 와 같은 폴더 경로
• 특정 파일 이름 또는 파일 형식(예: bckgrnd.bin , " .psd" 또는 " .* "). 쉘이 확장되지 않도록 하려면 와일드카드 주위에 따옴표를 사용하는 것이 중요

여러 패턴을 추가할 수 있습니다. 추적 중인 모든 패턴을 보려면 인수 없이 git lfs track 명령을 사용 하십시오. 패턴은 리포지토리의 .gitattributes 파일에 추가됩니다.

트래킹 내역 푸쉬

변경 사항을 .gitattributes 에 커밋하고 푸시합니다 .

git add .gitattributes
git commit -m "add Git LFS to the repo"
git push origin main

이제 부터는 일반적인 방법으로 커밋과 푸쉬를 진행할 수 있습니다.

트래킹 해제

git lfs untrack <file>
(또는 .gitattributes에서 수동으로 삭제 후)
git rm --cached <file>
git add <file>

LFS로 관리중인 File 다운로드

단순히 git lfs로 관리중인 파일이 아래와 같이 lfs pointer만 가지고 있는 경우, lfs pull 명령어로 컨텐츠를 다운받아올 수 있습니다.

version https://git-lfs.github.com/spec/v1oid sha256:265d20bff17c6e19af9c76ef9e00c89de14e34135e23ac2626f6db56e7fb3182
size 15927

# 실제 파일 컨텐츠를 다운받음
git lfs pull  
LFS 파일 목록 확인

lfs로 관리중인 파일 목록 확인

git lfs ls-files