marp	theme	paginate	headingDivider	header	footer	backgroundColor
true	my-theme	true	2	git/github - https://github.com/jyheo/github-lecture

Git 원격 저장소

Github

허준영(jyheo@hansung.ac.kr)

원격 저장소

저장소(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라는 폴더가 새로 생성됨]
Directory: C:\Users\jyheo\test2

최초 동기화 방법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

-a 옵션은 로컬, 원격 브랜치를 모두 표시
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'
 > echo "" > 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의 용도

권한이 없는 다른 사용자의 저장소에 변경 요청
- 먼저 다른 사용자의 저장소를 fork
- fork된 저장소에 수정 하고
- Pull Request를 요청
브랜치를 만들고, 브랜치를 main에 merge하기 위해 다른 공동 작업자에게 요청
- 공동작업자는 코드를 리뷰하고 main에 merge할지 결정
- main 브랜치로만 merge됨

Github Pull Request

권한이 없는 다른 사용자의 저장소에 변경 요청
화면 오른쪽 위 Fork 버튼 (현재 로그인 ID: jyheo-st)

Github Pull Request

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

Github Pull Request

복제된 저장소(jyheo-st/test) 파일 변경
- git을 이용하여 로컬로 가져와서 변경 후 push
- 또는 웹에서 바로 편집 가능
- New pull request 버튼, Create Pull Request

Github Pull Request

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

Sync a Fork

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

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
```

Files

git-remote-github.md

Latest commit

History

git-remote-github.md

File metadata and controls

Git 원격 저장소

Github

허준영(jyheo@hansung.ac.kr)

원격 저장소

Github

Github 저장소 만들기

Github 저장소 만들기

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

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

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

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

원격 저장소 확인

원격 브랜치 Remote Branch

원격 브랜치 Remote Branch

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

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

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

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

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

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

PUSH - Reject

PUSH - Reject 해결 : Fetch + Merge

PULL = Fetch + Merge

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

git pull --rebase = fetch + rebase

Exercise 1

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

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

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

Exercise 2

Github Pull Request

Github Pull Request

Github Pull Request

Github Pull Request

Github Pull Request

Sync a Fork

Exercise 3