GitLab Duo 문제 해결

요약

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+,를 누릅니다.
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 기능 켜기 외에도 다음을 수행할 수 있습니다:

GitLab Duo Core를 보유한 경우 다음을 확인합니다:
- Premium 또는 Ultimate 구독이 있어야 합니다.
- IDE 기능이 켜져 있어야 합니다.
[!note] GitLab Duo Non-Agentic Chat은 GitLab Duo Core 사용자에게 제공되지 않습니다.
GitLab Duo Pro 또는 Enterprise를 보유한 경우:
- 구독 애드온이 구매되었는지 확인합니다.
- 사용자에게 시트가 할당되었는지 확인합니다.
IDE의 경우:
- 확장 또는 플러그인이 최신 상태인지 확인합니다.
- 상태 확인을 실행하고 인증을 테스트합니다.

GitLab Duo 문제 해결

원문 보기

번역일: 2026-05-22

요약

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+,를 누릅니다.
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`#

이 문제는 CORS 정책이 필요한 리소스를 차단할 때 발생합니다.

이 문제를 해결하려면:

GitLab for VS Code 버전 6.35.1 이상으로 업데이트합니다.
CORS 정책에 https://*.cdn.web-ide.gitlab-static.net을 추가합니다.
추가로 문제를 해결하려면 로그에서 HAR 파일을 확인합니다. 자세한 내용은 HAR 파일 만들기를 참조하세요.

자세한 내용은 CORS 문제를 참조하세요.

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

GitLab Duo 기능 켜기 외에도 다음을 수행할 수 있습니다:

GitLab Duo Core를 보유한 경우 다음을 확인합니다:
- Premium 또는 Ultimate 구독이 있어야 합니다.
- IDE 기능이 켜져 있어야 합니다.
[!note] GitLab Duo Non-Agentic Chat은 GitLab Duo Core 사용자에게 제공되지 않습니다.
GitLab Duo Pro 또는 Enterprise를 보유한 경우:
- 구독 애드온이 구매되었는지 확인합니다.
- 사용자에게 시트가 할당되었는지 확인합니다.
IDE의 경우:
- 확장 또는 플러그인이 최신 상태인지 확인합니다.
- 상태 확인을 실행하고 인증을 테스트합니다.

GitLab Duo 문제 해결

Self-managed에서 GitLab Duo 기능이 작동하지 않음#

오류: Webview didn't initialize in 10000ms#

GitLab Dedicated에서 GitLab Duo 문제 해결#

관리자 영역에 GitLab Duo 설정이 표시되지 않음#

오류: GitLab-workflow failed: the GitLab Language server failed to start in 10 seconds#

오류: Unable to resolve resource#

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

Self-managed에서 GitLab Duo 기능이 작동하지 않음#

오류: Webview didn't initialize in 10000ms#

GitLab Dedicated에서 GitLab Duo 문제 해결#

관리자 영역에 GitLab Duo 설정이 표시되지 않음#

오류: GitLab-workflow failed: the GitLab Language server failed to start in 10 seconds#

오류: Unable to resolve resource#

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

오류: `Webview didn't initialize in 10000ms`#

오류: `GitLab-workflow failed: the GitLab Language server failed to start in 10 seconds`#

오류: `Unable to resolve resource`#

오류: `Webview didn't initialize in 10000ms`#

오류: `GitLab-workflow failed: the GitLab Language server failed to start in 10 seconds`#

오류: `Unable to resolve resource`#