주제 3
클론
지금 시작하는 위치에 맞는 clone 방법을 고르세요. GitHub repository를 clone하는 방법은 세 가지가 있습니다.
완료할 작업
GitHub repository가 local project folder에 clone되어 VS Code에 열립니다.
시작 전 확인
- Git과 GitHub 인증이 정상적으로 동작합니다.
- Clone할 상위 folder의 위치와 쓰기 권한을 확인했습니다.
검증 상태
- 상태
- 재검증 필요
- 환경
- Windows는 VS Code와 GitHub Desktop 상세 경로이며 command-line clone은 macOS와 Linux에도 적용됩니다.
- 검증 대상
- VS Code, GitHub Desktop, command-line clone 시작 경로.
- 마지막 검증
- 현재 제품 기준 walkthrough 대기 중.
- 운영체제 지원
- Windows 상세 지원, macOS는 대응 앱, Linux는 Git과 VS Code 명령으로 지원.
첫 번째 방법
Source Control 화면을 열고 Clone Repository를 선택한 뒤 Clone from GitHub를 고릅니다.
clone하려는 repository를 검색합니다.
VS Code가 repository source를 물어보면 Clone from GitHub를 선택합니다.
GitHub 검색 결과에서 repository를 선택합니다.
프로젝트 파일을 옮기기 전에 clone을 둘 위치를 먼저 고릅니다.
clone이 끝나면 그 cloned repository를 작업 폴더로 엽니다.
폴더 복제가 무사히 끝나면 다음과 같은 화면을 확인할 수 있습니다.
두 번째 방법
GitHub에서 repository URL을 복사합니다.
GitHub에서 복사한 repository URL을 VS Code에 직접 붙여넣는 방법도 있습니다.
세 번째 방법
터미널에 다음 명령을 입력하세요.
git clone <repository-url>
cd <repository-folder>
Fork
다른 사람의 public repository를 복사하고 싶다면, Fork를 이용하세요.
clone된 repository가 VS Code에 열려 있고 프로젝트 파일이 그 안에 들어갔다면 첫 commit과 push 흐름으로 넘어갑니다.
자주 발생하는 문제
- 잘못된 상위 folder에서 clone하면 예상하지 않은 중첩 project 경로가 생깁니다.
- Private repository를 clone하려면 browser 또는 VS Code 인증을 먼저 완료해야 합니다.
완료 확인
Clone한 folder 안에서 git status가 repository 오류 없이 예상한 branch를 표시합니다.