로컬 프로젝트 GitHub에 올리는 방법

Git과 GitHub 

git은 코드 버전 관리 도구이고, github는 git 저장소를 클라우드에 호스팅하는 서비스이다. 이를 통해 로컬에서 작성한 코드를 원격에 저장하고, 협업과 백업이 용이해진다.

본 포스팅은 로컬 프로젝트를 github에 올리는 과정을 단계별로 설명한다.

 

1. github에 레포지토리 생성하기

먼저 github에서 프로젝트를 올릴 리포지토리를 생성한다.

1) github에 접속하여 로그인한다.

2) 오른쪽 상단의 + 아이콘을 클릭한 뒤, new repository를 선택한다.

3) 레포지토리 이름을 입력하고, 공개(public) 또는 비공개(private)를 선택한다.

4) Create repository 버튼을 클릭하여 레포지토리를 만든다.

 

2. 로컬 프로젝트에 Git 초기화하기

로컬에서 작업 중인 프로젝트 폴더를 git으로 관리하려면 먼저 git을 초기화해야 한다.

1) 터미널을 열고 프로젝트 폴더로 이동한다.

cd /path/to/project

 

2) git 초기화를 한다.

git init

이 명령은 해당 폴더에 .git 폴더를 생성하여, git이 폴더 내 파일들을 추적하도록 한다.

 

3. 원격 레포지토리 연결하기

github에서 생성한 레포지토리와 로컬 프로젝트를 연결한다.

1) github 레포지토리 페이지에서 URL을 복사한다. (https나 SSH URL 선택 가능)

2) 아래 명령어로 원격 레포지토리를 로컬 프로젝트에 추가한다.

git remote add origin https://github.com/username/repository.git

 

4. 파일 스테이징하고 커밋하기

Git에서 파일을 스테이징하고 커밋하는 과정을 통해 변경 내용을 기록할 수 있다.

1) 모든 변경된 파일을 스테이징 영역에 추가한다.

git add .

 

(특정 파일만 추가하려면 git add 파일이름 형태로 사용한다.)

 

2) 변경 사항을 커밋하여 git에 기록한다.

git commit -m "Initial commit"

 

-m 옵션을 통해 커밋 메세지를 함께 입력한다. 커밋 메세지는 변경사항을 간략히 설명하는 것이 좋다.

 

5. GitHub에 푸시하기

로컬의 커밋 내용을 github 원격 레포지토리에 업로드한다.

1) 아래 명령어로 로컬 커밋을 github에 푸시한다.

git push -u origin main

(main 대신 master 브랜치를 사용할 수도 있다. Github에서 설정된 기본 브랜치를 확인해야 한다.)

 

2) 이후에는 git push만 입력해도 된다. -u 옵션은 이후 푸시를 단순화하기 위한 설정이다. 

 

6. 이후 변경 사항을 github에 업데이트한다.

프로젝트를 수정할 때마다 다음 절차로 github에 반영할 수 있다.

1) 파일 변경: 프로젝트 파일을 수정한다.

2) 스테이징: git add . 로 변경된 파일을 스테이징한다.

3) 커밋: git commit -m "변경 내용"으로 커밋한다.

4) 푸시: git push로 원격 레포지토리에 반영한다.

 

이 과정을 통해서 github에 안전하게 코드를 올리고, 프로젝트를 백업할 수 있다.