이 페이지의 단계로 문제가 해결되지 않으면 JetBrains 플러그인 프로젝트의 열린 이슈 목록을 확인하세요. 해당 문제와 일치하는 이슈가 있으면 이슈를 업데이트하세요. 일치하는 이슈가 없으면 새 이슈를 생성하고 지원에 필요한 정보를 제공하세요.

GitLab Duo 기능을 사용할 수 없음#

IDE에서 GitLab Duo 오류를 해결하려면:

• 사전 요구사항을 충족하는지 확인하고 필요한 설정이 켜져 있는지 확인하세요.

• Admin 모드가 비활성화되어 있는지 확인하세요.

• 진단 출력을 검토하세요:

JetBrains IDE에서 Tools > GitLab > Diagnostics로 이동하여 실패한 검사가 있는지 출력을 검토하세요.

• 진단에서 기능이 활성화되지 않았다고 표시되는 경우:

JetBrains IDE에서 Settings > Tools > GitLab Duo로 이동하세요.

• 누락된 기능을 활성화하는 체크박스를 찾아 선택하세요.

• OK 또는 Save를 선택하세요.

• 메시지가 표시되면 IDE를 재시작하세요.

• 진단에서 현재 프로젝트에 Agentic Chat이 지원되지 않는다고 표시되는 경우, 기본 GitLab Duo 네임스페이스를 설정하세요.

• JetBrains Remote Development를 사용하고 있으며 진단에서 누락된 기능이 활성화되어 있다고 표시되는 경우, GitLab Duo 플러그인이 호스트와 클라이언트 머신 모두에 설치되어 있는지 확인하세요. 그렇다면 클라이언트 머신에서 플러그인을 제거하고 호스트 머신에만 유지하세요. 자세한 내용은 원격 개발에서 사용을 참조하세요.

Code Suggestions 지원은 Code Suggestions 문제 해결을 참조하세요.

네트워크 문제#

로그에서 /-/cable WebSocket 엔드포인트 대신 GitLab Duo에서 HTTP/1.1 응답이 표시되면 WebSocket 연결이 차단되어 있을 수 있습니다.

GitLab 인스턴스는 IDE 클라이언트로부터의 인바운드 WebSocket 연결을 허용해야 합니다. 이 문제가 의심되면 네트워크 관리자에게 GitLab 인스턴스에 대한 WebSocket 트래픽 허용을 요청하세요.

IDE 명령어가 실패하거나 무한히 실행됨#

IDE에서 GitLab Duo Agentic Chat 또는 Software Development Flow를 사용할 때 GitLab Duo가 루프에 빠지거나 명령어 실행에 어려움을 겪을 수 있습니다.

이 문제는 Oh My ZSH! 또는 powerlevel10k와 같은 셸 테마나 통합을 사용할 때 발생할 수 있습니다. GitLab Duo 에이전트가 터미널을 생성할 때 테마나 통합이 명령어가 제대로 실행되지 않도록 방해할 수 있습니다.

해결 방법으로 에이전트가 보내는 명령어에 더 간단한 테마를 사용하세요. VS Code 확장 프로젝트의 이슈 2070에서 이 해결 방법이 더 이상 필요하지 않도록 이 동작의 개선 사항을 추적하고 있습니다.

.zshrc 파일 편집#

VS Code 및 JetBrains IDE에서 에이전트가 보낸 명령어를 실행할 때 더 간단한 테마를 사용하도록 Oh My ZSH! 또는 powerlevel10k를 구성하세요. IDE에서 노출하는 환경 변수를 사용하여 이 값을 설정할 수 있습니다.

~/.zshrc 파일에 다음 코드를 포함하도록 편집하세요:

# ~/.zshrc

# Path to your oh-my-zsh installation
export ZSH="$HOME/.oh-my-zsh"

# ...

# Decide whether to load a full terminal environment,
# or keep it minimal for agentic AI in IDEs
if [[ "$TERM_PROGRAM" == "vscode" || "$TERMINAL_EMULATOR" == "JetBrains-JediTerm" ]]; then
  echo "IDE agentic environment detected, not loading full shell integrations"
