Using git

This is an old revision of the document!

분산버전관리 (Distributed Version Control System) → 이것이 주는 장점? → 기대효과
사용자의 요구사항
- 추가할 기능 많음; 각 기능별로 작업 이력을 git commit에 저장하므로 작업 이력을 관리 할 수 있음
- 항상 모든 이슈사항은 응급!; 버그나 수정사항들이 발생하여 프로그램을 수정해야 할 경우, 요청자는 항상 빠르게 대처 가능.
개발자의 요구사항
- 개발과 실제 운용 소스가 다름; 현재 작업 중인 내용이 있다면 현재 작업 내용을 백업하고, 운영(서비스)되는 배포판의 소스를 가져와서 수정한 후 배포하고 수정된 내용을 작업 중이던 소스에도 적용해야 하는 경우에 git은 유연하게 대처 가능.
- 개발 사항에 대한 이력이 필요; 각 작업별로 언제, 어떤 내용을, 누가 했는지 이력을 관리하면 프로젝트 관리에 이점.

pros.

강력한 브랜치 기능; 브랜치를 쉽게 만들고 병합 가능, 일시적인 작업에 대한 이력 관리 쉬움
속도와 성능; 처리 속도가 빠르고 기능이 많음
분산작업; 장소에 구애 받지 않고 협업이 가능(메인 서버에 연결없이 작업 가능), 저장소의 완전한 복사본으로 작업
데이터 보장성; 모든 파일을 암호화하여 저장
무료; 비용 안 듬.

cons.

배우기 어려움.
어떻게 사용하는 가가 중요하므로 잘 정의된 개발 프로세스가 필요.
git hub와 같은 서비스를 이용할 경우 비용 발생. (bitbucket은 5명까지 무료 사용 가능)

설치 osx, windows, linux
global settings

생성 init, clone
git이 파일(디렉토리)를 관리하는 방법
- working directory → stage area → git repository
- working directory; 사용자가 작업하는 디렉토리
- stage area; git repository에 저장될 파일 목록
- git repository; git이 파일을 저장하는 저장소
git repository의 파일 관리 add, remove, commit
상태 보기 status
뒤로 되돌아 가기 reset
버전 되돌아보기 log
태그 붙이기 tag
이건 저장하지 않을 거야 .gitignore
- repository에 넣으면 좋은 것들; 스펙문서, 설계서, 매뉴얼, 도움말, 소스코드, 이미지, 외부라이브러리, 빌드스크립트
- 넣지 말아야 할 것들; 바이너리, 설치본, 영업자료, 마케팅자료, 판매자료 등.
stash
HEAD; 최종 커밋 작업의 위치 포인터, HEAD와 스테이지 영역의 내용을 합쳐 다음 커밋을 생성
^,~; HEAD^^, HEAD~~, HEAD^3, HEAD~3
AHEAD; 서버로 전송되지 않은 로컬 커밋
BHEAD; 로컬로 내려 받지 않은 커밋
pull → 작업 → commit → pull → push
대부분의 git 명령어는 working tree clean 상태에서 작업

$ git config --global core.editor "에디터경로"
$ git config --global credential.helper cache  # 인증정보 캐시

$ git init
$ git clone 원격저장소URL 새폴더이름

$ git add 파일이름

$ git rm --cached 파일이름  # 스테이지에서 파일이름 삭제, 파일 등록 후 커밋하지 않음
$ git reset HEAD 파일이름  # 한 번이라도 커밋을 했을 경우

$ git status

$ git mv 파일이름 새파일이름  # 파일 이름 변경, mv -> git rm -> git add 와 같음

$ git commit
$ git commit -a  # 커밋 하기 전 자동으로 모든 파일을 등록 후 커밋

$ git log
$ git log --pretty=short
$ git show 커밋ID  # 특정 커밋의 상세 정보
$ git diff  # 워킹 디렉토리와 스테이지 영역 간 변경 사항
$ git diff HEAD  # 최신 커밋과 워킹 디렉토리 간 변경 사항

$ git checkout -- 수정파일이름  # 수정된 파일을 커밋 상태로 되돌림
$ git add 수정파일이름 

$ git commit -m "커밋메시지"
$ git commit -am "커밋메시지"
$ git commit --allow-empty-message -m ""  # 빈 커밋 작성
$ git commit --amend  # 방금 전에 작성한 커밋 메시지 수정
$ git commit -v  # 커밋 메시지에 diff 내용 추가

$ git stash  # 현재 작업들을 임시 스택에 저장, 워킹디렉토리+스테이지영역 파일까지 모두 저장
$ git stash save
$ git stash save "WIP: message"

# 작업 중인 내용을 강제 커밋(비추천)
$ git commit -am "temp"  # 임시 커밋
$ ...  # 다른 브랜치 작업 후 현재 브랜치로
$ git reset -soft HEAD^  # 리셋 복워
###

