Git 원격 저장소

원격 저장소

• 저장소(Repository) 종류
  • 로컬 저장소
  • 원격 저장소
• 공동 작업을 위해서는 공유 가능한 원격 저장소가 필요
  • 원격 저장소를 통해 개인 로컬 저장소의 커밋들을 동기화함
• git이나 ssh를 이용하여 독립 서버를 만들 수도 있겠지만
• github, gitlab, bitbucket과 같은 원격 저장소 서비스를 많이 이용함
  • 개인 개발자 뿐 아니라 회사에서도 편리하기 때문에 많이 사용함
• 본 강의 자료에서는 github을 기준으로 설명함

Github

• 오픈 소스를 위한 최고의 원격 저장소
  
• 비슷한 사이트
  • Bitbucket.org, gitlab.com

Github 저장소 만들기

• Github에 계정을 만들고 로그인하고
  • 계정을 새로 만든 경우 이메일에서 계정 confirm을 반드시 해야 함
• [New repository] 녹색 버튼을 클릭
  

Github 저장소 만들기

• README, gitignore, license 파일을 같이 생성할 수도 있음
  • 주의: 기존의 로컬 저장소를 원격 저장소에 넣으려면 이 파일들을 생성하면 안됨!
    

Github 원격 저장소와 로컬 저장소 최초 동기화

• 방법1. 원격 저장소의 내용을 로컬 컴퓨터로 복제(Clone)
  • 원격 저장소 만들 때 README 파일 등 최소 1개 이상의 파일을 함께 생성
• 방법2. 로컬 저장소의 내용을 원격 저장소로 보내기
  • 원격 저장소 만들 때 어떠한 파일도 생성하게 하면 안됨

최초 동기화 방법1 - 원격 저장소 생성

• README, gitignore, license 파일을 같이 생성한 경우
  

최초 동기화 방법1 - 원격 저장소 Clone

• 일반적으로 원격 저장소를 만들고, 로컬 저장소로 복제(clone)하는 것이 간편함
• clone할 원격 주소 알아오기 (github의 경우)
  
• $git clone [원격 주소]

  $ git clone https://github.com/jyheo/test2.git
  Cloning into 'test2'...
  remote: Counting objects: 5, done.
  remote: Compressing objects: 100% (4/4), done.
  remote: Total 5 (delta 0), reused 0 (delta 0), pack-reused 0					
  Unpacking objects: 100% (5/5), done.
  Checking connectivity... done.
  $ ls test2                                 [test2라는 폴더가 새로 생성됨]
  LICENSE  README.md
  

최초 동기화 방법2 - 원격 저장소 생성과 로컬 저장소 내용 보내기

• 로컬 저장소가 이미 있는 상황
• 원격 저장소 생성 시 어떠한 파일도 생성되지 않게 함
  • 즉 원격 저장소가 비어 있는 상태
  • 로컬 저장소를 원격 저장소에 넣는 방법

    $ git remote add origin https://github.com/jyheo/test2.git
    $ git branch -M master        [현재 브랜치 이름을 master로 변경,
                                     이미 master라면 할 필요 없음]
    $ git push -u origin master   [ -u 옵션은 tracking 브랜치 연결을 위해 필요]
    

  • remote 명령은 원격 관리
  • push 명령은 로컬 저장소의 지정한 브랜치의 커밋을 원격으로 보냄
    • 이 예에서는 로컬 master 브랜치를 원격 origin의 master 브랜치로 보냄

원격 저장소 확인

• $ git remote -v

  $ git remote -v
  origin  https://github.com/jyheo/test2.git (fetch)
  origin  https://github.com/jyheo/test2.git (push)
  

  • fetch 는 원격 저장소에서 로컬로 변경 이력을 가져 오는 것
  • push 는 로컬저장소에서 원격 저장소로 변경 이력을 보내는 것
  • 보통 fetch와 push 주소는 동일하지만, 특별한 경우 다를 수도 있음
    • code review system을 쓰는 경우
  • $ git remote add 를 이용하여 원격 저장소를 추가할 수도 있음
• git clone을 한 경우 origin이란 이름으로 원격 저장소가 자동으로 지정됨

원격 브랜치 Remote Branch

• $ git branch -a

  $ git branch -a
  * master
  remotes/origin/HEAD -> origin/master
  remotes/origin/master
  

