GitHub에 새 레포지토리 생성하고 로컬과 연결하는 방법

Github로 새로운 프로젝트 생성을 위해서는 몇가지 설정이 필요합니다. 아래의 순서를 통해서 이미 생성된 프로젝트의 폴더를 레파지토리로 등록해주세요.

개발자라면 GitHub을 활용한 코드 관리는 필수적인 스킬입니다. 이 글에서는 GitHub에 새 레포지토리를 생성하고 로컬 환경과 연결하는 전체 과정을 단계별로 살펴보겠습니다.

1. GitHub 계정 및 사전 준비물

시작하기 전에 필요한 것들:

• GitHub 계정 (없다면 github.com에서 가입)
• 로컬 컴퓨터에 Git 설치 (git-scm.com에서 다운로드)
• 기본적인 터미널/명령 프롬프트 사용법

2. GitHub에 새 레포지토리 생성하기

1. GitHub에 로그인합니다.
2. 우측 상단의 ‘+’ 아이콘을 클릭한 후 ‘New repository’를 선택합니다.
3. 레포지토리 생성 페이지에서 다음 정보를 입력합니다:
   • Repository name: 프로젝트 이름 (예: my-awesome-project)
   • Description: 프로젝트 설명 (선택 사항)
   • Public/Private: 공개/비공개 설정
   • README 파일 생성 여부 선택 (초기 프로젝트라면 체크 권장)
   • .gitignore 파일 추가 여부 (프로젝트 유형에 맞게 선택)
   • 라이센스 선택 (필요시)
4. ‘Create repository’ 버튼을 클릭하여 새 레포지토리를 생성합니다.

3. 로컬 레포지토리와 GitHub 연결하기

3-1. 새 프로젝트 시작하는 경우

GitHub에서 레포지토리를 생성한 후, 로컬 환경에서 다음 단계를 따릅니다:

1. 터미널/명령 프롬프트를 열고 프로젝트를 저장할 디렉토리로 이동합니다.
   cd 원하는/디렉토리/경로
2. GitHub에서 레포지토리 주소를 복사합니다 (녹색 ‘Code’ 버튼 클릭).
3. 로컬에 레포지토리를 복제합니다.
   git clone https://github.com/사용자이름/레포지토리이름.git
4. 복제된 디렉토리로 이동합니다.
   cd 레포지토리이름
5. 이제 파일을 추가/수정하고 변경사항을 커밋한 후 푸시할 수 있습니다.
   # 파일 수정 후
git add .
git commit -m "Initial commit"
git push origin main

3-2. 기존 프로젝트를 GitHub에 연결하는 경우

이미 로컬에서 작업 중인 프로젝트가 있다면:

1. 터미널/명령 프롬프트를 열고 프로젝트 디렉토리로 이동합니다.
   cd 기존/프로젝트/경로
2. Git 저장소를 초기화합니다.
   git init
3. 파일을 스테이징하고 첫 번째 커밋을 생성합니다.
   git add .
git commit -m "Initial commit"
4. GitHub 레포지토리를 원격 저장소로 추가합니다.
   git remote add origin https://github.com/사용자이름/레포지토리이름.git
5. 로컬 변경사항을 GitHub에 푸시합니다.
   # GitHub의 기본 브랜치가 main인 경우
git branch -M main
git push -u origin main

4. 기본적인 Git 명령어

GitHub과 로컬 레포지토리를 연결한 후 자주 사용하는 명령어:

• 상태 확인:
  git status
• 변경사항 스테이징:
  git add 파일명
  또는 모든 파일은
  git add .
• 커밋하기:
  git commit -m "커밋 메시지"
• 원격 저장소에 푸시:
  git push origin 브랜치명
• 원격 저장소에서 변경사항 가져오기:
  git pull origin 브랜치명
• 브랜치 생성:
  git branch 브랜치명
• 브랜치 전환:
  git checkout 브랜치명
  또는
  git switch 브랜치명

5. SSH 키 설정 (선택 사항)

HTTPS 대신 SSH를 사용하여 더 안전하게 GitHub에 연결하려면:

1. SSH 키 생성:
   ssh-keygen -t ed25519 -C "your_email@example.com"
2. SSH 에이전트에 키 추가:
   eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519
3. 공개 키를 GitHub 계정에 추가:
   • cat ~/.ssh/id_ed25519.pub 명령어로 키 내용 확인
   • GitHub 설정 → SSH and GPG keys → New SSH key에서 키 추가
4. SSH URL로 원격 저장소 설정:
   git remote set-url origin git@github.com:사용자이름/레포지토리이름.git

마무리

이제 GitHub 레포지토리와 로컬 환경이 연결되었습니다. 코드 변경사항을 커밋하고 푸시하여 프로젝트를 관리할 수 있습니다. Git과 GitHub는 버전 관리와 협업에 있어 강력한 도구이므로 지속적으로 사용하며 익숙해지는 것이 좋습니다.

더 자세한 내용은 GitHub 공식 문서나 Git 공식 문서를 참조하세요.