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 플러그인 마켓플레이스에서 플러그인을 다운로드하세요.

전제 조건:

  • 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 Dedicated의 경우, 개인 접근 토큰을 사용하세요.
  4. GitLab 인스턴스의 URL을 제공하세요. GitLab.com의 경우, https://gitlab.com을 사용하세요.
  5. GitLab 개인 접근 토큰을 붙여넣으세요. 이 토큰은 표시되지 않으며 다른 사람이 액세스할 수 없습니다.
  6. 설정 확인을 선택하세요.
  7. 확인 또는 저장을 선택하세요.

실험 또는 베타 기능 활성화

플러그인의 일부 기능은 실험 또는 베타 상태입니다. 이들을 사용하려면 수락해야 합니다:

  1. IDE의 상단 메뉴 바에서 설정을 선택하거나:
    • MacOS: ⌘+,를 누르세요.
    • Windows 또는 Linux: Control+Alt+S를 누르세요.
  2. 왼쪽 사이드바에서 도구를 확장한 다음 GitLab Duo를 선택하세요.
  3. 실험 또는 BETA 기능 활성화를 선택하세요.
  4. 변경 사항을 적용하려면 IDE를 다시 시작하세요.

플러그인의 알파 버전 설치

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

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

이 과정에 대한 비디오 튜토리얼은 JetBrains용 GitLab Duo 플러그인의 알파 릴리스 설치를 참조하세요.

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

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

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

  1. IDE에서 상단 바에서 IDE 이름을 선택한 다음 설정을 선택하세요.
  2. 왼쪽 사이드바에서 도구를 확장한 다음 GitLab Duo를 선택하세요.
  3. 연결 아래에 GitLab 인스턴스 URL을 입력하세요.
  4. 연결을 확인하려면 설정 확인을 선택하세요.
  5. 확인 또는 저장을 선택하세요.

IDE가 신뢰할 수 없는 SSL 인증서를 감지하면:

  1. GitLab Duo 플러그인이 확인 대화 상자를 표시합니다.
  2. 표시된 SSL 인증서 세부 정보를 확인하세요.
    • SSL 인증서 세부 정보가 브라우저에서 GitLab에 연결할 때 표시되는 인증서와 일치하는지 확인하세요.
  3. 인증서가 기대한 것과 일치하는 경우 수락을 선택하세요.

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

  1. IDE에서 상단 바에서 IDE 이름을 선택한 다음 설정을 선택하세요.
  2. 왼쪽 사이드바에서 도구 > 서버 인증서를 선택하세요.
  3. 서버 인증서를 선택하세요.
  4. 인증서를 선택하여 보세요.

1Password CLI 통합

Tier: Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

개인 엑세스 토큰을 하드코딩하는 대신 플러그인을 1Password 기반 인증을 사용하도록 구성할 수 있습니다.

필수 조건:

  • 1Password 데스크톱 앱이 설치되어 있어야 합니다.
  • 1Password CLI 도구가 설치되어 있어야 합니다.

1Password CLI를 GitLab for JetBrains와 통합하려면:

  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. 1Password CLI와 통합을 선택합니다.
  5. 선택 사항. 비밀 참조에 1Password에서 복사한 비밀 참조를 붙여넣습니다.
  6. 자격 증명을 확인하려면 설정 확인을 선택합니다.
  7. OK 또는 저장을 선택합니다.

플러그인 문제 신고

gitlab-jetbrains-plugin 이슈 대기열에서 문제, 버그 또는 기능 요청을 신고할 수 있습니다. Bug 또는 Feature Proposal 템플릿을 사용하세요.

GitLab Duo 사용 중 오류가 발생하는 경우 IDE의 내장 오류 보고 도구를 사용하여도 됩니다:

  1. 도구에 액세스하려면 다음 중 하나:
    • 오류가 발생하면 오류 메시지에서 세부정보 보기 및 보고를 선택합니다.
    • 하단 오른쪽 상태 표시줄에서 느낌표를 선택합니다.
  2. IDE 내부 오류 대화 상자에서 오류를 설명합니다.
  3. 보고 및 모두 지우기를 선택합니다.
  4. 브라우저에서 디버그 정보가 미리 채워진 GitLab 이슈 양식이 열립니다.
  5. 이슈 양식의 지침에 따라 가능한 많은 컨텍스트를 제공하여 설명을 작성합니다.
  6. 버그 보고서를 제출하려면 이슈 생성을 선택합니다.

관련 주제