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

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]

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

3. Subtree 푸시