else
  # Oh My ZSH
  source $ZSH/oh-my-zsh.sh
  # Theme: Powerlevel10k
  [[ ! -f ~/.p10k.zsh ]] || source ~/.p10k.zsh
  # Other integrations like syntax highlighting
fi

# Other setup, like PATH variables

디버그 모드 활성화#

JetBrains에서 디버그 로그를 활성화하려면:

• 상단 바에서 Help > Diagnostic Tools > Debug Log Settings로 이동하거나 Help > Find Action > Debug log settings로 이동하여 작업을 검색하세요.

• 다음 줄을 추가하세요: com.gitlab.plugin

• OK 또는 Save를 선택하세요.

문제를 재현한 후 로그를 수집하세요.

인증서 오류 또는 다른 연결 오류가 발생하고 HTTP 프록시를 통해 GitLab 인스턴스에 연결하는 경우, GitLab Language Server에 대해 Language Server가 프록시를 사용하도록 구성해야 합니다.

프록시 인증을 활성화할 수도 있습니다.

GitLab Language Server 디버그 로그 활성화#

GitLab Language Server 디버그 로그를 활성화하려면:

• IDE의 상단 바에서 IDE 이름을 선택한 다음 Settings를 선택하세요.

• 왼쪽 사이드바에서 Tools > GitLab Duo를 선택하세요.

• GitLab Language Server를 선택하여 섹션을 펼치세요.

• Logging > Log Level에서 debug를 입력하세요.

• Apply를 선택하세요.

• Enable GitLab Language Server 아래에서 Restart Language Server를 선택하세요.

디버그 로그 가져오기#

전제 조건:

• GitLab Duo 플러그인 3.27.0 이상.

디버그 로그와 진단을 함께 수집하려면:

• Tools > GitLab > Export Diagnostics Bundle로 이동하세요.

• GitLab: Export Diagnostics Bundle 빠른 작업을 실행하세요.

이렇게 하면 GitLab 플러그인 진단, 확장 프로그램 로그 및 GitLab Language Server 로그가 포함된 단일 zip 파일이 선택한 위치에 저장됩니다.

대신 원시 idea.log 로그 파일에 접근하려면 다음 중 하나를 수행하세요:

• IDE에서 Help > Show Log in Finder로 이동하세요.

• /Users/<user>/Library/Logs/JetBrains/IntelliJIdea<build_version> 디렉터리로 이동하여 <user>와 <build_version>을 적절한 값으로 바꾸세요.

인증서 오류#

프록시를 통해 GitLab 인스턴스에 연결하는 경우 JetBrains에서 SSL 인증서 오류가 발생할 수 있습니다. GitLab Duo는 시스템 저장소에서 인증서를 감지하려고 시도하지만 Language Server는 이를 수행할 수 없습니다. Language Server에서 인증서 관련 오류가 표시되면 Certificate Authority(CA) 인증서를 전달하는 옵션을 활성화해 보세요:

이를 수행하려면:

• IDE 오른쪽 하단에서 GitLab 아이콘을 선택하세요.

• 대화 상자에서 Show Settings를 선택하세요. 그러면 Settings 대화 상자가 Tools > GitLab Duo로 열립니다.

• GitLab Language Server를 선택하여 섹션을 펼치세요.

• HTTP Agent Options를 선택하여 펼치세요.

• 다음 중 하나를 선택하세요:

Pass CA certificate from Duo to the Language Server 옵션을 선택하세요.

• **Certificate authority (CA)**에서 CA 인증서가 있는 .pem 파일의 경로를 지정하세요.

• IDE를 재시작하세요.

인증서 오류 무시#

GitLab Duo가 여전히 연결에 실패하면 인증서 오류를 무시해야 할 수 있습니다. 디버그 모드를 활성화한 후 GitLab Language Server 로그에서 다음과 같은 오류가 표시될 수 있습니다:

2024-10-31T10:32:54:165 [error]: fetch: request to https://gitlab.com/api/v4/personal_access_tokens/self failed with:
request to https://gitlab.com/api/v4/personal_access_tokens/self failed, reason: unable to get local issuer certificate
FetchError: request to https://gitlab.com/api/v4/personal_access_tokens/self failed, reason: unable to get local issuer certificate

