GitLab Duo 문제 해결
GitLab v19.5요약
GitLab Duo를 사용할 때 문제가 발생할 수 있습니다. 먼저 상태 확인을 실행하여 인스턴스가 GitLab Duo를 사용하기 위한 요구 사항을 충족하는지 확인합니다. GitLab Duo 문제 해결에 대한 자세한 내용은 다음을 참고합니다.
GitLab Duo를 사용할 때 문제가 발생할 수 있습니다.
먼저 상태 확인을 실행하여 인스턴스가 GitLab Duo를 사용하기 위한 요구 사항을 충족하는지 확인합니다.
GitLab Duo 문제 해결에 대한 자세한 내용은 다음을 참고합니다.
상태 확인으로 문제가 해결되지 않으면 다음 문제 해결 단계를 검토합니다.
Self-managed에서 GitLab Duo 기능이 작동하지 않음#
GitLab Duo 기능이 켜져 있는지 확인하는 것 외에도 다음을 수행할 수 있습니다.
-
관리자로서 GitLab Duo 상태 확인을 실행합니다.
GitLab 17.5 이상에서는 UI로 상태 확인을 실행하고 문제를 식별하고 해결하는 데 도움이 되는 상세 보고서를 내려받을 수 있습니다.
GitLab 17.4에서는 상태 확인 Rake 작업을 실행하여 문제를 식별하고 해결하는 데 도움이 되는 상세 보고서를 생성할 수 있습니다.
sudo gitlab-rails 'cloud_connector:health_check(root,report.json)'GitLab 17.3 이하에서는
health_check스크립트를 내려받아 실행하여 문제를 식별하고 해결하는 데 도움이 되는 상세 보고서를 생성할 수 있습니다.-
상태 확인 스크립트를 내려받습니다.
wget https://gitlab.com/gitlab-org/gitlab/-/snippets/3734617/raw/main/health_check.rb -
Rails Runner로 스크립트를 실행합니다.
gitlab-rails runner [full_path/to/health_check.rb] --debug --username [username] --output-file [report.txt]Usage: gitlab-rails runner full_path/to/health_check.rb --debug Enable debug mode --output-file FILE Write a report to FILE --username USERNAME Provide a username to test seat assignments --skip [CHECK] Skip specific check (options: access_data, token, license, host, features, end_to_end)
-
GitLab 인스턴스가 필요한 GitLab.com 엔드포인트에 도달할 수 있는지 확인합니다. 연결 상태는
curl같은 명령줄 도구로 확인할 수 있습니다.curl --verbose "https://cloud.gitlab.com" curl --verbose "https://customers.gitlab.com"GitLab 인스턴스에 HTTP/S 프록시가 구성되어 있으면
curl명령에proxy파라미터를 포함합니다.# https proxy for curl curl --verbose --proxy "http://USERNAME:PASSWORD@example.com:8080" "https://cloud.gitlab.com" curl --verbose --proxy "http://USERNAME:PASSWORD@example.com:8080" "https://customers.gitlab.com" -
선택 사항. GitLab 애플리케이션과 공용 인터넷 사이에 프록시 서버를 사용하는 경우 DNS 리바인딩 보호를 비활성화합니다.
-
- GitLab 인스턴스가 구독 데이터를 GitLab과 동기화하는지 확인합니다.
오류:
Webview didn't initialize in 10000ms#VS Code Remote SSH 또는 WSL 세션에서 GitLab Duo Chat을 사용할 때 이 오류가 발생할 수 있습니다. 확장이
127.0.0.1주소에 잘못 연결을 시도할 수도 있습니다.이 문제는 원격 환경에서 발생하는 대기 시간이 GitLab VS Code Extension 6.8.0 이상에 하드코딩된 10초 시간 초과를 넘길 때 발생합니다.
이 문제를 해결하려면 다음과 같이 진행합니다.
-
VS Code에서 설정 편집기를 엽니다.
- macOS에서는 Command+,를 누릅니다.
- Windows 또는 Linux에서는 Control+,를 누릅니다.
-
**Open Settings (JSON)**을 선택하여
settings.json파일을 편집합니다. 또는 F1을 누르고 **Preferences: Open Settings (JSON)**을 입력한 후 선택합니다. -
다음 설정을 추가합니다.
"gitlab.featureFlags.languageServerWebviews": false -
VS Code를 저장하고 다시 로드합니다.
GitLab Dedicated에서 GitLab Duo 문제 해결#
GitLab Duo Core는 Premium 및 Ultimate 고객의 GitLab 18.3 이상에서 GitLab Duo Non-Agentic Chat을 제외한 모든 GitLab Duo 기능에 대해 별도 설정 없이 작동해야 합니다.
사전 프로덕션 GitLab Dedicated 인스턴스는 설계상 GitLab Duo Core를 지원하지 않습니다.
관리자 영역에 GitLab Duo 설정이 표시되지 않음#
다음 문제 중 하나 이상이 발생할 수 있습니다.
- GitLab Duo 섹션이 관리자 영역에 표시되지 않습니다.
- 구성 옵션이 누락되어 있습니다.
- API 호출이
"addOnPurchases": []를 반환합니다.
이 문제는 라이선스가 인스턴스와 제대로 동기화되지 않았을 때 발생합니다.
이 문제를 해결하려면 지원 티켓을 생성하여 라이선스 동기화를 확인합니다. 지원 조직은 동기화 상태를 확인하고 필요한 경우 새 라이선스 생성을 요청할 수 있습니다.
오류:
GitLab-workflow failed: the GitLab Language server failed to start in 10 seconds#Web IDE에서 GitLab Duo Chat을 사용할 때 이 오류가 발생할 수 있습니다.
Platform is missing!관련 콘솔 오류가 함께 표시될 수도 있습니다.이 문제는 네트워크 구성으로 인해
cloud.gitlab.com및customers.gitlab.com에 대한 네트워크 연결이 차단될 때 발생합니다.이 문제를 해결하려면 다음과 같이 진행합니다.
cloud.gitlab.com:443및customers.gitlab.com:443에 대한 아웃바운드 연결을 확인합니다.- 필요한 경우 허용 목록에 Cloudflare IP 범위를 추가합니다.
- private link의 허용 목록 또는 방화벽 제한을 확인합니다.
- 아웃바운드 요청 필터링에 따라 연결 문제를 해결합니다.
- 인스턴스에서 연결을 테스트합니다.
오류:
Unable to resolve resource#Web IDE 로드가 실패할 때 이 오류가 발생할 수 있습니다. 브라우저 로그에서 CORS 오류를 확인합니다.
failed to load because it violates the following Content Security policy.이 문제는 CORS 정책이 필요한 리소스를 차단할 때 발생합니다.
이 문제를 해결하려면 다음과 같이 진행합니다.
- GitLab for VS Code 버전 6.35.1 이상으로 업데이트합니다.
- CORS 정책에
https://*.cdn.web-ide.gitlab-static.net을 추가합니다. - 추가로 문제를 해결하려면 로그에서 HAR 파일을 확인합니다. 자세한 내용은 HAR 파일 만들기를 참고합니다.
자세한 내용은 CORS 문제를 참고합니다.
사용자에게 GitLab Duo 기능을 사용할 수 없음#
GitLab Duo 기능 켜기 외에도 다음을 수행할 수 있습니다.
-