윈도우에서 Sourcetree - GitHub 연동

(checkout, clone)

 

 

 

 

소스트리(Sourcetree)는 깃허브(GitHub)의 클라이언트 프로그램으로 많이 사용되고 있습니다. 참고로, 소스트리는 윈도우(Windows)버전과 맥OS(macOS)버전 모두 제공하고 있습니다. 소스트리는 일반적으로 깃허브 로그인할 때 사용하는 ID/Password 방식을 사용하지 않고, 이를 대신해서 PublicKey/PrivateKey 방식을 사용하고 있습니다. 따라서, 사용자가 소스트리를 사용할 때는 PublicKey/PrivateKey 방식인 ssh키를 가지고 있어야 합니다. 만약에, ssh키가 없다면 직접 만든 후 그걸 가지고 있어도 됩니다. ssh키는 PublicKey와 PrivateKey가 한쌍으로 이루어져 있는데, 둘 중 PrivateKey는 Sourcetree에 세팅하고, PublicKey는 GitHub에 세팅하면, 그 후부터는 Sourcetree와 GitHub는 서로 가지고 있는 키를 사용해서 안전하게 암호화 통신을 하게 되는 것이죠. 본 포스팅에서는 윈도우 환경에서 Sourcetree를 사용하기 위해 설정을 어떻게 해야하는지를 설명할 것입니다.

 

 

환경

OS : Windows 10

GitHub 인증 방법 : ssh 키 사용

GitHub 클라이언트 Tool : Sourcetree

 

 

세팅 순서 요약

  1. Sourcetree에 ssh 키 추가하기
  2. GitHub에 ssh 키 추가하기
  3. Sourcetree를 사용해서 GitHub 코드 내려받기

 

 

세팅 순서

1. Sourcetree ssh 키 추가하기

1) Sourcetree 다운

https://www.sourcetreeapp.com/

 

2) Sourcetree 사용해서 ssh 키 생성 (참고, 이미 보유 중인 ssh가 있다면 그걸 사용해도 된다)

> C:\Users\joker\AppData\Local\SourceTree\app-3.2.6\tools\putty\puttygen.exe 실행

> "Generate"클릭

> ssh 키 생성이 완료될 때까지 마우스 이동

> "Save public key" 클릭 (추후 잘 보관 필요)

> "Save private key" 클릭 (추후 잘 보관 필요)

 

3) 생성된 ssh 키를 Sourcetree에 추가

> Sourcetree > 도구 > 옵션

> [일반]

> [SSH 클라이언트 설정] 영역

           SSH : private key 선택 (참고, 2번 단계에서 저장시킨 private key 파일을 선택한다)

           SSH 클라이언트 : PuTTY/Plink 선택

 

 

2. GitHub ssh 키 추가하기

[방법1] 계정 메뉴를 통해서 GitHub 에 ssh 키를 추가

> GitHub > 계정 > Settings > SSH and GPG keys

> "New SSH key" 클릭

           Title : [사용할 key 닉네임 입력]

           Key : ssh-rsa [사용할 public key 입력]

 

[방법2] 프로젝트 메뉴를 통해서 GitHub 에 ssh 키를 추가

> GitHub > 프로젝트 > Settings > Deploy keys

> "Add deploy key" 클릭

           Title : [사용할 key 닉네임 입력]

           Key : ssh-rsa [사용할 public key 입력]

> "Add key" 클릭

 

 

3. Sourcetree를 사용해서 GitHub 코드 내려받기 (=checkout, clone)

1) Sourcetree 클론

> Sourcetree > Clone

           첫번째 칸 : [from - 원격 저장소 경로 입력] (참고, GitHub 프로젝트의 “Clone or download” 버튼 > “Use HTTPS” 버튼을 눌러서 출력된 URL 경로를 복사한다.)

           두번째 칸 : [to - 로컬 저장소 경로 입력]

           세번째 칸 : [to - 로컬 저장소 폴더 이름 입력]

> "Clone" 클릭

 

2) 두번째 칸에 입력했던 로컬 저장소에 내려받아졌는지 확인