Git & GitHub #2 - Git 시작과 Local/Remote Branch 관리

git commit -m "Blog Posting #2🫡"
개발자협업의 필수 도구 

---

Git과 Github를 사용하여 프로젝트를 관리하는 방법은 로컬 저장소에서 시작하거나, 원격 저장소에서 시작하는 것이다. 이 두 가지 방법에 대해 알아보자.

 

Local Repository에서 시작: 초기 시작

로컬에서 프로젝트를 시작한 후, 이를 원격 저장소(GitHub)에 업로드하는 과정이다. 로컬에서 직접 Git 저장소를 초기화하고, 이후 원격 저장소와 연결하여 작업을 관리할 수 있다.

 

아래와 같이 수행한다.

 

1. 로컬에서 Git 저장소 초기화

• `git init`:현재 내 디렉토리를 Git으로 관리하겠다는 선언 = `.git` 디렉토리 생성

git init

 

 

2. 기본 브랜치 이름 변경

• 초기화된 Git 저장소에서 기본 브랜치의 이름을 `main`으로 변경한다.

git branch -M main

`master`가 아닌 `main`이라는 비차별적인 명칭을 사용하는 것이 일반적이다.

 

3. 원격 저장소 추가 및 연결

• GitHub에서 새 저장소를 생성한 후, 로컬 저장소와 연결한다.

git remote add orgin git@github.com:SangHyun-e/git-tutorial.git

`origin`은 원격 저장소의 별칭 → 이후 이 이름을 사용하여 원격저장소와 소통하게 된다.

GitHub에서 repository 생성하는 폼.

4. 로컬 커밋을 원격 저장소로 푸시

• 로컬에서의 작업을 원격저장소에 업로드(Github Repository 타겟에 발사 = Push)

git push -u origin main

로컬 `main`브랜치를 원격 `main` 브랜치와 연결하고 첫 번째 푸시를 실행한다.

---

원격 저장소에서 시작: 가져오기 - 협업, 현업에서 일반적인 방식

이는 원격 저장소(Github)에서 프로젝트를 먼저 생성한 후, 이를 로컬로 클론(clone)하여 시작하는 방식이다.

협업이나 현업에서 많이 사용하는 방식으로 이미 다른 개발자가 작업해둔 코드를 가져와 이어서 개발할 수 있다.

 

아래와 같이 수행한다.

 

1. GitHub에서 새 저장소 생성

• GitHub에서 새로운 프로젝트 저장소를 생성한다.
• 저장소를 생성할 때, 옵션에 따라 `README`파일이나 `.gitignore`파일 등 초기화 가능.

저장소 생성(README file 초기화)

2. 로컬에서 원격 저장소 클론

git clone git@github.com:SangHyun-e/git-tutorial.git

원격 저장소의 내용을 로컬로 복제하여, 프로젝트를 시작할 수 있는 환경을 만들어준다.

 

---

Remote 주소 관리 및 Local/Remote Branch 관리

Git에서 모든 것은 크게 Local(로컬, Git)과 Remote(원격, Github)로 나눠 생각하면 된다.

• Remote(Github): 여러 사람들의 작업들이 모두 모여있음.
• Local(Git): 내 작업이 모여있고, Remote(Github)에 있는 다른 개발자의 참조(Ref)도 가지고 있다.
  • Remote 주소관리: 코드를 어디에서 다운로드할지(fetch) / 코드를 어디로 업로드할지(push)
  • Branch 관리: Local Branch CRUD / Remote Branch CRUD - 모든 브랜치 로컬서 관리 가능

 

Remote 주소 관리 - CRUD

1. Remote 조회

git remote -v

현재 로컬 저장소에 연결된 원격 저장소의 정보를 조회할 수 있다.

• `-v = verbose: 상세출력` (어원 verbose: 말많은, 상세한, 구구절절)

2. Remote 추가

git remote add orgin git@github.com:SangHyun-e/git-tutorial.git

원격 저장소를 추가할 수 있다. `origin`이라는 별칭으로 저장소를 등록한다.

• `origin`: Alias

3. Remote 수정

git remote set-url origin git@github.com:SangHyun-e/git-tutorial.git

기존에 등록된 원격 저장소의 URL을 변경할 수 있다.

• 전체 변경: `git remote set-url origin git@github.com:SangHyun-e/git-tutorial.git`
• 일부 변경: `git remote set-url --push origin git@github.com:SangHyun-e/git-tutorial.git`

4. Remote 삭제

git remote remove origin

등록된 원격 저장소를 삭제한다.

Branch 관리

로컬에서의 명령어를 통해 원격 Remote 브랜치 & 로컬 Lopcal 브랜치를 모두 관리 할 수 있다.

Git에서는 기능별로 혹은 개발하는 개발자별로 다수의 Branch로 구성할 수 있다.

• Remote에서 Branch를 가져오는 방법: `git fecth -p` → `-p = prune`
  • Remote에서 삭제된 브랜치는 Local 브랜치에서도 지워야함.

 

Branch 관리 명령어 - CRUD

 

1. Branch 생성

git checkout -b new-branch-name

새로운 브랜치를 생성하고 그 브랜치로 이동한다.

• 기준이 되는 브랜치에서 새로운 브랜치를 생성하는 것이기 때문에 저 명령어를 어느 브랜치에서 입력하냐가 중요하다.

2. Branch 삭제

git branch --delete branch-name

git branch -D branch-name

로컬 브랜치를 삭제한다.

• `--delete`: 삭제(현재 브랜치가 어디에도 머지되지 못했따면 경고와 함께 삭제되지 않음)
• `-D`: 강제 삭제

3. 원격 Branch 삭제

git push origin --delete branch-name

원격 저장소의 브랜치를 삭제한다.

• `origin`: 원격 주소(Github Repository 주소)에 대한 Alias 
• `branch-name`: 삭제하고자하는 브랜치명

4. Branch 조회

git branch -a

로컬 및 원격 저장소의 모든 브랜치를 조회할 수 있다.

• `git branch -r` → `-r = remote`: 원격 Remote Branch 조회
• `git branch -l` → `-l = lcoal`:로컬 Local Branch 조회
• `git branch -a` → `-a = all`: 원격 로컬 Branch 모두 조회

 

---

Branch에 대해 더 자세히 알고싶다면 Git 공식문서 (아래링크)를 참고하자 !

https://git-scm.com/book/ko/v2/Git-%EB%B8%8C%EB%9E%9C%EC%B9%98-%EB%B8%8C%EB%9E%9C%EC%B9%98%EB%9E%80-%EB%AC%B4%EC%97%87%EC%9D%B8%EA%B0%80

Git - 브랜치란 무엇인가

---

이번 포스팅에선 Git을 시작하는 두 가지 방법 (로컬에서 시작, 원격에서 시작)과 Remote 주소관리, Local과 Remote의 Branch 관리에 대해 알아보았다.

 

다음 포스팅에선 Local Branch에 Remote Branch를 동기화하는 방법과 동기화시 Conflict(충돌) 해결 방법에 대해 알아볼 예정이다.

 

---

 

ℹ️참고

[ASAC 6기 강의자료]

 

Git 공식문서 https://git-scm.com/book/ko/v2/Git-%EB%B8%8C%EB%9E%9C%EC%B9%98-%EB%B8%8C%EB%9E%9C%EC%B9%98%EB%9E%80-%EB%AC%B4%EC%97%87%EC%9D%B8%EA%B0%80

Git - 브랜치란 무엇인가