1. 로컬 Git만으로는 부족한 이유
로컬에서 Git으로 버전 관리를 하면 이전 상태로 되돌리는 것은 가능합니다. 하지만 내 컴퓨터가 고장 나면 모든 이력이 사라집니다. 팀원과 같은 코드를 공유하려면 USB나 이메일로 보내야 합니다.
GitHub에 코드를 올리면 인터넷 어디서든 접근할 수 있고, 팀원과 실시간으로 협업할 수 있으며, 코드가 클라우드에 안전하게 백업됩니다.
2. GitHub 저장소 만들기
github.com에서 로그인 후 오른쪽 상단 + 버튼 > New repository를 클릭합니다.
저장소 이름을 입력합니다. Description에 간단한 설명을 작성합니다. Public(공개)과 Private(비공개) 중 선택합니다. Create repository를 클릭합니다.
처음 만들면 빈 저장소 페이지가 나타나고 로컬 저장소와 연결하는 안내가 표시됩니다.
3. 로컬 저장소와 원격 저장소 연결하기
GitHub 저장소 페이지에서 Code 버튼을 클릭하면 HTTPS URL을 확인할 수 있습니다.
로컬 터미널에서 원격 저장소를 origin이라는 이름으로 등록합니다.
git remote add origin https://github.com/사용자명/저장소명.git
등록이 잘 됐는지 확인합니다.
git remote -v
origin이라는 이름은 관례적인 이름입니다. 다른 이름을 써도 되지만 대부분 origin을 사용합니다.
4. push – 내 코드를 GitHub에 올리기
로컬에서 커밋한 내용을 원격 저장소로 올립니다.
처음 push할 때는 브랜치 이름을 명시합니다.
git push -u origin main
-u 옵션은 이후부터 git push만 입력해도 origin main으로 push되도록 설정합니다.
이후 push는 아래처럼 간단하게 입력합니다.
git push
GitHub 저장소 페이지를 새로고침하면 올라간 파일을 확인할 수 있습니다.
5. clone – 원격 저장소를 내 컴퓨터로 복사하기
다른 사람의 저장소를 가져오거나, 내 저장소를 새 컴퓨터에 내려받을 때 clone을 사용합니다.
git clone https://github.com/사용자명/저장소명.git
clone하면 해당 폴더가 생성되고 전체 커밋 이력까지 포함해 내려받습니다. 자동으로 origin이 원격 저장소로 등록됩니다.
6. pull – 최신 변경 사항 가져오기
팀원이 코드를 수정하고 push했다면 내 로컬에는 반영되지 않습니다. pull 명령어로 원격의 최신 내용을 가져옵니다.
git pull origin main
또는 단축형으로 사용합니다.
git pull
팀 프로젝트에서는 작업을 시작하기 전 항상 pull을 먼저 하는 습관이 중요합니다. 그래야 내가 최신 코드 위에서 작업하고 나중에 충돌을 최소화할 수 있습니다.
7. .gitignore – GitHub에 올리면 안 되는 파일 제외하기
모든 파일을 GitHub에 올리면 안 됩니다. 특히 아래 파일들은 반드시 제외해야 합니다.
비밀번호, API 키가 담긴 .env 파일, node_modules 같은 의존성 폴더(용량이 크고 재설치 가능), 빌드 결과물, 운영체제가 자동 생성하는 .DS_Store 파일 등입니다.
프로젝트 루트에 .gitignore 파일을 만들고 제외할 파일 패턴을 작성합니다.
.env node_modules/ dist/ .DS_Store *.log
gitignore.io 사이트에서 사용 언어와 프레임워크를 입력하면 적합한 .gitignore를 자동 생성해줍니다.
8. 정리 및 다음 단계
오늘 배운 핵심을 정리합니다.
- GitHub에 저장소를 만들고
git remote add origin URL로 로컬과 연결합니다. git push로 코드를 GitHub에 올리고git pull로 최신 내용을 가져옵니다.git clone으로 원격 저장소를 내 컴퓨터에 복사합니다.- .gitignore로 민감한 파일이나 불필요한 파일을 제외합니다.
다음 글에서는 Git 브랜치를 활용한 협업 방식을 알아보겠습니다.