[project] github repository 연결하기

github에서 repository를 만들고 이 repository와 나의 local branch를 연결하는 방법을 정리해봅시다!

 

[repository를 혼자 사용하는 경우]

1. github에서 repository를 만든다

저는 이름은 gitttest로 설정하고 README file이 존재하는 repository를 만들었습니다

 

 

2. github에서 관리하고 싶은 local 폴더에 branch를 만든다

저는 index.md 파일이 들어있는 upload 폴더를 github 저장소와 연결하겠습니다

우선 branch를 만들기 위해 terminal에서 upload 파일이 있는 곳에 위치합니다

 

 

 

git init을 입력하면 main branch가 만들어집니다

 

 

main branch에서 git add .와 git commit을 진행합니다

그리고 commit된 내용을 repository로 push하기 위해 연결해봅시다

 

 

3. main branch와 나의 repository 연결하기

git remote add origin [주소] 를 입력하여 저의 repository를 연결했습니다

git remote-v를 입력 후 repository 주소가 출력된다면 잘 연결된 것입니다

 

 

 

4. branch에서 repository로 push하기

주의사항!!

저처럼 repository 생성 시 README.md를 만든 경우 우선 git pull origin main --allow-unrelated-histories를 통해 README.md 파일을 branch로 받아와야 합니다

 

pull 이후에 다시 push를 진행합니다

git push origin [branch]를 입력하면 branch의 내용이 repository로 이동합니다

 

 

 

push를 통해 repository에서 upload 폴더 안에 있던 index.md 파일을 확인할 수 있습니다

 

---

 

위와 같이 혼자 repository를 사용하는 경우 main branch에서 직접 작업할 수 있지만, 여럿이서 repository를 사용하는 경우 main branch가 아니라 새로운 branch를 만들어서 거기에서 작업을 해야 합니다

main branch에서 작업을 하다가는 함께 작업한 코드를 제가 날려먹을 수 있기 때문이죠

 

[repository 여럿이서 사용하는 경우]

1. 내가 작업할 새로운 branch 만들기

git branch [branch이름]을 통해 새로운 branch를 만들고,

git checkout [branch이름]을 입력하여 새로운 branch로 이동합니다

 

 

main branch에 이미 repository를 연결해주었기 때문에 새로운 branch에서 다시 연결해줄 필요가 없습니다

git remote -v를 통해 이미 repository가 연결되어 있음을 확인할 수 있습니다

 

 

 

2. add commit push하기

그리고 파일의 내용을 수정한 후에는 agent1에서

git add .

git commit -m "메세지 내용"

git push origin [branch이름] -> 저는 현재 agent1에서 작업하고 있기 때문에 git push origin agent1을 입력합니다

 

그러면 repository에서 push가 이뤄졌음을 확인할 수 있습니다

 

 

3. pr 메세지 작성하기

agent1은 main branch가 아니기 때문에 push한 내용이 바로 repository로 올라가지 않습니다

compare & pull request 버튼을 눌러 pr 메세지를 작성해줍니다

우측의 labels를 활용하여 pr 메세지의 상태를 쉽게 알아볼 수 있게 해줍니다

 

 

그리고 나서,

해당 repository의 관리자가 agent1의 push 내용을 main으로 pull할지 결정합니다

pull한다면 merge pull request를 누릅니다

 

 

4. local main 최신화하기

내 branch에서 github main(origin)으로 push했던 내용을 내 main에도 적용시켜 최신화해줘야 합니다

 

우선 터미널에서 위치를 다시 나의 main 폴더로 이동하고,

git checkout main

 

최신화해줍니다

git pull origin main

 

5. github의 main에서 파일이 수정된 경우

우선 pull을 통해 내 local main에 가져옵니다

git pull origin main

 

그리고 local main과 branch를 맞춰주기 위해 branch로 이동 후 branch에 merge해줍니다

git checkout [branch이름]

git merge main -> main 자리에는 merge 해올 branch의 이름을 넣으면 됩니다

 

 

+ branch에 repository 복제하기

추가로 repository의 파일을 내 branch로 복제해오는 방법입니다

 

git clone [repository 주소]를 입력하면 repository의 파일을 복제해올 수 있습니다

제 upload 폴더를 확인해보면 gittest라는 이름의 폴더가 복제된 것을 확인할 수 있습니다