프시코넷 전체 글

커밋, 브랜치, 풀 리퀘스트까지 깃 용어 풀이와 사이트모음 활용

개발도구 관련 대표 사진
사진: StockSnap / Pixabay

코딩을 배우기 시작하면 얼마 지나지 않아 깃이라는 도구를 만나게 됩니다. 강의에서는 "커밋하고 푸시한 다음 풀 리퀘스트를 올리세요"라고 아무렇지 않게 말하지만, 처음 듣는 사람에게는 문장 하나에 모르는 단어가 세 개나 들어 있습니다. 깃은 코드의 변경 이력을 기록하고 여러 사람이 함께 작업할 수 있게 해 주는 버전 관리 도구이고, 이를 온라인에서 쓸 수 있게 해 주는 것이 코드 저장소 서비스입니다. 이 글에서는 깃을 쓰면서 가장 자주 만나는 용어를 실제 작업 흐름 순서대로 풀어 보았습니다.

시작할 때 만나는 말

  • 저장소, 리포지토리: 프로젝트 파일과 그 변경 이력이 함께 담긴 공간입니다. 내 컴퓨터에 있는 것을 로컬 저장소, 온라인 서비스에 올라가 있는 것을 원격 저장소라고 부릅니다.
  • 클론: 원격 저장소를 내 컴퓨터로 통째로 복사해 오는 것입니다. 파일뿐 아니라 지금까지의 이력도 함께 받아집니다.
  • 포크: 다른 사람의 원격 저장소를 내 계정으로 복사해 오는 것입니다. 클론이 내 컴퓨터로 가져오는 것이라면, 포크는 온라인 서비스 안에서 내 계정 쪽으로 복사하는 것이라고 생각하면 구분하기 쉽습니다.
  • 이니셜라이즈, init: 아무것도 없는 폴더를 깃이 관리하는 저장소로 만드는 첫 단계입니다.

작업을 기록할 때 쓰는 말

파일을 고친 뒤 그 변경을 기록하는 과정에는 두 단계가 있습니다. 먼저 기록할 변경을 골라 담는 단계가 있고, 그다음 실제로 기록을 남기는 단계가 있습니다.

  • 스테이징, add: 고친 파일 가운데 이번에 기록할 것을 골라 담는 단계입니다. 여러 파일을 고쳤더라도 관련 있는 것만 묶어 기록하고 싶을 때 유용합니다.
  • 커밋: 담아 둔 변경을 하나의 기록으로 남기는 것입니다. 커밋마다 짧은 설명 메시지를 붙이는데, "로그인 버튼 색상 수정"처럼 무엇을 했는지 알 수 있게 적는 것이 좋습니다.
  • 로그: 지금까지의 커밋 기록을 시간 순으로 보여 주는 목록입니다. 언제 누가 무엇을 바꿨는지 확인할 수 있습니다.
  • 되돌리기: 이전 커밋 상태로 돌아가는 방법은 여러 가지가 있는데, 이미 다른 사람과 공유한 기록을 지우는 방식은 협업에 혼란을 줄 수 있어 조심해야 합니다.
개발도구 주제와 어울리는 사진
사진: genesis3g / Pixabay

갈래를 나눠 작업할 때 쓰는 말

여러 기능을 동시에 만들거나 여러 사람이 함께 작업할 때는 작업 줄기를 나눠서 진행합니다. 이것이 깃을 쓰는 가장 큰 이유이기도 합니다.

  • 브랜치: 원래 코드에서 갈라져 나온 독립된 작업 줄기입니다. 새 기능을 만들 때 브랜치를 따로 만들면 원래 코드는 그대로 둔 채 마음껏 실험할 수 있습니다.
  • 메인 브랜치: 기본이 되는 줄기로, 예전에는 master라는 이름을 많이 썼고 요즘은 main이라는 이름을 많이 씁니다.
  • 체크아웃, 스위치: 작업할 브랜치를 바꾸는 것입니다.
  • 머지: 갈라져 나온 브랜치의 작업을 다른 브랜치에 합치는 것입니다.
  • 충돌, 컨플릭트: 두 브랜치에서 같은 파일의 같은 부분을 서로 다르게 고쳤을 때 깃이 어느 쪽을 남길지 스스로 정하지 못하는 상황입니다. 이때는 사람이 직접 파일을 열어 남길 내용을 고른 뒤 다시 커밋합니다.

충돌은 처음 보면 당황스럽지만 고장이 아니라 확인을 요청하는 신호라고 생각하면 마음이 편합니다. 충돌을 줄이려면 브랜치를 너무 오래 두지 말고 자주 합치는 것이 좋습니다.

원격 저장소와 주고받을 때 쓰는 말

  • 푸시: 내 컴퓨터의 커밋을 원격 저장소로 올리는 것입니다.
  • 풀: 원격 저장소의 새 변경을 내 컴퓨터로 받아와 합치는 것입니다.
  • 패치, fetch: 원격 저장소의 변경을 받아오기만 하고 아직 합치지는 않는 것입니다. 무엇이 바뀌었는지 먼저 확인하고 싶을 때 씁니다.
  • 풀 리퀘스트: 내가 작업한 브랜치를 다른 브랜치에 합쳐 달라고 요청하는 기능입니다. 서비스에 따라 머지 리퀘스트라고도 부르며, 이 단계에서 동료가 코드를 살펴보고 의견을 남기는 코드 리뷰가 이루어집니다.
  • 이슈: 버그나 개선할 점, 할 일을 기록하는 게시판 같은 기능입니다.

용어를 익힌 다음에 할 일

용어를 외우는 가장 좋은 방법은 연습용 저장소를 하나 만들어 직접 해 보는 것입니다. 간단한 메모 파일 하나로 커밋, 브랜치 만들기, 머지, 일부러 충돌 내고 해결하기까지 한 번씩 해 보면 글로 읽을 때보다 훨씬 빨리 익숙해집니다. 처음에는 명령어 대신 코드 에디터에 들어 있는 깃 화면이나 데스크톱용 깃 프로그램을 쓰면 흐름을 눈으로 확인하기 쉽습니다.

공부하다 모르는 용어가 또 나오면 깃 공식 문서의 용어집이나 코드 저장소 서비스의 도움말 페이지를 먼저 찾아보세요. 블로그 글은 쉽게 풀어 쓴 장점이 있지만 오래된 명령어나 화면을 기준으로 설명한 경우가 있어, 공식 문서와 함께 보는 것이 정확합니다. 학습용 강의 사이트와 공식 문서를 묶어 둔 개인 사이트모음을 하나 만들어 두면 같은 내용을 반복해서 검색하는 시간을 줄일 수 있습니다.

깃과 코드 저장소 서비스, 에디터 같은 도구의 공식 주소는 개발도구 분야 주소모음에서 한 번에 찾아볼 수 있습니다. 비슷한 이름의 비공식 다운로드 사이트에서 프로그램을 받으면 변조된 파일이 섞일 수 있으니 공식 경로를 이용하는 것이 안전합니다. 만든 프로젝트를 실제로 인터넷에 올려 보고 싶다면 웹호스팅 링크모음에서 정적 사이트를 무료로 올릴 수 있는 서비스도 살펴볼 만합니다. 자주 여는 공식 문서와 튜토리얼은 링크모아 폴더 하나에 정리해 두고, 주소모아 같은 분야별 목록과 함께 쓰면 공부할 자료를 찾는 시간이 크게 줄어듭니다.

전체 글 목록주소모아 전체 분야프시코넷 홈