git subtree는 Git에서 **하위 리포지토리(sub-repository)**를 관리하기 위한 메커니즘입니다. 이를 사용하면 한 리포지토리의 디렉토리 내에 또 다른 리포지토리의 내용을 포함시킬 수 있으며, 각 리포지토리를 독립적으로 관리할 수 있습니다. git submodule과 비교되는 기능으로, 의존성 관리를 간단하게 하려는 목적으로 자주 사용됩니다.

부모 입장에서는 그냥 부모/자식 구분 없는 덩어린데, 자식 입장에서는 원격 저장소가 따로 있는 느낌

• 부모(내 저장소) 입장:

  → 하위 폴더에 코드가 들어와 있을 뿐, 딱히 “부모/자식” 구조로 의식할 필요 없이 그냥 자기 저장소의 일부처럼 사용함.

• 자식(외부 저장소) 입장:

  → 부모 저장소에서 내(자식) 저장소의 원격 주소와 브랜치를 따로 등록해놓고, 필요할 때만 subtree 명령으로 “동기화”하거나 변경 내역을 push하여 양방향 업데이트가 가능함.

[내 로컬 저장소]
   └─ [subtree/] (외부 레포의 코드와 커밋이력 통째로 들어옴)

    [내 로컬 저장소]        [subtree/]
          ↑                  ↑
    git pull/push      git subtree pull/push
          ↓                  ↓
    [내 원격 저장소]       [외부(업스트림) 원격 저장소]

Git Subtree의 핵심 개념

1. 독립적인 리포지토리 포함
   • subtree는 특정 디렉토리 아래에 다른 리포지토리의 내용을 가져오고, 이를 독립적으로 사용할 수 있게 합니다.
   • 두 리포지토리는 서로 연결되지만, 완전히 독립적으로 관리됩니다.
2. 완전한 커밋 내역 보존
   • subtree로 추가된 리포지토리의 커밋 내역은 부모 리포지토리에 통합됩니다.
   • 원하는 경우 -squash 옵션으로 서브 리포지토리의 커밋을 단일 커밋으로 병합할 수도 있습니다.
3. 병합과 분리가 간단
   • 부모 리포지토리에서 서브 리포지토리를 병합하거나 독립적으로 업데이트할 수 있습니다.
   • 필요 시 서브 리포지토리를 독립된 리포지토리로 분리하는 것도 가능합니다.

Git Subtree의 주요 명령어

1. Subtree 추가

다른 리포지토리를 현재 리포지토리에 추가합니다.

git subtree add --prefix=<directory> <repository-url> <branch> [--squash]

• --prefix=<directory>: 서브 리포지토리를 포함할 디렉토리 경로.
• <repository-url>: 서브 리포지토리의 원격 URL.
• <branch>: 서브 리포지토리에서 가져올 브랜치.
• --squash: 서브 리포지토리의 모든 커밋을 단일 커밋으로 병합.

2. Subtree 업데이트

서브 리포지토리의 내용을 최신 상태로 업데이트합니다.

git subtree pull --prefix=<directory> <repository-url> <branch> [--squash]

• 부모 리포지토리와 서브 리포지토리의 내용을 병합합니다.