JetBrains IDE를 위한 GitLab 플러그인

GitLab Duo 플러그인은 IntelliJ, PyCharm, GoLand, Webstorm, Rubymine과 같은 JetBrains IDE와 GitLab Duo를 통합합니다. 이 플러그인은 다음의 GitLab 기능을 지원합니다:

코딩 중에 Tab를 눌러 코드 제안을 수락합니다. 코드 제안을 거부하려면 Escape를 누릅니다.

이 JetBrains 플러그인은 IDE의 상태 표시줄에 아이콘을 추가합니다:

아이콘 상태 의미
준비 완료 GitLab Duo를 구성하고 활성화했으며, 코드 제안을 지원하는 언어를 사용하고 있습니다.
구성되지 않음 개인 액세스 토큰을 입력하지 않았거나, 코드 제안을 지원하지 않는 언어를 사용하고 있습니다.
코드 제안을 가져오는 상태 아이콘. 제안 로딩 중 GitLab Duo가 코드를 제안하기 위해 데이터를 가져오고 있습니다.
코드 제안 오류에 대한 상태 아이콘. 오류 GitLab Duo에서 오류가 발생했습니다.

확장 프로그램 다운로드

JetBrains Plugin Marketplace에서 플러그인을 다운로드하세요.

사전 요구 사항:

  • JetBrains IDE: 2023.2.X 이상
  • GitLab 버전 16.8 이상

이전 버전의 JetBrains IDE를 사용하고 있다면, 마켓플레이스 목록에서 버전 호환성 목록을 확인하세요. 여기에는 플러그인 버전과 해당 지원되는 IDE 버전에 대한 표가 포함되어 있습니다.

확장 프로그램 구성

사전 요구 사항:

플러그인을 활성화하려면:

  1. IDE에서 상단 바의 IDE 이름을 선택한 다음 설정을 선택합니다.
  2. 왼쪽 사이드바에서 플러그인을 선택합니다.
  3. GitLab Duo 플러그인을 선택한 다음 설치를 선택합니다.
  4. 확인 또는 저장을 선택합니다.

플러그인을 활성화한 후 IDE에서 플러그인을 구성하려면:

  1. IDE의 상단 메뉴 바로 가서 설정을 선택합니다.
  2. 왼쪽 사이드바에서 도구를 확장한 다음 GitLab Duo를 선택합니다.
  3. 인증 방법을 선택합니다:
    • GitLab.com의 경우 OAuth를 사용합니다.
    • 자기 관리형 및 GitLab 전용의 경우 개인 액세스 토큰을 사용합니다.
  4. GitLab 인스턴스 URL을 제공합니다. GitLab.com의 경우 https://gitlab.com을 사용합니다.
  5. GitLab 개인 액세스 토큰에 생성한 개인 액세스 토큰을 붙여넣습니다. 이 토큰은 표시되지 않으며, 다른 사람들이 접근할 수 없습니다.
  6. 설정 확인을 선택합니다.
  7. 확인 또는 저장을 선택합니다.

실험적 또는 베타 기능 활성화

플러그인의 일부 기능은 실험 또는 베타 상태에 있습니다. 이를 사용하려면 선택해야 합니다:

  1. IDE의 상단 메뉴 바에서 Settings를 선택하거나:
    • MacOS: ⌘+,를 눌렀습니다.
    • Windows나 Linux: Control+Alt+S를 눌렀습니다.
  2. 왼쪽 사이드바에서 Tools를 확장한 후 GitLab Duo를 선택합니다.
  3. Enable Experiment or BETA features를 선택합니다.
  4. 변경 사항을 적용하려면 IDE를 재시작합니다.

플러그인의 알파 버전 설치

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

사전 릴리스 빌드를 설치하려면 다음 중 하나를 선택하세요:

이 프로세스에 대한 비디오 자습서를 보려면 JetBrains용 GitLab Duo 플러그인의 알파 릴리스 설치를 참조하세요.

