git clone은 같은 저장소를 받아도 옵션에 따라 받는 양이 달라집니다. 이 글에서는 공개 저장소 octocat/Hello-World를 전체 클론, 얕은 클론, 부분 클론 세 가지로 받아 커밋 수와 원격 설정을 비교합니다.
준비물
| 항목 | 내용 |
|---|---|
| Git | 2.54.0.windows.1 |
| 실습 저장소 | https://github.com/octocat/Hello-World.git (공개 저장소, 인증 없이 읽기 가능) |
| 작업 위치 | 임시 디렉터리 아래 clone-lab |
| 예상 소요 시간 | 약 10분 |
이 글에서는 HTTPS 주소로만 실행합니다. SSH 주소는 GitHub에 공개 키를 등록한 뒤에만 쓸 수 있어, 이 실습 환경에서는 실행하지 않았습니다.
1. 전체 클론
가장 기본 형태는 주소만 주는 방식입니다.
git clone https://github.com/octocat/Hello-World.git hw-full
출력은 다음과 같습니다.
Cloning into 'hw-full'...
받은 뒤 커밋 수와 원격 주소를 확인합니다.
git -C hw-full rev-list --count HEAD
git -C hw-full remote -v
3
origin https://github.com/octocat/Hello-World.git (fetch)
origin https://github.com/octocat/Hello-World.git (push)
전체 클론은 커밋 이력과 모든 파일 내용을 받습니다. 저장소가 클수록 시간과 디스크 사용량이 늘어납니다.
2. 얕은 클론 (--depth 1)
최신 커밋 한 개만 받으려면 --depth를 씁니다.
git clone --depth 1 https://github.com/octocat/Hello-World.git hw-shallow
git -C hw-shallow rev-list --count HEAD
cat hw-shallow/.git/shallow
1
7fd1a60b01f91b314f59955a4e4d4e80d8edf11d
.git/shallow 파일에 이력이 잘린 지점의 커밋 해시가 기록됩니다. git log는 이 커밋 한 줄만 보여 주므로, 그 이전의 변경 기록은 이 복제본에 없습니다. 빌드만 하고 이력은 볼 필요가 없을 때 씁니다.
3. 부분 클론 (--filter=blob:none)
커밋 이력은 모두 받고 파일 내용(blob)은 필요할 때 가져오는 방식입니다.
git clone --filter=blob:none https://github.com/octocat/Hello-World.git hw-blobless
git -C hw-blobless config --get remote.origin.partialclonefilter
git -C hw-blobless rev-list --count HEAD
blob:none
3
커밋 수는 전체 클론과 같습니다. 대신 파일 내용은 체크아웃이나 git show를 할 때 원격에서 받습니다. 이력 분석은 하면서 디스크는 아끼고 싶을 때 씁니다.
4. 세 방식 비교
| 방식 | 명령 | 커밋 수 | 파일 내용 | 이력 추적 |
|---|---|---|---|---|
| 전체 클론 | git clone <주소> |
3 | 모두 받음 | 가능 |
| 얕은 클론 | git clone --depth 1 <주소> |
1 | 최신 커밋만 | 제한됨 |
| 부분 클론 | git clone --filter=blob:none <주소> |
3 | 필요할 때 받음 | 가능 (내용은 지연 다운로드) |
5. 확인 체크리스트
- 전체 클론으로 커밋 3개와 원격 주소를 확인했습니다.
-
--depth 1클론에서 커밋 1개와.git/shallow파일을 확인했습니다. -
--filter=blob:none클론에서partialclonefilter설정과 커밋 3개를 확인했습니다.
이 글의 다음 단계
- npm audit --audit-level 사용법: 종료 코드로 배포 막기npm audit --audit-level은 지정한 심각도 이상의 취약점이 있을 때만 종료 코드 1을 돌려줍니다. low부터 critical까지 단계별 종료 코드와 --omit=dev를 붙였을 때의 차이를 실제 실행 결과로 확인합니다. npm script와 CI 단계에 넣는 방법도 정리합니다.
- package.json과 package-lock.json 차이: npm ci로 확인하기package.json에는 허용하는 버전 범위가, package-lock.json에는 실제로 설치된 버전과 integrity 해시가 적힙니다. 같은 프로젝트에서 npm install과 npm ci를 번갈아 실행해 두 파일의 역할과 두 명령의 차이를 실제 출력으로 확인합니다.
이 내용을 팀 교육으로 진행하고 싶으신가요?
인원, 수준, 일정에 맞춰 실습 환경까지 준비해 진행합니다. 대상과 기간을 알려 주시면 구성을 제안해 드립니다.
교육 문의하기메일로 보내실 수도 있습니다: fankh111@gmail.com