DevOps
Sourcetree
Sourcetree 설치 및 Git 계정 연동 가이드 (1편)

들어가며

Git은 현대 개발 환경에서 필수적인 버전 관리 시스템입니다. 대부분의 개발자가 터미널 환경에서 Git 명령어를 사용하여 작업을 수행하지만, GUI(Graphical User Interface) 도구를 사용하면 브랜치의 흐름을 시각적으로 파악하고, 복잡한 Git 작업을 더 직관적으로 처리할 수 있다는 장점이 있습니다.

**Sourcetree(소스트리)**는 Atlassian에서 개발한 무료 Git GUI 클라이언트로, 많은 개발자가 사용하는 인기 있는 도구 중 하나입니다.

이번 포스팅에서는 Sourcetree를 처음 사용하는 분들을 위해 프로그램 설치부터 원격 저장소(GitHub, Bitbucket 등) 계정을 연동하는 초기 설정 과정까지 상세히 다루어보겠습니다.


1. Sourcetree 설치

먼저 사용자의 운영체제에 맞는 Sourcetree 프로그램을 설치해야 합니다. Windows와 macOS를 모두 지원합니다.

1.1. 설치 파일 다운로드

Sourcetree 공식 홈페이지에 접속하여 설치 파일을 다운로드합니다.

🔗 Sourcetree 공식 홈페이지 (opens in a new tab)

사이트에 접속하면 현재 사용 중인 운영체제에 맞는 버전을 다운로드할 수 있는 버튼이 표시됩니다. 버튼을 클릭하여 설치 파일을 다운로드합니다.

소스트리 공식 홈페이지 다운로드 화면 (설명: Sourcetree 공식 홈페이지 다운로드 화면)

1.2. 설치 과정

다운로드한 파일을 실행하여 설치를 진행합니다. 설치 과정은 아래의 단계를 따릅니다.

(1) Atlassian 계정 연동

Sourcetree는 최초 실행 시 Atlassian 계정 로그인을 요구합니다. Bitbucket 계정이 있다면 해당 계정으로 로그인할 수 있으며, 없다면 구글 계정 등을 이용해 신규 가입 후 진행합니다. 저는 계정 연동을 하지 않고 건너뛰기 버튼을 눌러 넘어가도록 하겠습니다.

소스트리 다운로드 화면 (설명: Sourcetree 설치 시 Atlassian 계정 로그인 단계)

(2) 설치 옵션 선택

로그인 후에는 Git, Mercurial 등 버전 관리 도구를 함께 설치할 것인지 묻는 화면이 나타납니다. 사용자의 PC에 Git이 설치되어 있지 않더라도 Sourcetree가 내장된 Git을 사용할 수 있으므로, 기본 옵션을 유지하고 설치를 계속 진행하는 것을 권장합니다.

설치 옵션 화면 (설명: 설치 옵션에서 Git 선택 화면)

(3) 사용자 정보 설정

Git Commit(커밋) 시 기록될 작성자 정보를 설정합니다. 이곳에 입력하는 **사용자 이름(Username)**과 **이메일(E-mail)**은 GitHub, Bitbucket 등 원격 저장소에서 사용하는 정보와 일치시키는 것이 일반적입니다.

설치 옵션 화면 (설명: Git 커밋에 사용할 사용자 이름 및 이메일 설정 화면)

이후 SSH 키 관련 설정이 나타날 수 있으나, 지금은 필수가 아니므로 나중에 설정하도록 하고 넘어가면 설치가 완료됩니다.

설치 옵션 화면


2. 원격 저장소 계정 연동

설치가 완료되었다면, GitHub나 Bitbucket 등에 있는 원격 저장소와 연동해야 소스 코드를 가져오거나 업로드할 수 있습니다.

2.1. 계정 설정 메뉴 접근

Sourcetree 상단 메뉴 바에서 계정 설정 메뉴로 진입합니다.

  • Windows: 도구 > 옵션
  • macOS: Sourcetree > 설정

열리는 설정 창에서 [인증] (Authentication) 탭을 선택합니다.

'인증' 탭 (설명: Sourcetree 옵션의 '인증' 탭)

2.2. 원격 계정 추가

[추가] 버튼을 눌러 새 계정 정보를 입력하는 창을 엽니다.

원격 계정 상세 정보 입력 (설명: 원격 계정 상세 정보 입력 창)

각 항목을 아래와 같이 설정하는 것을 권장합니다.

  • 호스팅 서비스: 연동할 서비스를 선택합니다. (예: GitHub, Bitbucket)
  • 선호 프로토콜: HTTPS
  • 인증 방식: OAuth

인증 방식으로 OAuth를 선택하면 비밀번호를 직접 입력할 필요 없이, 웹 브라우저를 통해 안전하게 인증을 완료할 수 있습니다.

OAuth 토큰 새로고침 버튼을 클릭하면 웹 브라우저가 실행되며, 해당 호스팅 서비스의 로그인 및 권한 부여 페이지로 이동합니다. 화면의 안내에 따라 인증을 완료합니다.

OAuth 인증 화면 (설명: 웹 브라우저에서 진행되는 OAuth 인증 화면)

인증이 정상적으로 완료되면, 아래와 같이 계정 목록에 방금 추가한 계정이 표시됩니다.

원격 계정 연결 화면 (설명: 원격 계정이 성공적으로 추가된 화면)

이제 Sourcetree를 사용하여 원격 저장소의 프로젝트를 관리할 모든 준비가 완료되었습니다.


마무리

이번 1편에서는 Sourcetree 설치와 초기 설정, 그리고 원격 저장소 계정을 연동하는 방법까지 알아보았습니다. 다음 2편에서는 실제 원격 저장소의 프로젝트를 로컬 환경으로 Clone하고, 코드 변경 사항을 Commit, Push 하는 핵심적인 사용법에 대해 다루도록 하겠습니다.