코드 제안을 위한 사용자 지정 인증서 추가

History

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

GitLab Duo와 함께 사용자 지정 SSL 인증서를 사용하려면:

  1. IDE의 상단 바에서 IDE 이름을 선택한 후 Settings를 선택합니다.
  2. 왼쪽 사이드바에서 Tools를 확장한 후 GitLab Duo를 선택합니다.
  3. Connection 아래에 URL to GitLab instance를 입력합니다.
  4. 연결을 확인하려면 Verify setup을 선택합니다.
  5. OK 또는 Save를 선택합니다.

IDE가 신뢰되지 않는 SSL 인증서를 감지하는 경우:

  1. GitLab Duo 플러그인은 확인 대화 상자를 표시합니다.
  2. 표시된 SSL 인증서 세부 정보를 검토합니다.
    • 인증서 세부 정보가 브라우저에서 GitLab에 연결할 때 표시되는 인증서와 일치하는지 확인합니다.
  3. 인증서가 예상과 일치하면 Accept를 선택합니다.

이미 수락한 인증서를 검토하려면:

  1. IDE의 상단 바에서 IDE 이름을 선택한 후 Settings를 선택합니다.
  2. 왼쪽 사이드바에서 Tools > Server Certificates를 선택합니다.
  3. Server Certificates를 선택합니다.
  4. 인증서를 선택하여 확인합니다.

1Password CLI와 통합

Tier: Premium, Ultimate

Offering: GitLab.com, Self-managed, GitLab Dedicated

History
  • Introduced in GitLab Duo 2.1 for GitLab 16.11 and later.

플러그인을 구성하여 개인_ACCESS_TOKEN을 하드 코딩하는 대신 1Password 비밀 참조를 인증에 사용합니다.

선행 조건:

JetBrains용 GitLab을 1Password CLI와 통합하려면:

  1. GitLab에 인증합니다. 방법은 다음 중 하나입니다:
  2. 1Password 항목을 엽니다.

  3. 비밀 참조 복사하기.

    gitlab 1Password 셸 플러그인을 사용할 경우, 토큰은 "op://Private/GitLab Personal Access Token/token" 아래에 비밀번호로 저장됩니다.

IDE에서:

  1. IDE의 상단 메뉴 바에서 Settings를 선택합니다.
  2. 왼쪽 사이드바에서 Tools를 확장한 후 GitLab Duo를 선택합니다.
  3. Authentication 아래에서 1Password CLI 탭을 선택합니다.
  4. Integrate with 1Password CLI를 선택합니다.
  5. 선택 사항. Secret reference에 1Password에서 복사한 비밀 참조를 붙여넣습니다.
  6. 선택 사항. 자격 증명을 확인하려면 Verify setup을 선택합니다.
  7. OK 또는 Save를 선택합니다.

플러그인 문제 보고

문제, 버그 또는 기능 요청은 gitlab-jetbrains-plugin 이슈 큐에 보고할 수 있습니다.

Bug 또는 Feature Proposal 템플릿을 사용하세요.

GitLab Duo를 사용 중 오류가 발생한 경우, IDE의 내장 오류 보고 도구를 통해 보고할 수도 있습니다:

  1. 도구에 접근하려면:
    • 오류가 발생하면, 오류 메시지에서 자세히 보기 및 보고서 제출을 선택합니다.
    • 상태 표시줄의 오른쪽 하단에서 느낌표를 선택합니다.

  2. IDE 내부 오류 대화 상자에서 오류를 설명합니다.

  3. 모든 문제 보고 및 지우기를 선택합니다.

  4. 브라우저가 디버그 정보로 미리 채워진 GitLab 이슈 양식을 엽니다.

  5. 이슈 템플릿의 안내에 따라 설명을 작성하고, 가능한 한 많은 맥락을 제공합니다.

  6. 이슈 생성을 선택하여 버그 보고서를 제출합니다.

관련 주제