윈도우에서 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
세팅 순서 요약
- Sourcetree에 ssh 키 추가하기
- GitHub에 ssh 키 추가하기
- 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) 두번째 칸에 입력했던 로컬 저장소에 내려받아졌는지 확인