[Github] Github으로 협업하기 - Organization(Forking Workflow)

🔗 Git과 Github의 차이

Git: 개인 컴퓨터에서 돌아가는 Version Control System - 인터넷 연결 없이도 사용 가능

Github: 서버에 올라간 Git - 인터넷 연결해야만 사용 가능

🔗 저장소 분류

중앙 원격(remote) 저장소: 여러 명이 프로젝트를 관리하는데 사용되는 그룹 계정의 중립된 원격 저장소

자신의 원격(remote) 저장소: Github 전용 서버에서 관리되는 원격 저장소. 

로컬(local) 저장소: 내 pc에 저장되는 저장소.

---

🔗 1. Fork: 중앙 원격 저장소 -> 내 원격 저장소

Organizatioin에서 Repository를 생성하면 중앙 원격 저장소가 생성된다. Fork를 통해 중앙 원격 저장소의 리포를 내 원격 저장소에 옮기는 것이다. (Organization이 아니라 개인이 생성한 리포지토리도 내 원격 저장소로 Fork 가능하다.)

 

 

중앙 원격 저장소의 리포에 들어가 Fork를 클릭하면

 

이런 창이 뜨고 Create fork 버튼을 클릭하면 내 리포지토리에 중앙 원격 저장소의 리포지토리를 복제한 것과 같은 리포지토리가 새로 생성된다. 

*fork를 취소하고 싶다면 내가 포크한 리포로 들어가 설정에서 delete를 누르면 삭제 가능.

 

---

🔗 2. clone: 내 원격 저장소 -> 내 로컬 저장소

내 원격 저장소를 복제하여 로컬 저장소를 만드는 명령어.

git clone <내 remote repository URL>

*주의: 파일을 생성하고, 그 파일에서 터미널을 열어 명령어를 입력해주어야 한다.

 

---

🔗 3. 두개의 원격 저장소를 연결

git remote add upstream <중앙 remote repository URL>

-> remote add: 내 Git 저장소에 원격 저장소(remote repository)를 추가하겠다.

-> upstream: 새로 추가하는 원격 저장소의 별칭. 내가 정하는 것이기 때문에 다른 이름을 써주어도 됨. But, 보통 중앙 원격 저장소는 일반적으로 upstream이란 별칭을 붙임. 2번의 내 원격 저장소는 clone과 동시에 기본적으로 origin 이란 이름이 자동으로 만들어진다. 이렇게 두개의 원격 저장소를 연결해 주어야지만 로컬 저장소를 프로젝트 중앙 원격 저장소와 같은 상태로 유지할 수 있다. 

*clone을 통해 생성된 파일에서 터미널을 열어 작성해주어야 한다. 

 

git remote -v

-> 명령어를 통해 현재 내 깃 저장소에 설정된 원격(remote) 저장소의 리스트를 볼 수 있다.

git pull upstream <Branch Name>

-> upstream 원격 저장소의 <Branch Name>의 작업만 Pull 받는다는 의미이다. 

git fetch upstream

-> upstream 원격(remote) 저장소의 모든 브랜치 정보를 가져오라는 것을 의미한다.

---

 

🔗 4. 로컬 저장소에서 새로운 브랜치를 생성

브랜치를 생성하는 이유: 일반적으로는 새로운 기능을 추가할 때마다 기능을 이름으로 하여 새로운 브랜치를 생성한다. 하지만, 프로젝트 참여자별로 브랜치를 생성하는 경우도 있다. 

git branch <내가 원하는 branch 이름>

-> 새로운 브랜치 생성. (새로운 브랜치가 생성될 때 내 원격 저장소의 코드가 복사되는 것이 아니라 내 로컬 저장소의 코드가 그대로 복사되어 새로운 브랜치로 옮겨지는 것임.)

git checkout <이동하고자 하는 branch 이름>

-> ~~이름의 브랜치로 이동.

git checkout -b <branch name>

-> <branch name>이란 이름의 브랜치를 생성하는 동시에 이 브랜치로 이동.

 

---

🔗 5. 로컬 저장소의 커밋을 자신의 원격 저장소에 푸시

바로 중앙 원격 저장소에 자신의 기능을 추가한 코드를 푸시한다면 굳이 Organization과 Fork를 사용해 새로운 기능을 구현한 코드들을 분리하는 이유가 사라진다. 중앙 원격 저장소가 아닌 자신의 원격 저장소에 푸시한다.

git add . // 변경된 모든 파일을 스테이징 영역에 추가 파일 이름이나 경로를 적어서 특정 파일만
			스테이징 영역에 추가하는 것도 가능.
git commit -m "커밋 메시지"

* Git에는 세가지 영역과 세가지 상태가 존재.

 

영역

Untracked area: Git이 관리하고 있지 않은 영역(파일)

Tracked area: Git의 관리를 받을 수 있는 영역(파일)

Staging area: Commit이 가능한 영역(파일)

 

상태

Unmodified: 기존에 커밋 했던 파일을 수정하지 않은 상태

Modified: 기존에 커밋했던 파일을 수정한 상태

Staged: Commit이 가능한 상태

 

=> git add 명령어는 tracked area의 modified된 상태의 파일을 staging area로 옮겨주어 staged상태로 변경해주는 명령어라고 보면됨.

git push origin <branch name>

-> 수정한 코드가 있는 원격 저장소의 브랜치에 푸시

 

---

🔗 6. Pull Request

인터넷을 통해 내가 Fork한 리포지토리로 가서 admin에게 pull request를 보낸다. branch 선택 가능.

(소규모 프로젝트에선 모두가 admin이 될 수 있다.)

 

---

🔗 7. 프로젝트 관리자(admin)은 pull request의 변경 내용을 확인하고 중앙 원격 저장소에 병합(merge)한다. 

Github 페이지에서 Pull request 버튼을 클릭 후, File changed 탭에서 변경 내용을 확인하여 Conversation 탭으로 이동하여 "Confirm merge"를 하면 중앙 원격 코드 베이스에 병합(merge)된다. 충돌이 발생하는 경우엔 팀원들과 의논하여 충돌 내용을 수정 후 병합.

 

---

🔗 8. 중앙 원격 저장소와 자신의 로컬 저장소를 동기화 하기 위해 로컬 저장소의 branch를 기본 브랜치(최종 코드를 넣는 브랜치)로 이동(checkout) 후 pull

git pull upstream main

---

🔗 9. 새로운 기능을 추가하기 위해 또 브랜치를 생성(반복)

8번을 통해 중앙 원격 저장소와 동기화된 로컬 저장소의 main 브랜치에서 새로운 브랜치를 하나 더 파서 작업을 시작.

---

🔗  References

https://kotlinworld.com/265

https://gmlwjd9405.github.io/2017/10/28/how-to-collaborate-on-GitHub-2.html

https://ittrue.tistory.com/94