git

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

mirabo01 2025. 11. 4. 22:04

이전까지는 내 컴퓨터 안(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)로
실수를 복구하는 법을 배워보자.