• master는 로컬 브랜치
• origin/master는 원격 브랜치

원격 브랜치 Remote Branch

• 원격 브랜치는 단순히 원격 저장소의 브랜치를 가리키는 포인터
  

출처: https://git-scm.com/book/en/v2/Git-Branching-Remote-Branches

최초 동기화 이후 원격 저장소와 로컬 저장소 동기화

• 동기화는 브랜치 별로 이루어짐
• 로컬 -> 원격
  • 로컬 저장소에서 만든 새 커밋을 보내기(Push)
• 원격 -> 로컬
  • 로컬 저장소에는 없는 원격 저장소의 새 커밋을 가져오기(Fetch)
  • 새로 가져온 원격 브랜치의 커밋을 로컬 브랜치에 합치기(Merge)

PUSH - 원격 저장소에 로컬 저장소 변경 이력(커밋) 보내기 (1/3)

• $ git push [원격 이름] [로컬 브랜치 이름]
  • [로컬 브랜치 이름] 으로 지정한 로컬 브랜치를 [원격 이름]에 설정된 원격 저장소의 같은 이름의 브랜치로 보냄
  • 이때 원격 저장소에는 없지만 로컬 저장소에만 있는 새 커밋만 보내게 됨
    • Reject 발생하면 해결 필요!
    • 원격 저장소의 브랜치에 로컬 브랜치에 없는 새로운 커밋이 있을 경우 Reject
    • 새로운 커밋을 먼저 가져와서 합친 후에 다시 시도
      • git fetch/merge 또는 git pull (뒤에 설명)
  • 해당 브랜치가 원격 저장소에 존재하지 않으면 새로 만들게 됨
    • 원격 저장소에 새로 브랜치를 만드는 것은 조심스럽게 해야함
    • 다른 사람과 공유하는 것이기 때문에...

PUSH - 원격 저장소에 로컬 저장소 변경 이력(커밋) 보내기 (2/3)

• $ git push [원격 이름] [로컬 브랜치 이름] 예시

  $ git commit -m "test"        [새 변경 이력 생성]
  [master 4a52752] test
  1 file changed, 1 insertion(+)
  create mode 100644 test.c
  $ git status                  [현재 상태 확인]
  On branch master
  Your branch is ahead of 'origin/master' by 1 commit.
  (use "git push" to publish your local commits)
  
  nothing to commit, working tree clean
  $ git push                    [git push 원격 이름과 로컬 브랜치 이름 생략]
  Username for 'https://github.com': jyheo
  Password for 'https://jyheo@github.com':
  Enumerating objects: 4, done.
  Counting objects: 100% (4/4), done.
  Delta compression using up to 16 threads
  Compressing objects: 100% (2/2), done.
  Writing objects: 100% (3/3), 275 bytes | 275.00 KiB/s, done.
  Total 3 (delta 0), reused 0 (delta 0)
  To https://github.com/jyheo/test-repo.git
  2bafe99..4a52752  master -> master
  

PUSH - 원격 저장소에 로컬 저장소 변경 이력(커밋) 보내기 (3/3)

• 주의
  • 여기에서 Username, Password는 github ID와 Personal Access Token
  • git의 user.name, user.email과는 전혀 관련 없음!
  • Personal Access Token - Github의 사용자 설정에서 생성
    • https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token
• git push할 때 원격 이름을 생략하면 default는 origin
• git push할 때 로컬 브랜치 이름을 생략하면 현재 로컬 브랜치
  • 앞의 예에서는 로컬 브랜치 master를 원격 origin/master 브랜치로 push함
  • 즉, $ git push origin master 와 동일한 결과
• 보통 원격 이름과 로컬 브랜치 이름을 생략하고 $ git push 로 많이 사용
• github 웹으로 접속하여 변경된 내용 확인 가능

FETCH - 원격 저장소에서 최근 커밋(변경 이력) 가져오기

• 가져오기 전에 먼저 원격 저장소에 로컬 저장소 보다 새로운 커밋이 있어야 함
• github의 경우 웹으로 접속하여 파일을 변경하거나 생성할 수 있음
  • 이 예제에서는 README.md 파일에 "new test"라는 내용의 줄을 추가하여 수정한 것으로 함