이 설정은 설계상 보안 위험을 나타냅니다. 이 오류는 잠재적인 보안 침해에 대한 경고입니다. 프록시가 문제의 원인임을 절대적으로 확신하는 경우에만 이 설정을 활성화해야 합니다.

사전 요구사항:

• 시스템 브라우저에서 인증서 체인을 확인했거나 머신 관리자가 이 오류를 무시해도 안전하다고 확인했습니다.

이를 수행하려면:

• SSL certificates에 대한 JetBrains 문서를 참조하세요.

• IDE 상단 메뉴 바로 이동하여 Settings를 선택하세요.

• 왼쪽 사이드바에서 Tools > GitLab Duo를 선택하세요.

• 기본 브라우저가 사용 중인 URL to GitLab instance를 신뢰하는지 확인하세요.

• Ignore certificate errors 옵션을 활성화하세요.

• Verify setup을 선택하세요.

• OK 또는 Save를 선택하세요.

PyCharm에서 인증 실패#

GitLab 인증의 Verify setup 단계에서 문제가 발생하면 지원되는 버전의 PyCharm을 사용하고 있는지 확인하세요:

• 플러그인 호환성 페이지로 이동하세요.

• Compatibility에서 PyCharm Community 또는 PyCharm Professional을 선택하세요.

• Channels에서 GitLab 플러그인의 원하는 안정성 수준을 선택하세요.

• 사용 중인 PyCharm 버전에서 Download를 선택하여 올바른 GitLab 플러그인 버전을 다운로드하고 설치하세요.

JCEF 오류#

JCEF(Java Chromium Embedded Framework)와 관련된 GitLab Duo Chat 문제가 발생하면 다음 단계를 시도해 보세요:

• 상단 바에서 Help > Find Action으로 이동하여 Registry를 검색하세요.

• ide.browser.jcef.sandbox.enable을 찾거나 검색하세요.

• 체크박스를 해제하여 이 설정을 비활성화하세요.

• Registry 대화 상자를 닫으세요.

• IDE를 재시작하세요.

• 상단 바에서 Help > Find Action으로 이동하여 Choose Boot Java Runtime for the IDE를 검색하세요.

• JCEF가 번들된 현재 IDE 버전과 동일한 부트 Java 런타임 버전을 선택하세요:

[

](/19.2/editor_extensions/jetbrains_ide/img/jcef_supporting_runtime_example_v17_3.png)

• IDE를 재시작하세요.

지원에 필요한 정보#

지원팀에 연락하기 전에 최신 GitLab Duo 플러그인이 설치되어 있는지 확인하세요. 모든 릴리스는 JetBrains Marketplace의 Versions 탭에서 확인할 수 있습니다.

영향받는 사용자로부터 다음 정보를 수집하여 버그 리포트에 제공하세요:

• 사용자에게 표시된 오류 메시지.

• 진단 및 로그. 다음 방법 중 하나를 선택하세요:

자동(권장): 진단 번들을 내보내면 로그와 진단이 단일 zip 파일로 패키징됩니다.

• 수동:

디버그 로그를 활성화하고 수집하세요.

• Language Server 디버그 로그를 활성화하고 수집하세요.

• 로그 출력을 캡처하세요.

• 빠른 작업 메뉴에서 GitLab: Diagnostics를 실행하고 Markdown 출력을 복사하세요.

• 영향 범위를 설명하세요. 영향받는 사용자 수는 얼마나 됩니까?

• 오류를 재현하는 방법을 설명하세요. 가능하면 화면 녹화를 포함하세요.

• 다른 GitLab Duo 기능이 어떻게 영향받는지 설명하세요:

GitLab Quick Chat이 정상적으로 작동합니까?

• Code Suggestions가 작동합니까?

• Web IDE의 GitLab Duo Chat이 응답을 반환합니까?

• 확장 격리 테스트를 수행하세요. 다른 모든 확장을 비활성화(또는 제거)하여 다른 확장이 문제를 일으키는지 확인해 보세요. 이는 문제가 당사 확장에 있는 것인지, 외부 소스에 있는 것인지 파악하는 데 도움이 됩니다.