Git 프로젝트 GitHub 업로드(Push) 방법

이번 글에서는 Git 프로젝트를 GitHub 저장소에 업로드(Push)하는 방법에 대해 알아보겠다.

 

Git과 GitHub를 처음 사용하는 경우라면 프로젝트를 GitHub에 업로드하는 과정이 다소 어렵게 느껴질 수 있다.

 

하지만 Git 저장소를 생성하고 몇 가지 명령어만 실행하면 손쉽게 프로젝트를 GitHub에 업로드할 수 있다.

 

업로드 전 준비사항

먼저 다음 작업이 완료되어 있어야 한다.

• Git 설치 및 초기 설정 완료
• GitHub 회원가입 완료
• GitHub 저장소(Repository) 생성 완료

또한 Git으로 관리할 프로젝트가 미리 준비되어 있어야 한다. 프로젝트는 VS Code, PyCharm, IntelliJ 등 어떤 개발 환경에서 생성했더라도 Git 명령어는 동일하게 사용할 수 있다.

 

아직 준비되지 않았다면 아래 글을 먼저 참고하자.

 

▶ Git 설치 방법 및 초기 설정하기

 

▶ GitHub 회원가입 및 저장소(Repository) 생성하기

 

프로젝트 폴더 이동

명령 프롬프트(CMD), PowerShell 또는 Git Bash를 실행한 뒤 프로젝트 폴더로 이동한다.

 

예시

 

cd C:\MyProject

 

MyProject 폴더로 이동하기

 

Git 저장소 생성

프로젝트 폴더에서 아래 명령어를 입력한다.

 

git init

 

정상적으로 실행되면 현재 프로젝트가 Git 저장소로 초기화된다.

 

프로젝트 폴더에 .git 폴더가 생성되며, 이후부터 Git으로 버전 관리를 할 수 있게 된다.

 

Git 저장소 초기화 하기

 

Git 저장소 초기화 된 모습

 

변경 파일 추가

프로젝트의 모든 파일을 Git에서 관리할 대상으로 등록한다.

 

추후 파일을 추가하거나 수정 또는 삭제한 경우에도 git add 명령어를 실행하여 변경 사항을 커밋 대상으로 등록해야 한다.

 

git add .

 

반응형

 

첫 번째 커밋 생성

등록한 파일을 커밋한다.

 

커밋(commit)은 현재 변경된 내용을 하나의 버전으로 저장하는 작업이다. 커밋한 내용만 GitHub와 같은 원격 저장소에 업로드할 수 있다.

 

git commit -m "first commit"

 

첫 번째 커밋 생성

 

기본 브랜치(main) 설정 및 확인

기본 브랜치를 main으로 변경한다.

 

git branch -M main

 

git branch -M main은 기본 브랜치 이름을 main으로 변경하는 명령어이다.

 

왜 main으로 변경할까?

 

예전에는 Git 저장소를 만들면 기본 브랜치 이름이 master인 경우가 많았다.

 

하지만 현재는 GitHub를 비롯한 대부분의 서비스에서 기본 브랜치 이름으로 main을 사용하고 있다.

 

따라서 새 프로젝트를 GitHub에 업로드할 때도 main 브랜치를 사용하는 것이 일반적이다.

 

브랜치명을 확인하는 명령어는 다음과 같다.

git branch

 

git branch 이름 확인

 

GitHub 저장소 연결 및 확인

GitHub에서 생성한 저장소 주소를 복사한다.

 

저장소 화면에서 Code 버튼을 클릭한 뒤 HTTPS 주소를 복사한다.

 

예시

 

https://github.com/username/my-first-project.git

 

Github 저장소 주소 복사하기

 

아래 명령어를 입력하여 GitHub 저장소와 연결한다.

 

git remote add origin https://github.com/username/my-first-project.git

 

원격 저장소(Remote) 연결 확인은 다음과 같다.

 

git remote -v

 

 

Github 원격 저장소 연결 확인하기

 

GitHub 업로드(Push)

이제 프로젝트를 GitHub에 업로드한다.

 

git push -u origin main

 

처음 업로드하는 경우 GitHub 로그인을 요청할 수 있다.

 

GitHub 인증이 완료되면 프로젝트가 GitHub 저장소에 업로드된다.

 

업로드가 완료되면 이후부터는 GitHub를 통해 프로젝트를 백업하거나 다른 개발자와 협업할 수 있다.

 

정상적으로 완료되면 터미널에 업로드 완료 메시지가 출력되며, GitHub 저장소에서도 업로드된 파일을 확인할 수 있다.

 

Github 저장소에 Git 저장소 파일 업로드하기

 

업로드 확인

GitHub 저장소를 새로고침하면 프로젝트 파일이 정상적으로 업로드된 것을 확인할 수 있다.

 

정상적으로 파일이 표시된다면 GitHub 업로드가 완료된 것이다.

 

Github 빈 저장소

 

Github 저장소 업로드 파일 확인

 

이후 수정한 파일 업로드

프로젝트를 수정한 이후에는 아래 명령어만 입력하면 된다.

 

git add .

 

git status

 

git commit -m "Update project"

 

git push

 

처음 연결이 완료된 이후에는 git remote add origin과 git branch -M main 명령어를 다시 입력할 필요는 없다.

 

git status 명령어를 실행하면 현재 변경 사항과 커밋 대상에 정상적으로 등록되었는지 확인할 수 있다.

 

마무리하며

지금까지 Git 프로젝트를 GitHub 저장소에 업로드(Push)하는 방법에 대해 알아보았다.

 

GitHub에 프로젝트를 업로드하면 버전 관리뿐 아니라 프로젝트 백업과 협업도 더욱 편리하게 진행할 수 있다.

 

프로젝트를 수정한 경우에는 git add → git commit → git push 순서로 변경 사항을 계속 반영하면 된다.

 

Git에서 자주 사용하는 기본 명령어가 궁금하다면 아래 글을 참고해 보자.

 

▶ Git 기본 명령어(init, add, commit, pull, push, clone) 사용법