Git, Github, Gitlab submodule(서브모듈) 설정하기

 

1. Submodule 이란?

 

 git 프로젝트에서 다른 프로젝트를 하위 디렉토리에 포함시키는 방법.

하나의 프로젝트에서 다수의 프로젝트를 관리할 수 있다. 단, 각 저장소의 커밋은 독립적으로 관리된다.

 

 

 

2. Submodule 추가하기

 

# git command

git submodule add <your-git-url>

 

 커맨드로 추가할 수도 있고 SourceTree를 사용한다면 소스트리에서도 메인 저장소의 왼쪽 메뉴(Branches, Tags, Remotes  있는 부분)에서 빈 공간에서 오른쪽 마우스를 클릭하면 Add Submodule이라고 메뉴가 있어서 클릭하면 된다.

 

 

2. Submodule 제거하기

 

제거하는 법은 간단하다.

git submodule deinit -f <your-submodule-git-folder-location>

# 메인 프로젝트의 .git 에서 modules 폴더 내 삭제
rm -rf .git/modules/<your-submodule-git-folder>

# 깃에서 해당 디렉토리 제거
git rm -f <your-submodule-git-folder>

# 커밋
git commit -m <commit-message>