☁️ GitHub로 원격 저장소 연결 및 푸시(push) 완전 정복

---

이전까지는 내 컴퓨터 안(local) 에서만 Git을 다뤘다.
이제는 그 코드를 온라인 저장소(GitHub) 로 올려서
다른 사람과 협업하고, 백업하고, 어디서든 접근할 수 있게 해보자.

이번 글에서는 GitHub 계정 연동 → 원격 저장소(remote) 생성 → push/pull 실습
순서로 단계별로 배워본다.

---

💡 1. GitHub란?

“Git을 기반으로 한 전 세계 개발자들의 코드 공유 플랫폼”

Git은 버전 관리 도구,
GitHub은 그 버전들을 온라인에서 관리할 수 있는 클라우드 서비스다.

구분 Git GitHub

역할	버전 관리 프로그램	코드 저장 및 협업 플랫폼
위치	로컬(내 컴퓨터)	원격(클라우드)
예시 명령	git commit	git push, git pull

💬 즉,

“Git이 책이라면, GitHub은 그 책을 꽂아두는 온라인 도서관이다.”

---

⚙️ 2. GitHub 계정 생성 및 SSH 설정

1. https://github.com 접속
2. Sign Up → 이메일 등록
3. 사용자명(User Name)과 비밀번호 설정

💡 SSH를 설정하면 비밀번호 없이 안전하게 연결할 수 있다.

# SSH 키 생성 
ssh-keygen -t rsa -b 4096 -C "kibeom@example.com" 
 
# 생성된 공개키 확인 
cat ~/.ssh/id_rsa.pub 

GitHub > Settings → SSH and GPG Keys → New SSH Key
→ 위의 공개키 붙여넣기

✅ 이렇게 하면 터미널에서 git push 할 때 로그인할 필요가 없다.

---

🧱 3. 새 저장소(Repository) 만들기

GitHub 홈 → 오른쪽 상단 + → New repository 클릭

1. Repository name: git-practice
2. 선택 항목:
   • ✅ Public (공개 저장소)
   • ❌ Initialize with README (체크 해제 — 직접 push할 예정)
3. Create repository

✅ 저장소가 생성되면 다음과 같은 URL이 나온다:

https://github.com/kibeom/git-practice.git 

이 주소가 바로 원격 저장소(remote) 주소다.

---

🧩 4. 로컬과 원격 저장소 연결하기

이제 내 컴퓨터의 Git 폴더를
방금 만든 GitHub 저장소와 연결하자.

# 내 로컬 저장소에서 
git remote add origin https://github.com/kibeom/git-practice.git 

연결 확인 👇

git remote -v 

✅ 결과

origin  https://github.com/kibeom/git-practice.git (fetch) 
origin  https://github.com/kibeom/git-practice.git (push) 

💬 origin은 GitHub 저장소의 별칭이다.
즉, “origin = GitHub 저장소”라고 이해하면 된다.

---

🚀 5. 첫 푸시(push)

이제 내 코드를 GitHub에 올려보자 👇

git push -u origin main 

✅ 결과

Enumerating objects: 3, done. 
Counting objects: 100% (3/3), done. 
Writing objects: 100% (3/3), 245 bytes | 245.00 KiB/s, done. 
To https://github.com/kibeom/git-practice.git 
 * [new branch]      main -> main 

이제 브라우저에서 https://github.com/kibeom/git-practice
접속하면 내 코드가 올라와 있을 것이다.

💬 -u 옵션은 “이후부터는 git push만 써도 자동 연결하겠다”는 의미다.

---

🔄 6. 변경 후 다시 push하기

파일 수정:

echo "// 수정한 코드입니다." >> index.js 
git add . 
git commit -m "코드 수정" 
git push 

💡 이제 별도 옵션 없이 git push만 해도 자동으로 원격 반영된다.

✅ 결과
GitHub 페이지를 새로고침하면
커밋 메시지와 함께 변경된 코드가 반영되어 있을 것이다.

---

🧠 7. git pull — 원격 변경 가져오기

다른 컴퓨터나 팀원이 수정한 코드를 가져오려면
git pull을 사용한다.

git pull origin main 

💬 push는 업로드, pull은 다운로드다.
서로의 작업을 주기적으로 동기화해야 충돌이 없다.

---

🧩 8. git clone — 다른 저장소 복제하기

다른 사람의 프로젝트를 내 로컬에 복제하고 싶다면:

git clone https://github.com/username/project.git 

✅ 결과

Cloning into 'project'... 
done. 

이 명령으로 GitHub의 모든 버전 이력을 그대로 가져온다.
즉, 다른 사람의 저장소를 내 컴퓨터에 복사하는 것이다.

---

⚡ 9. 협업 시 필수 흐름 요약

git clone → git branch → git add/commit → git push → git pull 

💡 팀 협업 시 규칙

• 작업 전 반드시 git pull
• 작업 후 꼭 git push
• 충돌(conflict) 시 직접 수정 후 커밋

“Git은 혼자 코딩하는 게 아니라, 팀으로 개발하는 도구다.”

---

🧩 10. 원격 저장소 관련 주요 명령어 요약

명령어 설명

git remote -v	원격 저장소 목록 확인
git remote add origin <URL>	원격 저장소 연결
git push origin main	원격 저장소로 업로드
git pull origin main	원격 저장소에서 가져오기
git clone <URL>	저장소 복제
git remote remove origin	원격 연결 해제

---

🏁 마무리 — “GitHub는 개발자의 포트폴리오다”

GitHub는 단순한 백업 공간이 아니다.
당신이 얼마나 꾸준히, 체계적으로 개발하는지 보여주는
개발자의 “이력서”이기도 하다.

✅ 앞으로 모든 프로젝트는
git init → remote add → push
이 3단계를 필수 습관으로 만들자.

💬 “코드를 짜는 사람은 많지만,
코드를 관리할 줄 아는 사람은 드물다.”

다음 편에서는
✅ 되돌리기(reset, revert, restore)로
실수를 복구하는 법을 배워보자.

---