GitLab Duoのトラブルシューティング
GitLab Duoの使用中に、問題が発生することがあります。
ヘルスチェックの実行から開始して、お使いのインスタンスがGitLab Duoを使用するための要件を満たしているかどうかを判断してください。
GitLab Duoのトラブルシューティングの詳細については、以下を参照してください:
ヘルスチェックで問題が解決しない場合は、次のトラブルシューティングの手順を確認してください。
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.rbRailsランナーを使用してスクリプトを実行します:
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プロキシが構成されている場合は、
proxyパラメータをcurlコマンドに含めます。# 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チャットを使用すると、このエラーが発生する可能性があります。拡張機能が127.0.0.1アドレスに誤って接続しようとする場合もあります。
この問題は、リモート環境でレイテンシーが発生し、GitLab VS Code Extension 6.8.0以降にハードコードされた10秒のタイムアウトを超える場合に発生します。
この問題を解決するには、以下を実行します:
VS Codeで、コード > 設定 > 設定を選択します。
Open Settings (JSON)（設定を開く（JSON））を選択して、
settings.jsonファイルを編集します。または、F1キーを押して、**設定を開く（JSON）を入力します: 設定を開く（JSON）**を選択します。この設定を追加します:
"gitlab.featureFlags.languageServerWebviews": false保存してVS Codeをリロードします。
GitLab DedicatedでのGitLab Duoのトラブルシューティング
PremiumおよびUltimateプランのお客様の場合、GitLab 18.3以降では、GitLab Duo Coreがすぐに使用できるはずです。
プレ本番環境GitLab Dedicatedインスタンスは、設計上、GitLab Duo Coreをサポートしていません。
管理者エリアにGitLab Duoの設定が表示されない
次の問題が1つ以上発生する可能性があります:
- GitLab Duoセクションが管理者エリアに表示されません。
- 設定オプションが見つかりません。
- APIコールが
"addOnPurchases": []を返します。
これらの問題は、ライセンスがインスタンスと適切に同期されていない場合に発生します。
この問題を解決するには、サブスクリプションの同期を確認するためのサポートチケットを作成してください。サポートは、同期ステータスを確認し、必要に応じて新しいライセンスの生成をリクエストできます。
エラー: GitLab-workflow failed: the GitLab Language server failed to start in 10 seconds
Web IDEでGitLab Duoチャットを使用すると、このエラーが発生する可能性があります。Platform is missing!に関するコンソールエラーも表示される場合があります
この問題は、cloud.gitlab.comおよびcustomers.gitlab.comへのネットワーキング接続がネットワーク設定によってブロックされている場合に発生します。
この問題を解決するには、以下を実行します:
cloud.gitlab.com:443およびcustomers.gitlab.com:443への送信接続を確認します。- 必要に応じて、許可リストにCloudflare IP範囲を追加します。
- プライベートリンクで、許可リストまたはファイアウォールの制限を確認してください。
- 送信リクエストのフィルタリングに従って、接続の問題をトラブルシュートします。
- インスタンスからの接続をテストします。
エラー: Unable to resolve resource
Web IDEの読み込むに失敗すると、このエラーが発生する可能性があります。CORSエラーのブラウザーログを確認してください：failed to load because it violates the following Content Security policy。
この問題は、CORSポリシーがリクエストされたリソースをブロックすると発生します。
この問題を解決するには、以下を実行します:
- GitLab Workflow Extensionバージョン6.35.1以降にアップデートします。
- CORSポリシーに
https://*.cdn.web-ide.gitlab-static.netを追加します。 - トラブルシューティングをさらに行うには、HARファイルのログを確認してください。詳細については、HARファイルを作成するを参照してください。
詳細については、CORSの問題を参照してください。
ユーザーが利用できないGitLab Duo機能
GitLab Duo機能をオンにすることに加えて、次のこともできます:
- GitLab Duo Coreをお持ちの場合は、以下があることを確認してください:
- PremiumまたはUltimateサブスクリプション。
- IDE機能をオンにしました。
- GitLab Duo ProまたはEnterpriseをお持ちの場合:
- サブスクリプションアドオンが購入されていることを確認します。
- シートがユーザーに割り当てられていることを確認します。
- IDEの場合:
- 拡張機能またはプラグインが最新であることを確認します。
- ヘルスチェックを実行し、認証をテストします。