Sourcetree를 설치한 뒤 가장 많이 막히는 곳은 원격 저장소 연결입니다. 비밀번호를 넣었는데 인증이 안 되거나, SSH 키 단계에서 넘어가지 못하는 경우입니다. 공식 설치 안내와 릴리스 노트 기준으로 정리했습니다.
Sourcetree를 설치한 뒤 가장 많이 막히는 곳은 원격 저장소 연결입니다. 비밀번호를 넣었는데 인증이 안 되거나, SSH 키 단계에서 넘어가지 못하는 경우입니다. 공식 설치 안내와 릴리스 노트 기준으로 정리했습니다.
Sourcetree 비밀번호 인증이 안 될 때
Sourcetree 윈도우판 3.4.15 릴리스 노트에는 ‘Bitbucket 기본 인증이 비밀번호로 실패한다(비밀번호는 이제 폐지됐으니 앱 비밀번호를 쓰라)’는 항목이 있습니다. 계정 비밀번호를 그대로 넣으면 인증이 실패하는 이유입니다. 이후 윈도우판 3.4.24와 맥판 4.2.13에서 API 토큰 인증이 추가됐습니다. 계정 비밀번호 대신 호스팅 서비스에서 발급한 앱 비밀번호나 API 토큰을 넣어야 합니다.
Sourcetree SSH 키 단계에서 막힐 때
공식 설치 안내는 SSH 키를 만들지 못해 다음 단계로 넘어가지 못하면 HTTPS를 고르고 계속하라고 적고 있습니다.
| 상황 | 방법 |
|---|---|
| SSH 키가 없을 때 | HTTPS 선택 후 계속 |
| SSH로 쓰려면 | 공식 문서 ‘Set up an SSH key’ 참고 |
| 저장소 복제 준비 전 | Skip Setup 으로 건너뛰기 |
| 원격 연결 | 기본 옵션 그대로 호스팅 계정 입력 |
| 연결 방식 | 계정 추가 때 HTTPS·SSH 선택 |
| 계정 수 | 여러 개 추가 가능 |
Sourcetree 계정 추가 방법
원격 저장소를 쓰려면 호스팅 서비스 계정을 연결합니다. 오른쪽 위 더보기(•••)에서 Accounts 를 고르고 Add 를 누릅니다. Host 를 고른 뒤 Auth Type 은 기본값 그대로 두고 Connect Account 를 눌러 자격 증명을 넣습니다. 이때 HTTPS와 SSH 중 연결 방식을 고를 수 있고, 계정은 여러 개 추가할 수 있습니다.
Sourcetree 맥판 설치 조건
맥판 최신 4.2.19는 macOS 10.15 이상에서만 설치됩니다. 맥판은 ZIP 파일로 받고, 압축을 풀면 나오는 앱을 실행합니다. 공식 설치 안내는 설치 후 아틀라시안 고객 계약에 동의하고 Continue 를 누른 뒤 아틀라시안 계정으로 로그인하도록 안내합니다. 계정이 없으면 같은 화면에서 Go to My Atlassian 으로 만들 수 있습니다.
Sourcetree는 맥판과 윈도우판의 번호가 다릅니다. 맥판 최신은 4.2.19로 macOS 10.15 이상이 필요하고, 윈도우판 최신은 3.4.32로 Git 2.51.0과 Git LFS 3.7.0을 내장했습니다. 설치 후 원격 저장소를 연결할 때 계정 비밀번호를 넣으면 인증이 실패할 수 있으니, 릴리스 노트 안내대로 앱 비밀번호나 API 토큰을 넣습니다. SSH 키 단계에서 막히면 HTTPS로 바꿔 계속하고, 저장소 복제가 아직이면 Skip Setup 으로 넘어갑니다. 회사에서 여러 대에 깔 때는 MSI를 쓰는 Windows Enterprise판을, 새 판에 문제가 있으면 다운로드 보관함의 이전 판을 씁니다.
