GitLab for VS Code 확장 프로그램 설치 및 설정
GitLab v19.2GitLab for VS Code 확장 프로그램을 사용하려면 확장 프로그램을 설치하고, GitLab에 연결한 후 필요에 따라 구성하세요. 필요에 맞는 설치 방법을 선택하세요: 표준 VS Code의 경우, Visual Studio Marketplace에서 설치하세요.
GitLab for VS Code 확장 프로그램을 사용하려면 확장 프로그램을 설치하고, GitLab에 연결한 후 필요에 따라 구성하세요.
확장 프로그램 설치#
필요에 맞는 설치 방법을 선택하세요:
-
표준 VS Code의 경우, Visual Studio Marketplace에서 설치하세요.
-
비공식 VS Code 버전의 경우, Open VSX Registry에서 설치하세요.
-
보안 로컬 개발 환경의 경우, Visual Studio Code Dev Container에 설치하세요.
Visual Studio Code Dev Container에 설치#
보안을 강화하려면 VS Code Dev Containers를 사용하여 컨테이너화된 개발 환경에서 확장 프로그램을 설정하고 GitLab Duo를 사용하세요.
사전 조건:
-
Docker가 설치되어 실행 중이어야 합니다.
-
Visual Studio Code Dev Containers 확장 프로그램이 VS Code에 설치되어 있어야 합니다.
VS Code Dev Container에 확장 프로그램을 설치하려면:
-
Command Palette에서 Dev Containers: Add Dev Container Configuration Files 명령을 실행하세요.
-
구성 파일에 GitLab 확장 프로그램을 추가하세요:
// .devcontainer/devcontainer.json
{
"name": "My Project",
"image": "mcr.microsoft.com/devcontainers/base:ubuntu",
"customizations": {
"vscode": {
"extensions": [
"GitLab.gitlab-workflow"
]
}
}
}
- Dev Containers: Open Folder in Container 명령을 실행하여 VS Code Dev Container에서 프로젝트를 여세요. VS Code가 컨테이너 내부에 확장 프로그램을 자동으로 설치합니다.
GitLab 연결#
확장 프로그램을 설치한 후, 인증하고 GitLab의 리포지터리에 프로젝트를 연결하세요.
GitLab 인증#
History
-
GitLab 18.3 릴리즈 중 GitLab for VS Code 6.47.0에서 GitLab Self-Managed 및 GitLab Dedicated를 위한 OAuth 인증이 도입됨.
GitLab.com
사전 조건:
-
PAT를 사용한 인증의 경우,
api범위의 개인 액세스 토큰이 필요합니다.
GitLab에 인증하려면:
- Command Palette를 여세요:
macOS에서는 Command+Shift+P를 누르세요.
-
Windows 또는 Linux에서는 Control+Shift+P를 누르세요.
-
GitLab: Authenticate를 입력하고 Enter를 누르세요. -
옵션에서 GitLab 인스턴스 URL을 선택하거나 직접 입력하세요.
직접 입력하는 경우, URL to GitLab instance에 http:// 또는 https://를 포함한 전체 URL을 붙여넣으세요. Enter를 눌러 확인하세요.
- 인증 방법(OAuth 또는 PAT)을 선택하세요.
OAuth의 경우, 안내에 따라 로그인하고 인증하세요.
-
PAT의 경우, 안내에 따라 토큰을 생성하거나 기존 토큰을 입력하여 인증하세요.
GitLab Self-Managed 및 GitLab Dedicated
사전 조건:
-
OAuth를 사용한 인증의 경우, VS Code용 OAuth 애플리케이션의 애플리케이션 ID가 필요합니다.
-
PAT를 사용한 인증의 경우,
api범위의 개인 액세스 토큰이 필요합니다.
OAuth를 사용하려면 먼저 OAuth 애플리케이션 로그인을 구성하세요:
- Command Palette를 여세요:
macOS에서는 Command+Shift+P를 누르세요.
-
Windows 또는 Linux에서는 Control+Shift+P를 누르세요.
-
Preferences: Open User Settings를 입력하고 Enter를 누르세요. -
Settings > Extensions > GitLab > Authentication을 선택하세요.
-
OAuth Client IDs 아래에서 Add Item을 선택하세요.
-
Key를 선택하고 GitLab 인스턴스 URL을 입력하세요.
-
Value를 선택하고 OAuth 애플리케이션의 ID를 입력하세요.
GitLab에 인증하려면:
- Command Palette를 여세요:
macOS에서는 Command+Shift+P를 누르세요.
-
Windows 또는 Linux에서는 Control+Shift+P를 누르세요.
-
GitLab: Authenticate를 입력하고 Enter를 누르세요. -
옵션에서 GitLab 인스턴스 URL을 선택하거나 직접 입력하세요.
직접 입력하는 경우, URL to GitLab instance에 http:// 또는 https://를 포함한 전체 URL을 붙여넣으세요. Enter를 눌러 확인하세요.
- 인증 방법(OAuth 또는 PAT)을 선택하세요.
OAuth의 경우, 안내에 따라 로그인하고 인증하세요.
- PAT의 경우, 안내에 따라 토큰을 생성하거나 기존 토큰을 입력하여 인증하세요.
확장 프로그램은 Git 리포지터리 원격 URL을 토큰에 지정한 GitLab 인스턴스 URL과 매칭합니다. 여러 계정이나 프로젝트가 있는 경우, 사용할 항목을 선택할 수 있습니다.
GitLab 인스턴스 또는 네트워크에서 커스텀 SSL 설정을 사용하는 경우, 자체 서명 인증서를 지원하도록 확장 프로그램을 구성할 수 있습니다. 자세한 내용은 자체 서명 인증서와 함께 확장 프로그램 사용을 참조하세요.
리포지터리 연결#
VS Code에서 GitLab 리포지터리에 연결하려면:
-
VS Code의 상단 메뉴에서 Terminal > New Terminal을 선택하세요.
-
리포지터리를 클론하세요:
git clone <repository>. -
리포지터리가 클론된 디렉터리로 이동하고 브랜치를 체크아웃하세요:
git checkout <branch_name>. -
프로젝트가 선택되어 있는지 확인하세요:
왼쪽 사이드바에서 GitLab ( tanuki )을 선택하세요.
-
프로젝트 이름을 선택하세요. 여러 프로젝트가 있는 경우, 작업할 프로젝트를 선택하세요.
-
터미널에서 리포지터리에 원격이 구성되어 있는지 확인하세요:
git remote -v. 결과는 다음과 유사하게 표시됩니다:
origin git@gitlab.com:gitlab-org/gitlab.git (fetch)
origin git@gitlab.com:gitlab-org/gitlab.git (push)
원격이 정의되지 않았거나 여러 원격이 있는 경우:
왼쪽 사이드바에서 Source Control ( branch )을 선택하세요.
-
Source Control 레이블을 마우스 오른쪽 버튼으로 클릭하고 Repositories를 선택하세요.
-
리포지터리 옆에서 줄임표 ( ellipsis_h )를 선택한 후, Remote > Add Remote를 선택하세요.
-
Add remote from GitLab을 선택하세요.
-
원격을 선택하세요.
다음 두 조건이 모두 충족될 경우 확장 프로그램이 VS Code 상태 표시줄에 정보를 표시합니다:
-
프로젝트에 마지막 커밋에 대한 파이프라인이 있는 경우.
-
현재 브랜치가 머지 리퀘스트와 연결되어 있는 경우.
확장 프로그램 구성#
설정을 구성하려면 Settings > Extensions > GitLab으로 이동하세요.
계정 및 프로젝트 구성#
인증하고 리포지터리에 연결한 후, 확장 프로그램은 Git 리포지터리 구성을 기반으로 GitLab 계정과 프로젝트를 자동으로 연결합니다.
일부 환경에서는 자격 증명을 유지하기 위해 추가 구성이 필요할 수 있습니다.
환경 변수에 토큰 저장#
Gitpod 컨테이너와 같이 VS Code 저장소를 자주 삭제하는 경우, 인증 토큰을 VS Code 환경 변수에 저장하세요. 환경 변수는 VS Code 저장소를 삭제해도 유지됩니다.
VS Code를 시작하기 전에 다음 변수를 설정하세요:
-
GITLAB_WORKFLOW_INSTANCE_URL: GitLab 인스턴스 URL. 예:https://gitlab.com. -
GITLAB_WORKFLOW_TOKEN: 개인 액세스 토큰.
동일한 GitLab 인스턴스에 대해 확장 프로그램에서 토큰을 구성하면, 확장 프로그램 토큰이 환경 변수를 재정의합니다.
계정 전환#
확장 프로그램은 각 VS Code 워크스페이스(창)에 하나의 계정을 사용합니다. 다음 경우에 자동으로 계정을 선택합니다:
-
확장 프로그램에 하나의 GitLab 계정만 인증된 경우.
-
VS Code 창의 모든 워크스페이스가
git remote구성을 기반으로 동일한 GitLab 계정을 사용하는 경우.
여러 GitLab 계정이 있고 확장 프로그램이 사용할 계정을 결정할 수 없는 경우, 상태 표시줄에 Multiple GitLab Accounts ( question-o )가 추가됩니다. GitLab 계정을 선택하려면 상태 표시줄 항목을 선택하고 안내를 따르세요.
또는 Command Palette를 사용할 수 있습니다:
- Command Palette를 여세요:
macOS에서는 Command+Shift+P를 누르세요.
-
Windows 또는 Linux에서는 Control+Shift+P를 누르세요.
-
GitLab: Select Account for this Workspace명령을 실행하세요. -
목록에서 계정을 선택하세요.
프로젝트 선택#
확장 프로그램은 Git 리포지터리 원격을 사용하여 VS Code 워크스페이스와 연결할 GitLab 프로젝트를 결정합니다.
Git 리포지터리에 서로 다른 GitLab 프로젝트를 가리키는 여러 원격이 있는 경우, 확장 프로그램은 어떤 것을 사용할지 결정할 수 없습니다. 예를 들어:
-
origin:git@gitlab.com:gitlab-org/gitlab-vscode-extension.git -
personal-fork:git@gitlab.com:myusername/gitlab-vscode-extension.git
이러한 경우, 확장 프로그램은 상태 표시줄에 (multiple projects) 레이블을 추가합니다.
프로젝트를 선택하려면:
-
왼쪽 사이드바에서 GitLab ( tanuki )을 선택하세요.
-
Issues and merge requests를 펼치세요.
-
**(multiple projects, click to select)**가 포함된 줄을 선택하세요.
-
목록에서 프로젝트를 선택하세요.
Issues and merge requests 목록이 선택한 프로젝트의 정보로 업데이트됩니다.
프로젝트 변경#
프로젝트 선택을 변경하려면:
-
왼쪽 사이드바에서 GitLab ( tanuki )을 선택하세요.
-
Issues and merge requests를 펼치세요.
-
프로젝트를 선택하세요.
-
프로젝트 이름 옆에서 Clear Selected Project ( close-xs )를 선택하세요.
GitLab Duo 구성#
GitLab Duo 기능은 다음 사전 조건을 충족하면 VS Code에서 기본적으로 활성화됩니다:
-
에이전틱 기능의 경우, GitLab Duo Agent Platform의 사전 조건을 충족해야 합니다.
-
GitLab Duo가 활성화되어 있어야 합니다.
-
플로우의 경우, 파운데이션 플로우가 활성화되어 있어야 합니다.
-
에이전트의 경우, 파운데이션 에이전트가 활성화되어 있고 필요에 따라 커스텀 에이전트가 활성화되어 있어야 합니다.
-
프로젝트가 그룹 네임스페이스에 있어야 합니다.
-
기본 GitLab Duo 네임스페이스가 설정되어 있거나 GitLab Duo 액세스 권한이 있는 프로젝트가 열려 있어야 합니다.
-
GitLab Duo Code Suggestions의 경우:
지원되는 언어 및 IDE를 사용해야 합니다.
- 선택 사항. GitLab 프로젝트 외부에서 사용하려면:
VS Code에서 설정 편집기를 엽니다:
macOS의 경우 Command+,를 누릅니다.
-
Windows 또는 Linux의 경우 Control+,를 누릅니다.
-
Extensions > GitLab > GitLab Duo > GitLab › Duo: Enabled Without GitLab Project를 선택합니다.
Agentic Chat 도구를 개별적으로 승인하는 대신 세션당 한 번 승인하려면, 도구 승인을 참조하세요.
GitLab Duo 비활성화#
VS Code에서 GitLab Duo 기능을 비활성화하려면:
- VS Code에서 Settings 편집기를 여세요:
macOS에서는 Command+,를 누르세요.
-
Windows 또는 Linux에서는 Control+,를 누르세요.
-
Extensions > GitLab > GitLab Duo를 선택하세요.
-
비활성화할 기능을 찾아 체크박스를 해제하세요.
텔레메트리 구성#
GitLab for VS Code는 Visual Studio Code의 텔레메트리 설정을 사용하여 사용 및 오류 정보를 GitLab에 전송합니다. Visual Studio Code에서 텔레메트리를 활성화하거나 사용자 지정하려면:
- VS Code에서 Settings 편집기를 여세요:
macOS에서는 Command+,를 누르세요.
-
Windows 또는 Linux에서는 Control+,를 누르세요.
-
Application > Telemetry를 선택하세요.
-
Telemetry Level에서 공유할 데이터를 선택하세요:
all: 사용 데이터, 일반 오류 텔레메트리, 크래시 리포트를 전송합니다.
-
error: 일반 오류 텔레메트리 및 크래시 리포트를 전송합니다. -
crash: OS 수준의 크래시 리포트를 전송합니다. -
off: Visual Studio Code의 모든 텔레메트리 데이터를 비활성화합니다. -
변경 사항을 저장하세요.