JetBrains Plugin Marketplace에서 플러그인을 다운로드하여 설치합니다.

사전 요구 사항:

• JetBrains IDE: 2025.1 이상.
• GitLab 버전: 16.8 이상.

이전 버전의 JetBrains IDE를 사용한다면 사용 중인 IDE와 호환되는 버전의 플러그인을 다운로드합니다.

1. GitLab Duo 플러그인 페이지에서 Versions를 선택합니다.
2. Compatibility를 선택한 다음 사용 중인 JetBrains IDE를 선택합니다.
3. 안정 릴리스 또는 알파 릴리스로 필터링하려면 Channel을 선택합니다.
4. 호환성 표에서 사용 중인 IDE 버전을 찾아 Download를 선택합니다.

플러그인 활성화#

플러그인을 활성화하려면 다음 단계를 따릅니다.

1. IDE 상단 바에서 IDE 이름을 선택한 다음 Settings를 선택합니다.
2. 왼쪽 사이드바에서 Plugins를 선택합니다.
3. GitLab Duo 플러그인을 선택하고 Install을 선택합니다.
4. OK 또는 Save를 선택합니다.

GitLab에 연결#

확장 프로그램을 설치한 후 GitLab 계정에 연결합니다.

GitLab으로 인증#

사전 요구 사항:

• OAuth를 사용해 GitLab Self-Managed 및 GitLab Dedicated에서 인증하는 경우:
  • JetBrains 용 GitLab Duo 플러그인 3.30.30 이상.
  • 인스턴스 전체 JetBrains IDE 용 OAuth 애플리케이션의 애플리케이션 ID.
• PAT를 사용해 인증하는 경우, api 범위가 있는 개인 액세스 토큰.
• 1Password로 인증하는 경우, 1Password 연동 단계 완료 및 시크릿 참조.

IDE에서 플러그인을 구성한 후 GitLab 계정에 연결합니다.

1. IDE 상단 바에서 IDE 이름을 선택한 다음 Settings를 선택합니다.
2. 왼쪽 사이드바에서 Tools를 확장한 다음 GitLab Duo를 선택합니다. 플러그인이 목록에 표시되지 않으면 IDE를 재시작합니다.
3. URL to GitLab instance를 입력합니다. GitLab.com의 경우 https://gitlab.com을 사용합니다.
4. 인증 방법으로 OAuth, PAT, 1Password CLI 중 하나를 선택합니다.
   • OAuth의 경우 안내에 따라 로그인하고 인증합니다.
   • PAT의 경우 개인 액세스 토큰을 입력합니다. 토큰 값은 표시되지 않으며 다른 사람이 액세스할 수 없습니다.
   • 1Password의 경우 Integrate with 1Password CLI를 선택하고 계정을 선택한 다음, 필요하다면 시크릿 참조를 입력합니다.
5. Verify setup을 선택합니다.
6. OK 또는 Save를 선택합니다.

GitLab Duo 구성#

사전 요구 사항:

• 에이전틱 기능을 사용하려면 GitLab Duo Agent Platform의 사전 요구 사항을 충족해야 합니다.
• GitLab Duo가 켜져 있어야 합니다.
• 플로를 사용하려면 foundational flows가 켜져 있어야 합니다.
• 에이전트를 사용하려면 foundational agents가 켜져 있어야 하며, 필요에 따라 사용자 지정 에이전트가 활성화되어 있어야 합니다.
• Code Suggestions를 사용하려면 추가 사전 요구 사항을 충족해야 합니다.
• 프로젝트가 그룹 네임스페이스에 있어야 합니다.
• 기본 GitLab Duo 네임스페이스가 설정되어 있거나 GitLab Duo 액세스 권한이 있는 프로젝트를 열어 두어야 합니다.

GitLab Duo 기능을 켜거나 끄려면 다음 단계를 따릅니다.

