태그

GitHub 협업 – 이클립스로 깃허브 저장소 연결하기 (팀원버전)


🌱 GitHub 협업 – 이클립스로만 작업하기  (remote  & origin & upstream 완벽정리)

이클립스(Eclipse)를 사용해서 GitHub 협업을 진행하는 방법 부제: remote 저장소에 origin과 upstream이 함께 있을 때 어떻게 동기화하고 작업하는지도 포함해서 쉽게 설명하기

📌 개요

  • 터미널(Git Bash/검은화면) 절대 사용 안 함!

  • 이클립스 Git 기능만 사용

  • 팀 협업을 위한 깃허브 설정부터 브랜치 동기화, 푸시/풀/PR까지 전부 포함

🧩 용어 간단 정리

용어 의미
origin 내가 포크(fork)한 깃허브 저장소 (내 깃허브 계정에 있는 저장소)
upstream 팀장님의 깃허브 저장소 (원본 저장소, 포크해야하는 원본)
Local(로컬 저장소) 이클립스 내 내 컴퓨터에 있는 프로젝트저장소
Remote(원격 저장소) 깃허브에 올라가 있는 모든 원격 저장소(팀장 팀원 뿐만아니라 깃허브에 올라져있는 저장소 누구꺼든지 가져오기 가능)

✅ 1단계. 프로젝트 시작 전 구조 이해하기

팀장 깃허브 저장소(remote/upstream) ──> (fork) ──> 팀원 깃허브 저장소 (remote/origin)
                                     │
                                     └──> 이클립스 팀원 로컬 저장소(Local)

✅ 2단계. 팀장 저장소 포크하고 이클립스로 가져오기

1) GitHub에서 팀장 저장소를복사하기 (Fork)

팀장의 깃허브계정 저장소 안의 내용 -> 팀원인 나의 깃허브계정의 저장소로 복사하기

이걸 -> 전문용어로 (GitHub에있는 팀장 저장소를 Fork)한다 라고한다

  • 팀원 계정으로 로그인

  • 팀장 저장소 접속

  • 우측 상단 Fork 버튼 클릭

2) 이클립스에서 포크한 저장소 가져오기(Import)

팀원인 나의 깃허브계정의 저장소 안의 내용 -> 이클립스 프로젝트 폴더로로 복사후 가져하기

이걸 -> 전문용어로 (GitHub에있는 내 저장소를 Import)한다 라고한다

  1. File > Import

  2. Git > Projects from Git 선택

  3. Clone URI 선택

  4. 내 포크된 저장소 주소 입력 (origin)

  5. 브랜치 선택 (보통 main)

  6. 로컬 디렉토리 지정 후 Finish

→ 이제 이클립스에 내 로컬 프로젝트가 생김

✅ 3단계. main 브랜치 만들고 master 삭제

이 작업을 하는 이유=이클립스에서는 마스터브랜치를 만들어주지 메인브랜치를 안만든다
그래서 이클립스에서 만일 마스터 브랜치가 있으면 먼저 메인을 생성해서
깃허브의 메인브랜치와 일치시키고 마스터 브랜치를 삭제해주는 작업을 해야한다!
(만일 브랜치에서 메인만 있고 마스터브랜치가 없다면 이 3단계는 할필요가 없다!)

✔ main 브랜치 생성

  1. Git Perspective 열기 (오른쪽 상단 Git 아이콘 클릭)

  2. 좌측 브랜치 트리에서 master 브랜치 우클릭

  3. Switch To → New Branch

  4. 이름을 main으로 설정하고 생성

✔ master 브랜치 삭제

  1. master 브랜치 우클릭 → Delete

  2. 이제 main 브랜치만 남김

✅ 4단계. Main브랜치를 제외한 새 브랜치 따로 생성해서 작업

4단계 작업을 하는 이유=메인(main)브랜치는 우리의 제품을 올리는 
최종브랜치라서 절대로 건들이면 안된다. 
그래서 메인브랜치의 내용을 유지한채
메인브랜치와 별개인 새 브랜치를 생성해서 우리가 변경작업을 할거다

미션: 새로운 작업 브랜치 만들기 (예: 성명/order)

  1. Git Repositories 뷰에서 Branches > Local 우클릭

  2. Create Branch → 브랜치 이름 입력 (예: 홍길동/order)

  3. 브랜치 체크아웃(자동 전환됨)

  4. src 폴더에서 order 패키지 생성

  5. Test.java 생성하고 내용 작성

✅ 5단계. 커밋 & 푸시

커밋하기

  1. 작업한 파일 우클릭 → Team → Commit

  2. 커밋 메시지 작성 (예: order 기능 추가)

  3. 커밋 클릭

푸시하기

  1. Git Staging 뷰에서 Commit and Push 또는

  2. 프로젝트 우클릭 → Team → Push to Upstream

→ 내 origin(포크된 저장소)으로 올라감

✅ 6단계. GitHub에서 Pull Request 보내기

  1. GitHub 내 origin 저장소 접속

  2. Compare & pull request 클릭

  3. 팀장님의 저장소(main)로 Pull Request(PR) 보내기

  4. 팀장이 Merge 해주면 완료

6단계 까지가 내계정(팀원계정)의 변경내용을 팀장의 원격저장소로 보내는과정이다!

✅ 7단계. 팀장 저장소(upstream)과 동기화

다른 팀원들이 작업한 내용은 팀장 저장소에만 있음 →
upstream을 통해 내 로컬 저장소와 동기화해야 함

👉 이클립스에서 upstream 등록

  1. Git Repositories 뷰에서 저장소 우클릭 → Properties

  2. Remotes 탭에서 Add Remote

  3. 이름을 upstream으로 지정

  4. 팀장 저장소의 주소 입력 (GitHub 링크 복사)

  5. 저장

👉 upstream에서 변경된 내용 가져오기 (Fetch)

  1. Git Repositories 뷰에서 Remote > upstream 우클릭

  2. Fetch From Upstream 선택

→ 이러면 팀장님 저장소의 최신 내용이 받아짐

👉 main 브랜치로 Merge

  1. Branches > Remote Tracking > upstream/main 우클릭 → Merge

  2. 대상 브랜치로 main 선택

→ 내 로컬 main과 팀장님 main을 병합

👉 내 origin 저장소로 Push

  1. 프로젝트 우클릭 → Team → Push to Upstream

✅ 최종 구조 확인

  • origin → 내 깃허브 원격 저장소 (포크한 저장소)

  • upstream → 팀장 깃허브원격 저장소

  • 로컬 main = origin/main과 동기화

  • 업데이트가 있을 땐 always → fetch from upstream → merge → push to origin

✅ 작업 흐름 요약

1. 팀장 저장소 fork
2. 이클립스로 import
3. main 브랜치 생성 + master 삭제
4. 브랜치 따서 작업
5. 커밋 → Push
6. GitHub에서 PR → Merge
7. 팀장 저장소(upstream)에서 Fetch → Merge → Push

🎯 작업 시 주의사항

상황 주의할 점
main에서 직접 작업 ❌ 절대 금지! 반드시 새 브랜치 따로 생성해서 작업
push 하기 전 항상 fetch → merge 먼저!
충돌 발생 시 팀장과 의논 후 처리
브랜치 정리 merge 완료된 브랜치는 삭제

✅ 마무리

  • 이클립스만 써도 깃 협업 충분히 가능함!

  • 중요한 건 순서와 습관

  • origin과 upstream 구분만 정확히 해도 실수 줄일 수 있음

라벨:

댓글

댓글 쓰기

가장 많이 본 글