Git 리포지터리를 로컬 컴퓨터에 복제하기

리포지터리를 복제하면 서버와의 연결이 생성되고 원격 리포지터리에서 파일이 컴퓨터로 다운로드됩니다.

이 연결에는 자격 증명을 추가해야 합니다. SSH 또는 HTTPS를 사용할 수 있습니다. SSH를 권장합니다.

SSH로 복제

한 번만 인증하려면 SSH로 복제합니다.

  1. SSH 문서의 지침을 따라 GitLab에서 인증합니다.
  2. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 복제하려는 프로젝트를 찾습니다.
  3. 프로젝트의 개요 페이지에서 오른쪽 상단에 있는 코드를 선택한 후 SSH로 복제의 URL을 복사합니다.
  4. 터미널을 열고 파일을 복제하려는 디렉터리로 이동합니다. Git은 자동으로 리포지터리 이름의 폴더를 만들고 파일을 다운로드합니다.

  5. 다음 명령을 실행합니다: 

    git clone <복사한 URL>

  6. 파일을 보려면 새 디렉터리로 이동합니다: 

    cd <새 디렉터리>

또한 리포지터리를 복제하고 Visual Studio Code에서 직접 엽니다 .

HTTPS로 복제

컴퓨터와 GitLab 간에 작업을 수행할 때마다 매번 인증하려면 HTTPS로 복제합니다. OAuth 자격 증명 도우미를 사용하면 매뉴얼으로 인증해야 하는 횟수를 줄일 수 있어 HTTPS를 원활하게 사용할 수 있습니다.

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 복제하려는 프로젝트를 찾습니다.
  2. 프로젝트의 개요 페이지에서 오른쪽 상단에 있는 코드를 선택한 후 HTTPS로 복제의 URL을 복사합니다.
  3. 터미널을 열고 파일을 복제하려는 디렉터리로 이동합니다.

  4. 다음 명령을 실행합니다. Git은 리포지터리 이름의 폴더를 자동으로 만들고 파일을 다운로드합니다. 

    git clone <복사한 URL>

  5. GitLab에서 사용자 이름과 암호를 요청합니다.

    계정에 두 단계 인증(2FA)을 활성화한 경우 계정 암호를 사용할 수 없습니다. 대신 다음 중 하나를 수행할 수 있습니다:

    • read_repository 또는 write_repository 권한을 가진 토큰을 사용하여 복제합니다.
    • OAuth 자격 증명 도우미를 설치합니다.

    2FA를 활성화하지 않은 경우 계정 암호를 사용합니다.

  6. 파일을 보려면 새 디렉터리로 이동합니다: 

    cd <새 디렉터리>
note
Windows에서 비밀번호를 여러 번 잘못 입력하면 “액세스 거부” 메시지가 표시되므로, 네임스페이스(사용자 이름 또는 그룹)를 경로에 추가하세요: git clone https://namespace@gitlab.com/gitlab-org/gitlab.git.

토큰을 사용하여 복제

다음 경우에 HTTPS를 사용하여 토큰을 이용하여 복제합니다.

  • 2FA를 사용하려는 경우
  • 하나 이상의 리포지터리에 대해 범위가 지정된 취소할 수 있는 자격 증명 세트를 사용하려는 경우.

HTTPS를 통해 복제할 때 인증에 다음 토큰 중 하나를 사용할 수 있습니다:

예: 

git clone https://<사용자명>:<토큰>@gitlab.example.com/tanuki/awesome_project.git