sourceTree에 gitlab CE 계정 연동하기

gitlab + source tree를 사용하게 된 원인

gitlab과 sourceTree를 연동해서 사용해야 하는 일이 생겼다.

기존엔 jetbrains사의 webstorm과 intelliJ를 사용하여 ide에 내장된 git기능들로 아주 유연하게 git사용을 해왔었다.

하지만 슬프게도 무료 라이센스 기간 1년이 끝나며 생이별(?)을 하게 되었다. (구매하여 사용할 수 있지만 1년단위 약 25만원이라는 거금을 쓰기가 망설여졌다.) (그냥 통장에 돈이 없는거다.)

git 명령어에 익숙하지 않아 터미널로 당장 작업하기에는 무리가 있어서 gui환경으로 git관리를 하기 위해 sourceTree를 선택해보았다.

다른 툴도 있는데 sourceTree를 선택한 이유는 단지 입사 초반에 3개월정도 window에서 사용해봤기 때문이다.

빨리 개발에 적용해야 했기 때문에 내 기준 진입장벽이 낮은 툴을 선택한 것이다.

git에서 clone하여 개발중이던 N개의 프로젝트들을 하나 둘씩 sourceTree에서 접근해보았다.

그리고 원격 브랜치에서 full을 해보았는데

FATAL UNABLE TO ACCESS ‘.GIT/’ THE REQUESTED URL RETURNED ERROR 504

에러가 발생했다.

그리고 이거 말고도 401 권한 에러가 나서 찾아보니, 정보가 잘 없어서...

결국 sourceTree사이트 내 커뮤니티에 검색해서 내 상태에 맞는 질문을 찾았다. (링크 클릭)

답변을 참고하여 gitlab에서 엑세스토큰을 발급했다.

gitlab 오늘쪽 상단의 프로필 이미지를 눌러 설정에 들어간다.

왼쪽 메뉴에서 엑세스토큰 메뉴에 들어가면 발급 입력 폼이 나온다.

항목	설명
이름	엑세스토큰을 추가할 프로그램 이름
Expires at	토큰 만료일
사실 이름에 아무거나 적어도 될진 모르겠고, 소스트리에서 사용할 것이니 `sourceTree`로 적고 만기일은 대충 올해 말까지로 입력했다.

폼 입력을 완료하면 Create personal access token 버튼을 누른다.

주의사항 !

Create personal access token 버튼을 누르고 새로고침하거나 페이지를 나가지 말고 페이지 상단으로 이동해야한다!!

사진처럼 페이지 상단에 토큰이 발급되는 것을 확인할 수 있다.

새로고침하거나 페이지를 이동하면 다시 확인할 수 없으니, 꼭 따로 copy 해두어야한다.

https 프로토콜로 연동해도 되지만, 둘의 차이를 모르겠으니 일단 ssh키로 연동하는 방법을 소개해보겠다.

https로 연결하려면 바로 다음 과정으로 넘어가도 좋다.

ssh-keygen

다음 엔터를 쭉쭉 치면 생성 끝이다.(?)

끝이다.. (서칭을 통해 알게 된 방법으로 자세한 설명이 없다..) (자세한 설명은 구글 검색을 추천한다..)

이제 사진 속 폼을 입력해주면 끝이다.

항목	설명
호스트	연결하려는 호스트. (필자는 `gitlab CE`)
호스트 URL	호스트에 따라 다른데 `호스트`옆에 입력창이 뜨는 경우, gitlab주소를 입력.
사용자 이름	계정 아이디. (이메일아님..)
암호	위~에서 발급해서 복사해둔 `엑세스 토큰`
프로토콜	`ssh` / `https` 중 선택.(`ssh`의 경우 `key` 필요.)

이러면 계정 추가 끝.

꽤나 해맸는데 결국 공식 사이트에서 해답을 찾아냈다..

소스트리 홈페이지 doc이 별로 친절하진 않지만 커뮤니티에서 해답을 찾았다.

소스트리 관련해서 모르는 것이 생기면 sourceTree 홈페이지의 커뮤니티나 doc을 먼저 참고하는 것이 좋겠다.