♣ 깃허브 브랜치 사용법
◆ 1. Git 저장소를 클론하고 main 브랜치를 가져오는 방법
1) STS4를 실행하고 프로젝트를 여십시오.
2) 오른쪽 상단의 git 아이콘을 클릭합니다.
3) Clone a Git Repository를 클릭합니다.
4) URI : 깃허브 저장의 주소를 붙여놓고 Next를 선택합니다.
5) Branch Selection에서 main만 클릭한 후 Next를 선택합니다.
6) 저장소 위치를 선택합니다.
- STS (Spring Tool Suite4)는 Spring 프레임워크를 위한 IDE입니다.
- 이를 사용하여 Git 저장소와 함께 개인 브랜치를 생성하는 방법입니다.
◆ 2. 브랜치 생성 및 사용법
1) STS4를 실행하고 프로젝트를 열고, 오른쪽 상단의 git 아이콘을 클릭합니다.
1-1) 프로젝트의 변경사항이 있을 경우 Commit을 합니다.
2) 다른 팀원이 PR을 완료하고 main과 개인브랜치 주소가 달라졌을 경우, main 브랜치의 변경 사항을 가져오기 위해서 프로젝트를 Pull 합니다.
3) Local에서 main 브랜치를 삭제합니다.
4) Remote Tracking에서 main 브랜치를 더블 클릭해서 Local로 새로운 main 브랜치를 복사합니다.
-> Check out as New Local Branch 클릭
5) Local에서 개인브랜치를 삭제합니다.
6) Local에서 main 브랜치를 마우스 오른쪽 버튼을 클릭한 후, Create Branch를 선택하여 새로운 개인브랜치를 생성합니다.
7) Local에서 새로 생성한 개인브랜치를 마우스 오른쪽 버튼으로 클릭한 후, Push Branch를 선택하여 클라우드 저장소로 push합니다.
8) 전체적인 흐름
-
main 브랜치의 변경 사항을 가져옵니다.
-
새로운 개인브랜치를 가지고 작업을 한 후, 작업이 끝나면 커밋 후 push 및 PR을 합니다.
-
PR후 브랜치가 작업이 끝났을 경우, Local에서 main과 개인브랜치를 각각 삭제합니다.
-
Local에서 main과 개인브랜치를 각가 생성합니다.
-
Branches - Local : 로컬저장소
-
Branches - Remote Tracking : 클라우드 저장소
-
(주의!) pull을 할 때, Remote Tracking의 개인브랜치 데이터가 -> Local의 개인브랜치로 들어온다.
- 그래서 Remote Tracking의 나의 개인브랜치가 없으면 안된다.
-
PR(pull request) : 개인브랜치에서 작업한 내용을 main에 업로드는 하는 것
◆ 3. 충돌을 방지하고 해결하는 방법
origin/main보다 내가 PR한 내용이 더 앞서 갈 경우, main의 가장 최신 데이터를 개인브랜치로 가져오는 것은 merge라고 한다.
1) 깃허브 사이트 상단 메뉴에서 Insights 클릭
2) 왼쪽 메뉴바에서 Network 클릭
3) Network graph에서 main 주소를 확인
4) STS4를 실행하고 프로젝트를 열고, 오른쪽 상단의 git 아이콘을 클릭합니다.
5) 저장소 Branches - Remote Tracking의 origin/main 주소와 다를경우 sts4의 Git 저장소를 pull 합니다.
6) Git Repositories 뷰에서 Remote Tracking 브랜치 중 origin/main을 마우스 우클릭 후 Merge를 선택합니다.
- 클라우드 저장소의 main 브랜치와 로컬저장소의 main 브랜치를 병합해주는 것입니다.
- 충돌 문제를 해결 해주기도 합니다.
7) "Merge" 대화상자에서 "To branch" 섹션에서 "Local" 탭을 선택한 다음 개인 브랜치를 선택하십시오. "Merge" 버튼을 클릭하십시오.
8) 충돌된 파일이 sts4 해당 프로젝트로 파일이 불러와집니다.
9) 해당 파일에서 필요한 부분을 제외하고 코드를 삭제한 후 commit 합니다.
10) 변경 사항을 클라우드 저장소에 push하려면 Git Repositories 뷰에서 개인 브랜치를 마우스 오른쪽 버튼으로 클릭하고 "Push Branch"를 선택하십시오.
- 이를 통해 클라우드 저장소의 개인 브랜치에 변경 사항이 반영됩니다.
11) 깃허브에서 PR(Pull Request)을 생성하여 main 브랜치로 병합을 요청합니다.
◆ 4. 프로젝트 생성 시 유의사항
1) 프로젝트 생성 시 static과 templates 폴더에 .keep 이라는 파일명을 작성하여 file을 생성한다.
- 다른 저장소에서 해당 프로젝트를 가져올 경우 빈폴더는 가져오지 못하기 때문이다.
- .keep 파일명으로 생성 시 파일이 숨겨져서 생성된다.
