正式なドキュメントは英語版であり、この日本語訳はAI支援翻訳により作成された参考用のものです。日本語訳の一部の内容は人間によるレビューがまだ行われていないため、翻訳のタイミングにより英語版との間に差異が生じることがあります。最新かつ正確な情報については、英語版をご参照ください。

GitLab Duoのトラブルシューティング

GitLab Duoの使用中に、問題が発生することがあります。

ヘルスチェックの実行から開始して、お使いのインスタンスがGitLab Duoを使用するための要件を満たしているかどうかを判断してください。

GitLab Duoのトラブルシューティングの詳細については、以下を参照してください:

ヘルスチェックで問題が解決しない場合は、次のトラブルシューティングの手順を確認してください。

GitLab Duoの機能がセルフマネージド環境で動作しない

GitLab Duoの機能がオンになっていることを確認するだけでなく、次のこともできます:

  1. 管理者として、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スクリプトをダウンロードして実行し、問題の特定とトラブルシューティングに役立つ詳細なレポートを生成できます。

    1. ヘルスチェックスクリプトをダウンロードします:

      wget https://gitlab.com/gitlab-org/gitlab/-/snippets/3734617/raw/main/health_check.rb

    2. Railsランナーを使用してスクリプトを実行します:

      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)

  2. 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"

  3. オプション。GitLabアプリケーションとパブリックインターネットの間にプロキシサーバーを使用している場合は、DNSリバインディング保護を無効にします。

  4. サブスクリプションデータを手動で同期します。

エラー: Webview didn't initialize in 10000ms

VS Code Remote SSHまたはWSLセッションでGitLab Duo Chatを使用すると、このエラーが発生する可能性があります。拡張機能が127.0.0.1アドレスに誤って接続しようとする場合もあります。

この問題は、GitLab VS Code拡張機能バージョン6.8.0以降で、ハードコードされた10秒のタイムアウトを超えるレイテンシーがリモート環境で生じた場合に発生します。

この問題を解決するには:

  1. VS Codeで、Code > Preferences > Settingsを選択します。

  2. **Open Settings (JSON)**を選択して、settings.jsonファイルを編集します。または、F1キーを押して、**Preferences:Open Settings (JSON)**と入力し、それを選択します。

  3. この設定を追加します:

    "gitlab.featureFlags.languageServerWebviews": false

  4. 保存して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 Chatを使用すると、このエラーが発生する可能性があります。Platform is missing!に関するコンソールエラーも表示される場合があります

この問題は、cloud.gitlab.comおよびcustomers.gitlab.comへのネットワーキング接続がネットワーク設定によってブロックされている場合に発生します。

この問題を解決するには:

  1. cloud.gitlab.com:443およびcustomers.gitlab.com:443への送信接続を確認します。
  2. 必要に応じて、許可リストにCloudflare IP範囲を追加します。
  3. プライベートリンクで、許可リストまたはファイアウォールの制限を確認します。
  4. 送信リクエストのフィルタリングに従って、接続の問題のトラブルシューティングを行います。
  5. インスタンスからの接続をテストします。

エラー: Unable to resolve resource

Web IDEの読み込みに失敗すると、このエラーが発生する可能性があります。CORSエラーfailed to load because it violates the following Content Security policyのブラウザログを確認してください。

この問題は、CORSポリシーがリクエストされたリソースをブロックすると発生します。

この問題を解決するには:

  1. GitLab for VS Codeバージョン6.35.1以降に更新してください。
  2. CORSポリシーにhttps://*.cdn.web-ide.gitlab-static.netを追加します。
  3. トラブルシューティングをさらに行うには、HARファイルのログを確認してください。詳細については、HARファイルを作成するを参照してください。

詳細については、CORSの問題を参照してください。

GitLab Duoの機能をユーザーが利用できない

GitLab Duoの機能をオンにすることに加えて、次も実行できます: