[git] submodule 활용하기 (.gitmodules 파일)

submodule 명령어 자체에 대해서는 아래 글에서 확인 가능.

2023.08.29 - [【 개발 이야기 】] - [git] submodule 명령어

---

submodule 명령어를 사용하여 git 저장소에 이미 존재하는 다른 git 저장소를 서브모듈로 추가하는 방법

1. 서브모듈 추가하기

   git submodule add https://github.com/example/awesome-lib.git lib/awesome

 

이 명령어는 " https://github.com/example/awesome-lib.git " 저장소를 ➡️ "lib/awesome" 디렉토리로 서브모듈로 추가한다.

`.gitmodules` 파일은 서브모듈을 추가할 때 Git 명령어와 함께 자동으로 관리된다.

2. 서브모듈 확인하기

   git submodule status

 

현재 서브모듈의 상태와 커밋 해시값이 표시됨

해시값 | 저장소명 | (커밋해시값 or 브랜치)

3. 서브모듈 최신으로 업데이트

   git submodule update --remote

4. 서브모듈 초기화

   git submodule init

 

* 서브모듈을 클론한 후 처음에는 반드시 초기화해야 함.

---

submodule이 있는 프로젝트(ex:all-prj.git) clone 받는 방법

mkdir ~/all-prj

git clone git@all-prj.git # submodule을 포함하는 최상위 repository를 클론 받는다.

cd all-prj

git submodule init

git submodule update

cd sub-prj

git checkout master # sub-prj의 브랜치로 체크아웃된다.