git subtree - repository 내에 다른 repository link 하기

Github 등에서 git 을 통해 코드를 관리하다 보면 여러 repo 에 중복되는 코드가 발생할 수 있다.

이런 repo 간 코드 중복을 피하기 위해 특정 repo 안에 다른 repo 를 연결해서 사용하면 중복을 피할 수 있는데, git subtree 를 활용하면 가능하다. (리눅스에서의 symbloic link 와 비슷하다고 해야할까?)

- 메인 repo : mysite
- 서브 repo : utils (연결할 repo)

 

메인 repo 의 최상위 폴더에서 아래 명령을 순서대로 실행

 

1. remote 에 연결할 repo 등록

$ git remote add [remote 이름] [연결할 repo 주소]

$ git remote add utils https://github.com/okojj/utils.git

 

2. 등록된 remote 확인

$ git remote -v
origin	https://github.com:okojj/mysite.git (fetch)
origin	https://github.com/okojj/mysite.git (push)
utils	https://github.com/okojj/utils.git (fetch)
utils	https://github.com/okojj/utils.git (push)

 

3. git subtree 명령으로 연결 등록

$ git subtree add --prefix=[생성할폴더명]  [연결할 repo 이름]  [연결할 repo의 branch]

$ git subtree add --prefix=utils utils main
git fetch utils main
remote: Enumerating objects: 11, done.
remote: Counting objects: 100% (11/11), done.
remote: Compressing objects: 100% (8/8), done.
remote: Total 11 (delta 1), reused 6 (delta 0), pack-reused 0
Unpacking objects: 100% (11/11), 1.77 KiB | 362.00 KiB/s, done.
From github.com:okojj/utils
 * branch            main       -> FETCH_HEAD
 * [new branch]      main       -> utils/main
Added dir 'utils'

로컬에 생성된 utils 폴더 확인

 

4. git push 로 remote 에 등록

$ git push
Enumerating objects: 14, done.
Counting objects: 100% (14/14), done.
Delta compression using up to 2 threads
Compressing objects: 100% (10/10), done.
Writing objects: 100% (13/13), 2.19 KiB | 2.19 MiB/s, done.
Total 13 (delta 0), reused 0 (delta 0), pack-reused 0
To github.com:okojj/mysite.git
   6f7327c..b79940f  main -> main

 

5. subtree 폴더 원격에서 내려받기 (pull)

subtree 로 추가한 폴더에 업데이트가 있을 경우 반영하는 방법

$ git subtree pull --prefix=utils utils main

 

6. subtree 폴더를 원격에 반영하기 (push)

subtree 폴더 내에 변경사항에 대해 remote 에 반영하는 경우

$ git subtree push --prefix=utils utils main