$ git stash list  # 스태시 리스트
$ git stash show  # 스태시와 워킹디릭토리 차이
$ git stash show -p stash{0}  # 상세

$ git stash pop  # 스태시 스택에서 pop, 자동 삭제, 충동시에는 삭제 안함
$ git stash apply --index  # 스테이지 등록된 상태까지 복구

$ git stash branch 브랜치이름  # 스태시를 브랜치에 적용

$ git stash apply  # 스태시 스택에서 읽어오지만 삭제하지 않음
$ git stash apply stash@{0}  # 0번 스태시로 복원

$ git stash drop  # pop 충돌시, apply 했을 시 스태시 삭제

$ git clean  # 워킹디렉토리 안에 추적되지 않는 파일을 모두 삭제, -f 강제, -n 가상으로 처리하고 사용자 확인, -d untracked 상태의 파일만 삭제, -x .gitignore 설정된 파일까지 삭제

기준이 되는 메인 프로젝트와 개발 프로젝트 혹은 디버그 프로젝트, 핫픽스 프로젝트 master, branch
- 가지 치기, 가지 잘라내기
지금 작업하고 있는 위치 head
- 개발 브랜치에서 핫픽스 브랜치로 전환 checkout
메인+브랜치⇒새로운 메인, 브랜치1+브랜치2⇒새 버전의 브랜치1 merge
- 병합(merge)하기 전에 diff
- rebase
Fast-Forward 병합; 순차적 커밋에 맞추어 병합 처리
3-Way 병합; 공통 조상 커밋 + 공통조상커밋을 포함하는 브랜치 + 새로운 브랜치 ⇒ 하나로 병합, 병합을 성공적으로 완료 후 새로운 커밋을 추가로 생성 (=병합 커밋)
Rebase; 두 브랜치를 서로 비교하지 않고 순차적으로 커밋 병합. 병합 커밋 없음, 브랜치의 마지막을 가리키는 커밋 위치 다름. 원격 저장소에 푸시하면 리베이스 사용하지 않는 것이 원칙.

$ git branch  # 브랜치 목록
$ git branch 브랜치이름 커밋ID  # 커밋ID를 기점에서 브랜치이름으로 브랜치 생성, 커밋ID 없으면 HEAD 포인터 기준

$ git rev-parse 브랜치이름  # 커밋 해시값(SHA1) 확인
$ git branch -v  # verbose, 브랜치 세부 사항

$ git checkout 브랜치이름  # 브랜치이름으로 이동, working tree clean 이어야 함, HEAD 포인터도 이동
$ git checkout -- 파일이름  # 파일로 체크아웃
$ git checkout -  # 이전 브랜치로 이동
$ git checkout -b 브랜치이름  # 브랜치이름 생성하고 그 브랜치로 이동

$ git checkout 커밋해시키  # 해시키로 체크아웃
$ git checkout HEAD~1  # 한 단계 전
$ git checkout -  # 현재로 이동

$ git log --graph --all  # 텍스트 그래프 출력
$ git show-branch --more=10  # 출력 커밋 개수 제한

$ git merge 브랜치이름  # 현재 브랜치 + 브랜치 병합
$ git merge 브랜치이름 --edit  # --edit 옵션 없으면 커밋 메시지 자동생성, 옵션 붙이면 메시지 에디트

$ git reset --hard HEAD^  # 방금 병합한 내용 취소

$ git branch -d 브랜치이름  # 병합을 완료한 브랜치만 삭제 가능

$ git merge --abort  # 병합시 충돌일 경우, 병합 취소
$ git ls-files -u  # 충돌한 파일들의 집합 확인
$ git commit -m "resolve complicit"  # 충돌 해결 후 커밋

$ git branch --merged  # 병합한 브랜치 표시
$ git branch --no-merged  # 병합하지 않은 브랜치 표시

$ git rebase 원본브랜치  #  merge(현재기준에서 파생브랜치랑 병합)와 반대로 파생에서 원본으로 병합, 브랜치의 HEAD 포인터가 다름
$ git checkout 원본브랜치
$ git merge 대상브랜치  # rebase 후에 merge 다시 함.

$ git rebase --continue  # rebase 병합시 충돌 났으면 그것을 해결하고 충돌된 부분들을 한단계씩 진행, 리베이스 안되면 git add 명령어

$ git rebase --abort  # 리베이스 취소

$ git rebase -i HEAD~3  # 커밋 묶기, 이 예에서는 커밋 3개가 커밋 하나로 변경

Protocols; Local, HTTP, SSH, Git
서버 repository에서 혹은 서버 repository으로 pull, push
업스트림 트래킹; 리모트 브랜치와 로컬 브랜치를 연결하는 중간 다리 역할
./git/config

$ git remote add 원격저장소별칭 폴더경로  # 로컬 저장소를 서버로 이용
$ git remote add 원격저장소별칭 원격저장소URL  # 원격 저장소 연결

$ git remote  # 원격 저장소의 이름 출력
$ git remote -v  # verbose, URL도 확인

