[GitHub] 깃허브로 협업하기 - 깃허브 사용법과 기본 흐름

깃허브로 처음 협업하는 분들을 위해 간단한 개념과 기본적인 흐름을 정리하려고 합니다.

참고로 깃허브 계정을 만들고, 레포지토리를 만들어서 내 컴퓨터에 클론을 하는 초기 설정이 모두 끝난 후의 단계입니다.

프로젝트 내내 반복해서 하게 될 과정들이기 때문에 도움이 많이 될 것이라고 생각합니다.😊

 

💭 깃허브를 처음 사용하며

깃허브... 좋은 거 맞아?

깃허브 특강을 듣고 처음으로 깃허브라는 걸 써보게 됐습니다.
그러면서 처음 든 생각은 '정말 전 세계 개발자들이 이걸 쓴다고...? 이게 편한 게 맞아??' 였습니다.
처음 접하면 너무 어렵고 복잡하게 느껴지는 깃허브...

일주일 정도 사용해보니 생각이 바뀌었습니다.
좋은 거 맞습니다. 익숙해지면 정말 편해요.

 

깃허브를 쓰는 이유 (내가 느낀 장점)

1. 협업이 쉬워진다.

여러 명이 실시간으로 작업하고 공유할 수 있습니다.

코드를 수정할 때마다 카톡으로 파일을 주고받지 않아도 된다는 뜻입니다!

 

2. 버전 관리가 가능하다.

코드 변경 내역이 다 기록되기 때문에, 언제든지 이전 상태로 돌아갈 수 있습니다.

작업을 하다가 실수해도 걱정 없이 되돌리기가 가능해요!

 

💡 GitHub란?

GitHub는 코드를 저장하고 관리하는 공간입니다.
Git이라는 버전 관리 시스템을 기반으로 만들어졌고,
누가, 언제, 무엇을 수정했는지를 기록하고 관리할 수 있습니다.

 

https://github.com/

GitHub · Build and ship software on a single, collaborative platform

 

🌱 브랜치(Branch)란?

깃허브로 협업을 할 때, '브랜치'라는 걸 만들어서 작업합니다.

 

여기서 브랜치는 작업을 위한 독립된 공간입니다.

'나뭇가지'라는 뜻처럼 원본에서 가지치기해서 복사한 것으로 수정을 할 수 있는 복사본의 개념입니다. 
기존 코드를 건드리지 않고 새로운 기능을 수정하거나 추가할 수 있습니다.

 

- 협업에서의 브랜치 전략

브랜치를 목적에 따라 나눠서 작업하는 것이 협업의 핵심입니다.

 

1. main 브랜치

최종 배포용 코드가 있는 브랜치입니다.

이 브랜치는 가장 마지막에 배포할 때 이외에는 거의 사용하지 않는다고 보면 됩니다.

 

2. develop 브랜치

팀원들이 작업을 합치는 통합 개발용 브랜치입니다.

각 feature 브랜치에서 작업을 끝낸 후에 이 브랜치로 merge(병합)합니다.

최종적으로는 이 브랜치를 main브랜치로 병합하게 됩니다.

 

3. feature 브랜치

실제로 작업하는 공간입니다.

각자 작업을 이 브랜치에서 하고, 작업이 끝나면 develop 브랜치로 병합하게 됩니다.

 

요약하자면 다음과 같은 흐름입니다.

- feature에서 작업하고

- 각자 작업한 걸 develop으로 합치고

- 모든 작업이 끝나고 main으로 합쳐서 배포

 

✅ 깃허브로 협업하기

- 협업의 기본 흐름

깃허브 협업의 단계를 먼저 쉽게 정리하면 다음과 같습니다.

1. 현재까지의 코드를 내 컴퓨터로 가져옵니다. (pull)

2. 각자 자신의 브랜치에서 작업을 해서 GitHub에 업로드 합니다. (push)

3. 코드를 확인하고 develop브랜치로 병합합니다. (merge)

 

➡️ 깃허브 협업을 위한 작업 순서

다른 팀원이 수정을 한 후, 내가 작업할 때의 수행 단계입니다.

작업들은 git bash나 vs code의 터미널에서 하면 됩니다!

 

1. 최신 코드 가져오기 (Pull)

- 현재 디렉토리로 이동하고 pull합니다.

작업 시작 전에는 항상 최신 코드를 받아야 충돌을 방지할 수 있습니다.

cd 작업할 폴더 경로
git pull

 

 

2. 이슈 생성 & 브랜치 생성

1) 이슈 생성

초록색 버튼 New issue를 눌러 작업할 이슈를 생성합니다.

2) 브랜치 생성

내용을 작성하고 Create를 누르면, 이슈가 만들어집니다.

오른쪽 화면에서 Assignees에 Assign yourself를 클릭하고 (담당자를 나로 지정),

Development의 Create a branch를 클릭하여 새 브런치를 생성합니다.  

 

* 이 때 규칙이 팀마다 다를 수 있지만, 일반적으로 Branch name앞에 feature/를 붙이고 Branch source를 main이 아닌 develop로 변경해야 합니다.

 

3. 코드 수정

원하는 작업을 진행합니다.

 

4. 변경사항 저장 (Commit)

커밋 메세지를 작성하여 변경사항을 저장합니다.

git add .           # 수정한 파일들 스테이징
git commit -m "커밋 메시지"  # 변경 이유 간단히 작성

 

5. 원격 저장소로 업로드 (Push)

내 컴퓨터의 코드를 GitHub로 업로드합니다.

git push

 

6. Pull Request(PR) 생성

GitHub에서 Pull Request(PR)를 생성하여 팀원들에게 코드 리뷰를 요청합니다.

* push후 깃허브에 들어가면 위에 pr창이 뜹니다.

7. 코드 리뷰 & Approve

- 팀원들이 코드를 확인하고 피드백을 남깁니다.

- approve를 받으면 merge를 할 수 있습니다.

 

8. Merge 후 브랜치 삭제

- 확인이 모두 끝났으면 merge를 누르고 브랜치를 삭제합니다.

* 깃허브에 Delete branch버튼이 뜹니다.

 

이런 단계로 깃허브 협업을 진행하면 됩니다. 

프로젝트 할 때 깃허브를 잘 활용해보세요!