Fork 기반 협업에서 헷갈리기 쉬운 ... (컨트리뷰션할 때 주의)

 

로컬 main이 origin(main)과 up to date라고 해서 반드시 원본(kubernetes/website)의 최신 상태와 같다는 보장은 없다는 것이다.
그래서, PR을 올리기 전에 원본 저장소의 최신 커밋을 반영하는 것이 좋다.

1. 포크 레포지토리와 원격 저장소 관계

`kubernetes/website`는 원본 레포지토리이고, `Eundms/website`는 이를 포크한 저장소이다.
로컬에서는 `Eundms/website`를 `origin`이라는 이름으로 연결해두고 작업을 진행한다.

즉, 구조를 단순화하면 다음과 같다.

```
원본(upstream) : kubernetes/website
포크(origin)  : Eundms/website
로컬(local)   : 내 PC 저장소
```

 

2. 로컬 main과 포크 main의 관계

 

로컬 저장소의 main 브랜치를 origin/main과 동기화시키면, 포크 저장소(`Eundms/website`)의 main 브랜치와는 일치한다.
그러나 이 과정만으로는 원본 저장소(kubernetes/website)의 최신 커밋까지 자동으로 반영되지는 않는다.

따라서 `Eundms/website` 레포지토리 자체가 원본보다 뒤처질 수 있다. 
이 때문에 로컬 main이 origin/main과 같더라도, 실제로는 `upstream/main`과는 다를 수 있다.

3. 원본 레포지토리와 동기화하는 방법

이 문제를 해결하기 위해서는 원본 저장소(`kubernetes/website`)를 `upstream`이라는 이름으로 추가한 뒤, 주기적으로 최신 내역을 가져와야 한다.

흐름은 다음과 같다.

1. upstream remote 추가

git remote add upstream https://github.com/kubernetes/website.git

2. 원본 최신 내역 가져오기

git fetch upstream

3. 로컬 main 브랜치를 원본과 동기화

git checkout main
git merge upstream/main

4. 포크 저장소에도 반영

 

git push origin main

이 과정을 거치면 로컬 → 포크(origin) → 원본(upstream)까지 모두 최신 상태로 맞출 수 있다.