$ git remote rename 변경전이름 변경후이름
$ git remote show 원격저장소이름  # 상세 정보

$ git remote rm 원격저장소이름  # 원격 저장소 삭제

$ git push 원격저장소별칭 브랜치이름  # 원격저장소/브랜치에 현재 브랜치 전송
$ git push -u 원격저장소별칭 브랜치이름
$ git push 원격저장소별칭 로컬브랜치이름:새로운원격브랜치


$ git pull
$ git fetch

$ git merge 원격저장소별칭/브랜치이름

$ git branch -r  # 리모트 브랜치 목록
$ git branch -a  # 모든 브랜치 정보 확인
$ git branch -vv  # 트래킹 브랜치 목록

$ git checkout --track 원격저장소별칭/원격브랜치  # 업스트림 브랜치 생성

$ git checkout -b 새이름 원격저장소별칭/브랜치이름  # 
$ git branch -u 원격저장소별칭/브랜치이름  # 업스트림 연결, -u(==--set-upstream-to), 기존 브랜치를 특정 원격 브랜치로 추적

$ git push --set-upstream 원격저장소별칭 원격브랜치  # 업스트림 설정

$ git merge 원격저장소별칭/브랜치이름  # 리모트 브랜치와 병합

$ git checkout -b 임시브랜치이름 원격저장소별칭/원격브랜치  # 원격 브랜치의 포인터를 사용하여 임시 브랜치 생성하거나 직접 체크 아웃

$ git branch -d 브랜치이름  # 브랜치 삭제, -d 옵션은 스테이지 상태가 깨끗할 때만 삭제 허용
$ git branch -D 브랜치이름  # 브랜치 강제 삭제

$ git push 원격저장소별칭 --delete 리모트브랜치이름  # 리모트 브랜치 삭제

도구의 사용법 보다 사용 방법이 더 중요하다.
메인 프로젝트는 놔두고 개발 프로젝트로 작업하기
- master에서 develop 브랜치 만들어 작업하고 develop에서 release 브랜치 생성, release
한참 개발 중인데 급한 버그 수정 요청이 들어왔다
- master에서 hotfix 브랜치를 만들어 작업하고 master와 현재 개발중인 브랜치로 merge
하나의 프로젝트 여러 명의 개발자
- develop 브랜치에서 각 개발자별로 브랜치 생성후 작업 (보통 기능별로 개발자에게 분배) 혹은 develop에서 기능별 브랜치 생성

fork → clone forked repository → make branch and move to branch on forked repository → coding jobs on branch → push → pull request

 
*basic concept
workspace -> staging area(index) -> local repository -> remote repository
stash

*file status lifecycle
1. untracked; git에 의해 추적되지 않는 파일. add the file 후 tracked로 변경됨
2. tracked; git에 의해 추적되는 파일. remove the file 하면 untracked로 변경됨
  2.1 unmodified; 수정되지 않은 파일. edit the file 후 modified로 변경됨
  2.2 modified; 수정된 파일. stage the file 
  2.3 staged; staging area에 있는 파일. commit 후에는 unmodified로 변경됨


*기본 동작
만들기
(저장소 받아오기)
파일 저장: 생성, 삭제, 수정
로컬 저장소 저장: 생성, 삭제, 수정
원격 저장소 저장: 생성, 삭제, 수정
브랜치: 생성, 삭제, 수정, 이동, 병합

*install git 
-Unix/Linux 
-Mac 
-Windows


*config git 
.gitignore 
Glob pattern


*starting w/ git 
git init; create local repository 
git remote add <repository>; connect local repository with remote repository 
git pull; get data from remote repository


git clone <repository> 
ex) git clone /local/repository/path 
ex) git clone user@hostname:/remote/repository/path


*basic commands 
git add; workspace -> staging area(index) 
git commit -a; workspace -> local repository 
git push; local repository -> remote repository


git fetch; remote repository -> local repository 
git merge; merge

git pull; fetch & merge

git status; modified, staged or unstaged 
git diff; show differences between staged and unstaged 
git diff --staged or git diff --cached; show differences between staged and committed

*snapshot

*branch 
-create branch 
git branch <name> 
git checkout <name>

git branch -b <name>; branch & checkout

-delete branch 
git branch -d <name>


-merge branch 
git checkout master 
git merge branch


-list branch 
git branch 
git branch --no-merged 
git branch -merged

*rebase

*tag 
-create tag 
git tag <name> 
git tag -a <name>


-delete tag 
git tag -d <name>


-list tag 
git tag


*rollback 
git checkout --; rollback unstaged file

git reset HEAD; unstage staged file

git fetch origin; rollback commited file 
git rest --hard oring/master

*stashing
 

 * gitignore 재 적용
git rm -r --cached .
git add .
git commit -m "git ignore applied and fixed untracked files"
git push

git pull
git add .
git commit -m "git ignore applied"
git push
references