태그

GitHub 협업 – 깃배쉬로 깃허브 저장소 연결하기 (팀원버전)

💻 GitHub 협업 정리 – 팀 프로젝트 깃 세팅 완전 가이드 (깃배쉬 기준)

팀 프로젝트를 하다 보면 깃허브를 쓰게 된다.
하지만, 막상 해보면 어렵다. 브랜치? 포크? 푸시? 뭐가 뭔지 모르겠고, 실수하면 다 망가질까 봐 무섭다.

그래서 오늘은 깃허브 협업을 위한 기본 세팅부터 팀원 작업까지
진짜 한 단계씩 정리해보겠다.

✅ Step 1. main 브랜치 만들기 (master → main으로 통일)

처음 프로젝트를 만들면 master 브랜치만 있는 경우가 많다.
우리는 main 브랜치로 통일해야 한다.

👉 이클립스에서 main 브랜치 만들기

  1. 프로젝트에서 마우스 우클릭

  2. Switch To > Create Branch

  3. 이름을 main으로 설정

  4. 현재 master에서 복사된 main 브랜치가 생긴다

이제 언제든지 master <-> main 전환 가능!

👉 master 브랜치 삭제하기

  1. master 브랜치를 체크아웃에서 벗어나게 만들고

  2. Delete Branch로 삭제

이제 main 브랜치 하나로 통일 완료!

✅ Step 2. GitHub에서도 브랜치 정리하기

깃허브 사이트에 가보면 아직 master, main 둘 다 남아있다.
이제 깃허브도 정리하자.

  1. GitHub 저장소 접속

  2. View all branches 클릭

  3. master 브랜치 찾아서 Delete

로컬과 깃허브 둘 다 main 브랜치만 남겨두자!

⚠️ 주의할 점!

  • main에서 main으로 푸시/풀은 매우 위험하다.
    아무 승인 없이 변경이 올라가기 때문에 실수하면 되돌릴 수 없다.

  • 항상 브랜치를 따서 작업하고, 팀장이 병합(Merge) 해야 한다.

✅ Step 3. 깃허브 계정 나누기 + 포크하기

팀장은 팀장 계정,
팀원은 팀원 계정으로 따로 관리해야 안전하다.

브라우저도 크롬/엣지 따로 쓰면 더 깔끔하다.

👉 팀원이 해야 할 일

  1. 깃허브에서 팀장님의 저장소를 찾아서 Fork 클릭

  2. 내 계정에 복사된 저장소가 생긴다

  3. 이걸 이클립스에 불러오기

🎯 미션 1 - 팀원

  • 팀원 계정에서 팀장 저장소 Fork하기

  • 이클립스에서 가져와서 Project로 등록

  • 팀원 깃허브 저장소 목록 캡쳐

  • 이클립스 프로젝트 목록도 캡쳐

  • 제출

✅ Step 4. 팀원 브랜치 정리하기

👉 원격(Remote) 브랜치와 로컬(Local) 브랜치 확인하기

  • 원격 브랜치 = GitHub에 있는 브랜치

  • 로컬 브랜치 = 내 컴퓨터에 있는 브랜치

👉 피쳐 브랜치 삭제하기

필요 없는 브랜치는 지워줘야 깔끔하다.
이클립스나 GitHub에서 Delete Branch로 정리하자.

✅ Step 5. 실제 작업하기 (브랜치 따서 작업)


 Step 6-클론 깃레포지토리로 원격 레포지토리와

내 컴퓨터 연결하기

🎯 미션 2 - 팀원 작업

  1. 새로운 브랜치 만들기

    • 이름 예시: 홍길동/order

  2. src > order 패키지 만들기

  3. Test.java 파일 생성하고 코드 작성

  4. 커밋하고 → 푸시(Push) 하기

  5. GitHub에서 Pull Request 요청하기

  6. 팀장이 Merge 해주면

  7. 작업한 브랜치 삭제하기

📸 미션:

  • 팀장 GitHub 저장소의 src 폴더 내용 캡쳐해서 제출

✅ Step 7. 팀장과 싱크 맞추기 (업스트림 등록)

우리가 포크해서 작업한 건 팀장 저장소랑 분리되어 있다.
따라서 팀장 쪽에서 업데이트된 내용을 가져와서 내 저장소와 맞춰야 한다.

👉 기본 개념

  • origin = 나의 깃허브 저장소

  • upstream = 팀장님의 저장소

👉 동기화 순서

  1. upstream 등록

    git remote add upstream https://github.com/팀장아이디/저장소이름.git

  2. 팀장 저장소에서 변경 내용 가져오기

    git fetch upstream

  3. 내 로컬 브랜치(main)에 머지하기

    git merge upstream/main

  4. 내 깃허브 저장소(origin)에 푸시

    git push origin main

✅ Step 8 마무리 정리

역할 해야 할 일
팀장 저장소 생성 + Merge
팀원 Fork → 브랜치 작업 → PR 요청
공통 브랜치 따로 만들고 main은 직접 건드리지 않기

🧩 참고 유튜브 (추천 영상)

  1. Git 브랜치 기본 개념

  2. 포크 & PR 실습

  3. 업스트림 동기화 방법

📌 글쓴이 팁

  • 진짜 처음엔 어렵다. 근데 10번만 따라하면 무조건 익숙해진다

  • 혼자 하면 무섭지만, 틀리면 다시하면 된다

  • 실수는 연습의 일부!

라벨:

댓글

댓글 쓰기