로컬 프로젝트를 GitHub에 업로드하는 방법

Ubuntu 또는 Windows 환경에서 로컬 프로젝트를 GitHub에 업로드할 때, Git 설정부터 푸시(push)까지의 전체 과정을 다룹니다. 이 가이드에서는 RockPaperScissors 프로젝트를 GitHub에 업로드하는 방법을 설명합니다.

프로젝트 이름은 rockpaperscissors로 했으나, 본인이 사용하는 프로젝트 명으로 수정해서 사용하시길 바랍니다. 

---

1. Git 초기 설정하기

로컬에서 Git을 사용할 때 사용자 이름과 이메일을 설정해야 합니다. 이 정보는 GitHub에서 커밋 기록을 추적하는 데 사용됩니다.

명령어 (Global 설정)

git config --global user.name "Your Name"
git config --global user.email "your-email@example.com"

• --global 옵션은 모든 Git 프로젝트에 동일한 이름과 이메일을 적용합니다.
• 특정 프로젝트에만 설정하려면 **--global**을 생략합니다:

git config user.name "Your Name"
git config user.email "your-email@example.com"

설정 확인하기

git config --global --list

이 명령어로 user.name과 user.email이 올바르게 설정되었는지 확인할 수 있습니다.

---

2. GitHub에 새로운 Repository 생성하기

1. GitHub에 로그인합니다: https://github.com
2. 오른쪽 상단의 "+" 버튼을 클릭한 후 New Repository를 선택합니다.
3. Repository 이름: rockpaperscissors
4. Public 또는 Private 중 하나를 선택하고, README 파일은 생성하지 않음으로 설정합니다.
5. Create Repository를 클릭합니다.

---

3. 로컬 프로젝트 GitHub에 연결하기

Git을 초기화하고, 원격 저장소를 GitHub에 연결합니다.

로컬 프로젝트 폴더로 이동

cd /mnt/d/qt/src/RockPaperScissors

Git 초기화 및 원격 저장소 추가

git init  # Git 초기화
git remote add origin https://github.com/your-username/rockpaperscissors.git

---

4. 파일 추가 및 첫 번째 커밋 생성

Git에서 파일을 추적하고 커밋을 생성합니다.

브랜치 생성 및 이동

브랜치 생성 후 이동:

git checkout -b [브랜치명]

 

기존 브랜치로 이동:

git checkout [브랜치명]

 

원격 저장소에 Push

처음 push 하는 브랜치의 경우:

git push --set-upstream origin [브랜치명]

 

이후 push:

git push origin [브랜치명]

 

모든 파일 추가하기

git add .

커밋 생성

git commit -m "Initial commit: RockPaperScissors project"

 

---

5. GitHub에 프로젝트 업로드 (Push)

GitHub 원격 저장소에 코드를 업로드합니다.

git branch -M main  # 브랜치 이름을 main으로 설정
git push -u origin main  # GitHub에 푸시

---

6. GitHub 로그인 및 인증 (토큰 사용)

1. GitHub에서 Personal Access Token (PAT)을 생성합니다.
2. 토큰을 복사하고, 푸시 시 인증창에 토큰을 입력합니다.
   • 사용자 이름 대신 토큰을 입력해야 할 수 있습니다.

---

7. 업로드 확인하기

브라우저에서 https://github.com/your-username/yourproject 에 접속하여 프로젝트가 제대로 업로드되었는지 확인합니다.

---

8. 이후 변경 사항 푸시하기

코드를 수정한 후 새로 커밋하고 푸시하는 방법입니다.

변경된 파일 추가 및 커밋

git add .
git commit -m "Updated game logic"

GitHub에 푸시

git push

---

문제 해결: Author Identity Unknown 오류

커밋 시 다음과 같은 오류가 발생할 수 있습니다:

Author identity unknown

*** Please tell me who you are.

이 경우, Git 사용자 정보가 제대로 설정되지 않았다는 의미입니다. 아래 명령어로 설정을 완료하세요:

git config --global user.name "Your Name"
git config --global user.email "your-email@example.com"

설정을 마친 후 다시 커밋을 시도합니다:

git commit -m "Initial commit: RockPaperScissors project"

---

정리

이 가이드를 따라하면 로컬 프로젝트를 GitHub에 성공적으로 업로드할 수 있습니다. 프로젝트의 버전 관리를 위해 Git과 GitHub를 적극 활용하세요. 필요에 따라 브랜치를 활용해 기능별 작업을 나눌 수도 있습니다.