VS Code에서는 Git 리포지터리를 클론하거나 읽기 전용 모드로 탐색할 수 있습니다.

GitLab 원격 URL에는 다음 매개변수가 필요합니다:

• instanceUrl: https:// 또는 http://를 포함하지 않은 GitLab 인스턴스 URL.

GitLab 인스턴스가 상대 URL을 사용하는 경우, URL에 상대 URL을 포함하세요.

• 예를 들어, example.com/gitlab 인스턴스의 templates/ui 프로젝트 main 브랜치 URL은 gitlab-remote://example.com/gitlab/<label>?project=templates/ui&ref=main입니다.

• label: Visual Studio Code가 이 워크스페이스 폴더의 이름으로 사용하는 텍스트:

인스턴스 URL 바로 뒤에 위치해야 합니다.

• / 또는 ?와 같은 이스케이프되지 않은 URL 구성 요소를 포함할 수 없습니다.

• https://gitlab.com과 같이 도메인 루트에 설치된 인스턴스의 경우, label은 첫 번째 경로 요소여야 합니다.

• 리포지터리 루트를 참조하는 URL의 경우, label은 마지막 경로 요소여야 합니다.

• VS Code는 label 이후에 나타나는 경로 요소를 리포지터리 내부 경로로 처리합니다. 예를 들어, gitlab-remote://gitlab.com/GitLab/app?project=gitlab-org/gitlab&ref=master는 GitLab.com의 gitlab-org/gitlab 리포지터리의 app 디렉터리를 참조합니다.

• projectId: 프로젝트의 숫자 ID(예: 5261717) 또는 네임스페이스(gitlab-org/gitlab-vscode-extension) 중 하나를 사용할 수 있습니다. 인스턴스가 역방향 프록시를 사용하는 경우, 숫자 ID로 projectId를 지정하세요. 자세한 내용은 이슈 18775를 참조하세요.

• gitReference: 리포지터리 브랜치 또는 커밋 SHA.

매개변수는 다음 순서로 조합됩니다:

gitlab-remote://<instanceUrl>/<label>?project=<projectId>&ref=<gitReference>

예를 들어, 메인 GitLab 프로젝트의 projectId는 278964이므로, 메인 GitLab 프로젝트의 원격 URL은 다음과 같습니다:

gitlab-remote://gitlab.com/<label>?project=278964&ref=master

Git 프로젝트 클론#

VS Code용 GitLab은 Git: Clone 명령을 확장합니다. GitLab 프로젝트의 경우, HTTPS 또는 Git URL을 사용한 클론을 지원합니다.

사전 요구사항:

• GitLab 인스턴스에서 검색 결과를 반환하려면, 해당 GitLab 인스턴스에 액세스 토큰을 추가해야 합니다.

• 검색 결과에 프로젝트가 나타나려면 해당 프로젝트의 멤버여야 합니다.

GitLab 프로젝트를 검색하고 클론하려면:

• 다음을 눌러 명령 팔레트를 엽니다:

MacOS: Command+Shift+P.

• Windows: Control+Shift+P.

• Git: Clone 명령을 실행합니다.

• 리포지터리 소스로 GitHub 또는 GitLab을 선택합니다.

• Repository name을 검색하고 선택합니다.

• 리포지터리를 클론할 로컬 폴더를 선택합니다.

• GitLab 리포지터리를 클론하는 경우, 클론 방법을 선택합니다:

Git으로 클론하려면 user@hostname.com으로 시작하는 URL을 선택합니다.

• HTTPS로 클론하려면 https://로 시작하는 URL을 선택합니다. 이 방법은 액세스 토큰을 사용하여 리포지터리를 클론하고, 커밋을 페치하며, 커밋을 푸시합니다.

• 클론된 리포지터리를 열지, 아니면 현재 VS Code 워크스페이스에 추가할지 선택합니다.

읽기 전용 모드로 리포지터리 탐색#

이 확장 프로그램을 사용하면 GitLab 리포지터리를 클론하지 않고 읽기 전용 모드로 탐색할 수 있습니다.

사전 요구사항:

• 해당 GitLab 인스턴스에 대한 액세스 토큰을 등록해야 합니다.

GitLab 리포지터리를 읽기 전용 모드로 탐색하려면:

• 다음을 눌러 명령 팔레트를 엽니다:

MacOS: Command+Shift+P.

• Windows: Control+Shift+P.

• GitLab: Open Remote Repository 명령을 실행합니다.

• Open in current window, Open in new window, 또는 Add to workspace를 선택합니다.

• 리포지터리를 추가하려면 Enter gitlab-remote URL을 선택하고, 원하는 프로젝트의 gitlab-remote:// URL을 입력합니다.

• 이미 추가한 리포지터리를 보려면 Choose a project를 선택한 다음, 드롭다운 목록에서 원하는 프로젝트를 선택합니다.

• 드롭다운 목록에서 보려는 Git 브랜치를 선택하고 Enter를 눌러 확인합니다.

VS Code 워크스페이스 파일에 gitlab-remote URL을 추가하려면 VS Code 문서의 Workspace file을 참조하세요.