스터디 세팅 가이드

본 글은 스터디에 사용하는 깃 레포지터리 활용 및 학습 내용 '업로드' 방식에 대한 가이드 입니다.

핵심 룰

  1. 학습을 진행하고, 깃북에 업로드 될 수 있는 글들은 모두 'pull request'를 마친 글입니다.

  2. pull request 가 된 글은 리뷰 후 'merge' 되어야 master 브랜치로 합쳐집니다.

  3. 합쳐지면, 깃북에 업로드가 되고 그 날 학습이 완료된 것입니다.

초기 세팅 방법

  1. 링크로 접속하여 git clone 을 받습니다.

  2. git clone 으로 원하는 위치에 등록합니다.

  3. 본인의 인트라id 브랜치를 만들고 해당 브랜치로 checkout 을 하면 초기 세팅이 완료 됩니다.

    $> git branch haryu
    $> git checkout haryu
    Switched to branch 'haryu'

학습 내용 작성 후 업로드 방법

학습을 마치고 이에 대하여 마크다운 문서로 작성 시 해야할 일은 아래와 같습니다.

  • 본인의 브랜치에서 커밋을 한다.

  • 커밋한 내용을 깃헙에 독립된 브랜치로 만든다.

  • pull request를 만들어 리뷰 가능 상태로 만든다.

  • 핵심 ) 파일을 새롭게 만들거나 트리구조를 만드는 경우, 최상단의 SUMMARY.md 파일을 수정해주어야 합니다. 참고자료

  1. 파일을 작성한 이후 커밋을 진행합니다.

  2. git push 를 진행해야 하나, 최초에는 아래처럼 메시지가 뜰 것입니다.

    $> git push
    fatal: The current branch haryu has no upstream branch.
    To push the current branch and set the remote as upstream, use
    
    git push --set-upstream origin haryu
    • 이렇게 뜨는 이유는 '원격 저장소'(깃허브) 에 현재 본인이 만든 브랜치가 없기 때문입니다.

    • 따라서 이 경우 해당 문구에서 이야기 하는데로 최초 1회만 업로드를 마치면 이후부턴 정상적으로 git push 로 진행이 가능합니다.

    $> git push --set-upstream origin haryu
  3. 정상적으로 푸시가 성공하면, pull request 를 만들어 올릴 수 있습니다.

  4. 이렇게 완성이 되면 git conflict 가 발생하지 않고, "This branch has no conflicts" 라는 문구가 보이면 리뷰 후 "Merge pull request" 버튼을 눌러 합쳐 줍니다.

  5. 이렇게 마무리 되면 해당 내용은 Merge 되고 깃북 페이지에 정상적으로 업로드 되게 됩니다.

학습 시작 전 할 일

지금까지는 학습이 끝나고 올리는 내용을 이야기 했습니다.

그러나 이후 전체 학습 내용들을 머지하고 나면 master 브랜치가 바뀌어 있을 것이고, 그 상태에서 본인의 브랜치에서 작성을 하게 되면 git conflict 가 발생할 수 있습니다.

따라서 다음 작업을 반드시 먼저 진행 하여, 본인의 브랜치를 최신화 시키시는 방법을 사용하여 주십시오.

$> git checkout master <- 본인의 브랜치가 haryu로 되어 있다면 
$> git pull <- 파일 전체 내려 받기 
$> git checkout haryu 
$> git merge master <- 마스터의 최신 내용을 그대로 현재 내 브랜치에 동기화 시킵니다. 

git merge 관련 참고자료 링크

Last updated