• $ git fetch [원격_이름]

  $ git fetch                  [원격 이름을 생략하면 default는 origin]
  remote: Enumerating objects: 5, done.
  remote: Counting objects: 100% (5/5), done.
  remote: Compressing objects: 100% (2/2), done.
  remote: Total 3 (delta 0), reused 0 (delta 0), pack-reused 0
  Unpacking objects: 100% (3/3), 654 bytes | 43.00 KiB/s, done.
  From https://github.com/jyheo/test-repo
  4a52752..8ef157d  master     -> origin/master
  $ cat README.md               [커밋을 가져오기만 하고 로컬 브랜치에 합치지는 않음]
  test
  

MERGE - 원격 저장소에서 가져온 커밋을 로컬 브랜치와 합치기

• $ git merge [브랜치이름]

  $ git merge origin/master
  $ git merge                  [브랜치이름 생략하면 현재 브랜치의 트래킹 브랜치]
  Updating 4a52752..8ef157d
  Fast-forward
  README.md | 1 +
  1 file changed, 1 insertion(+)
  $ cat README.md
  test                       [합쳐진 결과로 한줄 추가된 것이 확인 됨]
  new test
  

PUSH - Reject

• 내가 clone한 이후에 원격 저장소에 누군가 commit(31b8e, 190a3)을 push하였고, 나는 로컬 저장소에 commit(a38de, 893cf)을 수행하였음
  • 이 상황에서 push하면 reject 발생
    

PUSH - Reject 해결 : Fetch + Merge

• $ git fetch origin
  • 원격지 origin의 최신 내용(커밋)을 가져옴
    
• 현재 브랜치(여기에서는 master)에 원격지 브랜치를 merge
  • $ git merge origin/master
• 다시 push 시도

PULL = Fetch + Merge

• 로컬 브랜치가 원격 브랜치의 트래킹 브랜치로 되어 있는 경우
  • git fetch와 merge를 pull 명령어 한번으로 해결
  • git pull은 git fetch & git merge 와 같음
• git push를 할 때 원격 저장소의 내용이 로컬 보다 더 최신 내용이라서 push가 reject될 때가 종종 있음
  • 이런 경우 git push를 하기 전에 보통 git pull을 먼저 하고 git push를 해야 함

원격 저장소 브랜치의 트래킹(tracking) 브랜치

• 트래킹한다는 것은 로컬 브랜치가 특정 원격 브랜치와 연결됨을 의미
  • pull할 때 연결된 원격 브랜치로 pull함
• 트래킹 브랜치 연결
  • git push -u origin master 할 때 -u 옵션 사용
    • 로컬 브랜치 master는 원격 브랜치 master의 트래킹 브랜치가 됨
  • git clone으로 로컬 저장소를 만든 경우, 트래킹 브랜치가 자동으로 지정됨
• 트래킹 브랜치 확인 $ git branch -vv

  $ git branch -vv
  * master 4a52752 [origin/master] test
  

  • 로컬의 master 브랜치가 원격 origin의 master 브랜치를 트래킹하고 있음

git pull --rebase = fetch + rebase

• merge 대신 rebase를 사용하는 방법
• $ git checkout master
• $ git rebase origin/master

Exercise 1

• Github에 저장소를 test라고 만든다. 이때 README, gitignore, LICENSE도 모두 생성
• git clone하여 로컬 컴퓨터로 복제
• 로컬에서 test.c 파일 추가/commit
• test.c 파일을 적당히 수정/commit
• git push
• Github 웹 인터페이스로 test.c를 수정/commit
• 로컬에서 test.c 파일을 수정/commit
• git push 시도, Reject 발생
• git pull 후에 git push 시도
• 로컬 저장소의 히스토리와 github에서의 히스토리 살펴보기

브랜치 공유 - 로컬 브랜치 Push

• 브랜치를 원격지에 올려서 공유하기

  $ git branch testing                                [로컬 브랜치]
  $ git checkout testing
  Switched to branch 'testing'
  $ touch testfile
  $ git add testfile
  $ git commit -m "testfile added"
  [testing daf25d2] testfile added
   1 file changed, 0 insertions(+), 0 deletions(-)
   create mode 100644 testing
  $ git push -u origin testing                           [원격지 origin에 testing 브랜치 push]
  Username for 'https://github.com': jyheo
  Password for 'https://jyheo@github.com':
  Counting objects: 3, done.
  Delta compression using up to 4 threads.
  Compressing objects: 100% (2/2), done.
  Writing objects: 100% (3/3), 271 bytes | 0 bytes/s, done.
  Total 3 (delta 1), reused 0 (delta 0)
  remote: Resolving deltas: 100% (1/1), completed with 1 local objects.
  To https://github.com/jyheo/test.git
   * [new branch]      testing -> testing
  