1. JetBrains IDE에서 Settings > Tools > GitLab Duo로 이동합니다.
2. 변경할 기능을 찾아 확인란을 선택하거나 선택 해제합니다.
3. OK 또는 Save를 선택합니다.
4. 메시지가 표시되면 IDE를 재시작합니다.

Code Suggestions가 켜져 있으면 더 많은 언어에 대한 지원을 추가할 수도 있습니다.

Agentic Chat 도구를 개별적으로 승인하지 않고 세션당 한 번만 승인하려면 도구 승인을 참고합니다.

Code Suggestions용 사용자 지정 인증서 추가#

히스토리

• GitLab 17.2 릴리스 중 JetBrains IDE용 GitLab Duo 플러그인 2.10.0에서 도입되었습니다.

GitLab Duo는 별도 구성 없이 신뢰할 수 있는 루트 인증서를 감지하려고 시도합니다. 필요한 경우 GitLab Duo 플러그인이 GitLab 인스턴스에 연결할 때 사용자 지정 SSL 인증서를 사용할 수 있도록 JetBrains IDE를 구성합니다.

GitLab Duo에서 사용자 지정 SSL 인증서를 사용하려면 다음과 같이 합니다:

1. JetBrains IDE에서 Settings > Tools > GitLab Duo로 이동합니다.
2. Connection 아래에서 URL to GitLab instance를 입력합니다.
3. 연결을 확인하려면 Verify setup을 선택합니다.
4. OK 또는 Save를 선택합니다.

IDE가 신뢰할 수 없는 SSL 인증서를 감지하면 GitLab Duo 플러그인이 메시지를 표시합니다. SSL 인증서 세부 정보를 검토하고, 브라우저에서 GitLab에 연결할 때 표시되는 인증서와 세부 정보가 일치하는지 확인합니다.

이미 수락한 인증서를 검토하려면 다음과 같이 합니다:

1. JetBrains IDE에서 Settings > Appearance & Behavior > System Settings > Server Certificates로 이동합니다.
2. 인증서를 선택하여 확인합니다.

GitLab Duo 직접 연결#

기본적으로 GitLab Language Server가 처리하는 GitLab Duo 및 기타 GitLab 기능의 트래픽은 JetBrains IDE 또는 시스템 환경의 프록시 설정을 사용합니다. 프록시가 이 트래픽을 차단한다면 해당 요청에 대해 프록시를 우회하도록 편집기 확장 프로그램을 구성할 수 있습니다.

GitLab Duo를 직접 연결하려면 다음 단계를 따릅니다.

1. JetBrains IDE에서 Settings > Tools > GitLab Duo로 이동합니다.
2. Advanced > GitLab Language Server에서 Connect GitLab Duo directly from the Language Server를 선택합니다.
3. OK 또는 Apply를 선택합니다.

이 설정은 GitLab Language Server가 처리하는 트래픽에만 영향을 줍니다. 그 밖의 편집기 확장 프로그램 네트워크 요청은 계속해서 편집기의 프록시 구성을 사용합니다.

플러그인 알파 버전 설치#

GitLab은 JetBrains Marketplace의 Alpha 릴리스 채널에 플러그인의 사전 릴리스(알파) 빌드를 게시합니다.

사전 릴리스 빌드를 설치하려면 다음 중 하나를 수행합니다.

• JetBrains Marketplace에서 빌드를 다운로드한 후 디스크에서 설치합니다.

• alpha 플러그인 리포지터리를 추가합니다. 리포지터리 URL로 https://plugins.jetbrains.com/plugins/alpha/list를 사용합니다.

  [!note] alpha 플러그인 리포지터리를 추가한 후 알파 릴리스를 보려면 GitLab Duo 플러그인을 제거했다가 다시 설치해야 할 수 있습니다.

이 과정에 대한 동영상 튜토리얼은 JetBrains 용 GitLab Duo 플러그인 알파 릴리스 설치를 참고합니다.