Git 사용법 - 내 프로젝트를 로컬저장소 및 원격저장소에 저장하기

 

Git 사용법 - 내 프로젝트를 로컬저장소 및  원격저장소에 저장하기

 

 

   목차 

1. Git 설치 및 초기 설정
2. Git 로컬 저장소 생성 및 사용법
3. Git 원격 저장소 생성 및 사용법
4. 에러 발생시 참고사항

 

 

1. Git 설치 및 초기 설정

 

1) 먼저 Git을 다운로드 받아 설치합니다. (자세한 내용은 아래 링크 참조)

 

2021.12.03 - [IT 개발/Git] - Git 다운로드 및 설치하기

Git 다운로드 및 설치하기

 

 

2) Git 설치가 완료되었으면, 우클릭 후 Git Bash에서 초기 사용자 정보를 등록해줍니다. (자세한 내용은 아래 링크 참조)

[사용자 이름 및 이메일 등록]
git config --global user.name "MyName"
git config --global user.email myemail@gmail.com

[설정 정보 확인하기]
git config --list

 

2023.04.22 - [IT 개발/Git] - Git 설치후 초기 설정하기 (사용자 정보 등록, git config)

Git 설치후 초기 설정하기 (사용자 정보 등록, git config)

 

 

 

2. Git 로컬 저장소 생성 및 사용법

 

1) Git Bash 창에서 git을 사용할 프로젝트의 폴더위치로 이동합니다. 

• 해당 폴더위치에서 우클릭후 Git Bash 창을 열면 해당 위치에서 Git Bash창이 열립니다. 

 

2) Git Bash 창에서 아래 명령어를 차례대로 입력합니다. 

• 아래 명령어를 입력하게 되면 현재 프로젝트가 git 로컬 저장소에 기록됩니다. 

git init			// 해당 폴더를 저장소로 지정합니다. (.git폴더 생성됨)
git status 			// git 상태 확인 (확인용으로 안해도 됨)

git add . 			// 해당 폴더의 모든 파일을 git 저장소에 등록합니다. 
git status 			// git 상태 확인 (확인용으로 안해도 됨)

git commit -m "First Commit"	// 수정사항을 저장소에 기록합니다.
git log				// commit history 확인

 

 

 

3. Git 원격 저장소 생성 및 사용법

 

1) GitHub 또는 GitLab에 가입 후 원격저장소로 사용할 프로젝트를 생성합니다. 

• 예제에서는 GitLab를 사용하도록 하겠습니다. (GitHub도 비슷합니다.)

 

2) 원격저장소가 생성되었으면 Git Bash 창에서 아래 명령어를 차례대로 입력합니다.

• 아래 명령어를 입력하게 로컬저장소와 동기화되어 원격 저장소에 저장됩니다

git remote add origin https:원격저장소url주소
git branch -M main				// 로컬저장소 branch 이름 변경
git push -uf origin main 			// 로컬저장소의 내용을 원격저장소에 저장

• (참고) 여기서 git의 branch 이름을 기존 master에서 main으로 변경하는 이유는 master라는 이름이 slave/master의 노예를 떠올리기 때문에 main으로 보통 바꾸어 사용합니다.

정상적으로 진행되었으면 GitLab 원격저장소에 내 프로젝트의 소스파일들이 올려져 있는 것을 확인하실 수 있습니다. 

만약 에러가 발생한다면 아래 "4. 에러 발생시 참고사항"을 확인해 보시기 바랍니다. 

 

 

 

4. 에러 발생시 참고사항

 

1) 원격저장소에  push가 안되는 경우

• 먼저 아래와 같이 pull로 로컬저장소와 원격저장소의 상태를 맞춰줍니다. 

git pull origin main

 

2) pull도 안되는 경우

• 만약 "--fatal: refusing to merge unrelated histories"와 같은 Error 메세지가 나타나면서 pull이 되지 않는다면 아래 명령어를 실행합니다. 그러면 로컬저장소와 원격저장소의 history가 다 저장되는데 보통 처음에 원격저장소에 readme파일 생성후 로컬저장소와 처음 동기화 할 때 이러한 문제를 겪는 경우가 많습니다. (왜냐하면 로컬저장소에는 readme파일이 없는 상태로 소스파일만 존재하고 원격저장소에는 소스파일 없이 readme 파일만 존재하기 때문에 이 부분을 처리해 주어야 합니다.)

git pull origin main --allow-unrelated-histories