브랜치 공유 - 로컬 브랜치 Push

• 원격지에 새로 testing 브랜치가 push된 것을 확인
  

브랜치 공유 - 원격 저장소 브랜치 로컬로 가져오기

• 트래킹 브랜치
  • 원격지의 브랜치로 작업하기
• $ git checkout -b [로컬 브랜치] [원격 브랜치]

  $ git fetch origin         [원격 저장소 내용 최신으로 가져오기]
  $ git branch -a
  * master
    remotes/origin/HEAD -> origin/master
    remotes/origin/master
    remotes/origin/new
    remotes/origin/testing
  $ git checkout -b testing origin/testing
  Branch testing set up to track remote branch testing from origin.
  Switched to a new branch 'testing'
  $ git branch -vv                [트래킹 브랜치 확인]
    master  8f6ad29 [origin/master] Update jyheo
  * testing 16fbdb2 [origin/testing] hello
  

Exercise 2

• Exercise 1에서 만든 원격 저장소 계속 사용
• 로컬에 두 개의 복제를 생성, 서로 다른 디렉토리에 git clone을 수행
• 한 로컬 저장소에서 브랜치 testing 생성
• testing 브랜치 사용
• new.c 파일 생성/commit
• testing 브랜치 원격으로 push, 이때 트래킹 브랜치가 되도록 -u 옵션 사용
• github에서 testing 브랜치 확인
• 다른 로컬 저장소에서 github에 올라온 testing 브랜치 가져오기
• 가져온 testing 브랜치로 사용
• new.c 파일이 작업 디렉토리에 보임을 확인

Github Pull Request

• Pull Request는 2가지로 사용 가능
• 1. 권한이 없는 다른 사용자의 저장소에 변경 요청을 하는 것.
  • 화면 오른쪽 위 Fork 버튼 (현재 로그인 ID: jyheo-st)
    
• 2. 브랜치를 만들고, 그 브랜치를 main에 merge하기 위해 공동 작업자에게 요청을 하는 것.
  • 공동작업자는 코드를 리뷰하고 main에 머지할지 결정
  • main 브랜치로만 머지됨

Github Pull Request

• jyheo/test를 Fork하여 나(jyheo-st)의 저장소로 복제해 옴
  

Github Pull Request

• 저장소 파일 변경
  • git을 이용하여 로컬로 가져와서 변경 후 push
  • 또는 웹에서 바로 편집 가능
  • New pull request 버튼, Create Pull Request
    

Github Pull Request

• jyheo로 로그인하면 아래와 같은 Pull request
  

Sync a Fork

• Fork한 저장소의 내용을 원본(upstream) 저장소의 최신 내용과 동기화 하기
  • 원본 저장소와 fork한 저장소에 새로 만든 커밋을 비교하여 merge하거나 discard하여 sync 수행
  • 

Github 공동 작업 초간단 시나리오

• A가 오픈 소스 프로젝트 저장소 ‘bestsw’를 만들어 둔 상황
• B가 ‘bestsw’가 마음에 들어서 사용하다가 수정을 할 필요가 생겼음
• B는 Github의 ‘bestsw’ 저장소를 자신의 저장소로 fork해옴
• Fork한 ‘B/bestsw’를 수정
• 수정한 내용을 반영해달라고 A에게 pull request 보냄
• A가 B의 수정 내용을 반영
• A가 생각해보니 B가 프로젝트에 기여를 잘 할 것 같아서 공동 개발자(Collaborators)로 추가함
• 이제부터 B는 직접 ‘bestsw’ 저장소에 수정 할 수 있음

Exercise 3

• https://github.com/jyheo/test 를 Fork
• Fork한 저장소를 로컬에 clone
• fork_pull_request.c를 정상 동작하도록 수정
• Commit/Push
• Pull request 생성
• Collaborator가 되면
  • 저장소(https://github.com/jyheo/test)를 clone
  • name 디렉터리 밑에 자신의 id나 이름으로 파일 생성
  • Commit/Push
  • 일정 시간 후에 다른 사람이 변경한 내용 가져오기(fetch/merge)

    $ git pull