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

このページのトラブルシューティングの手順で問題が解決しない場合は、JetBrainsプラグインプロジェクトの未解決のイシュー一覧を確認してください。イシューが問題と一致する場合は、そのイシューを更新してください。問題と一致するイシューがない場合は、新しいイシューを作成し、サポートに必要な情報を提供してください。

GitLab Duoコード提案に関するJetBrains IDEのトラブルシューティングについては、コード提案のトラブルシューティングを参照してください。

デバッグモードを有効にする

JetBrainsでデバッグログを有効にするには:

上部のバーで、ヘルプ > Diagnostic Tools > Debug Log Settingsに移動するか、ヘルプ > Find Action > Debug log settingsに移動してアクションを検索します。
次の行を追加します: com.gitlab.plugin
OKまたは保存を選択します。

証明書エラーまたはその他の接続エラーが発生し、HTTPプロキシを使用してGitLabインスタンスに接続する場合は、GitLab言語サーバーのために、プロキシを使用するように言語サーバーを構成する必要があります。

プロキシ認証を有効にすることもできます。

GitLab言語サーバーのデバッグログを有効にする

GitLab言語サーバーのデバッグログを有効にするには:

IDEの上部バーで、IDE名を選択し、設定を選択します。
左側のサイドバーで、ツール > GitLab Duoを選択します。
GitLab Language Serverを選択して、セクションを展開します。
Logging > Log Levelで、debugと入力します。
適用を選択します。
Enable GitLab Language Serverの下にあるRestart Language Serverを選択します。

デバッグログを取得する

デバッグログはidea.logログファイルで確認できます。このファイルを表示するには、次のいずれかの操作を行います:

IDEで、ヘルプ > Show Log in Finderに移動します。
/Users/<user>/Library/Logs/JetBrains/IntelliJIdea<build_version>ディレクトリに移動し、<user>と<build_version>を適切な値に置き換えます。

証明書エラー

マシンがプロキシ経由でGitLabインスタンスに接続する場合、JetBrainsでSSL証明書エラーが発生する可能性があります。GitLab Duoは、システムストア内の証明書を検出を試みますが、言語サーバーはこれを実行できません。言語サーバーからの証明書に関するエラーが表示される場合は、認証局（CA）証明書を渡すオプションを有効にしてみてください:

これを行うには、次の手順を実行します:

IDEの右下隅にあるGitLabアイコンを選択します。
ダイアログで、Show Settingsを選択します。これにより、設定ダイアログがツール > 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言語サーバーのログにエラーが表示される場合があります:

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証明書に関するJetBrainsのドキュメントを参照してください。
IDEの上部のメニューバーに移動し、設定を選択します。
左側のサイドバーで、ツール > GitLab Duoを選択します。
デフォルトのブラウザが、使用しているURL to GitLab instanceを信頼していることを確認します。
Ignore certificate errorsオプションを有効にします。
Verify setupを選択します。
OKまたは保存を選択します。

PyCharmで認証が失敗する

GitLab認証のVerify setupフェーズで問題が発生した場合は、サポートされているバージョンのPyCharmを実行していることを確認してください:

プラグインの互換性ページに移動します。
Compatibilityについては、PyCharm CommunityまたはPyCharm Professionalを選択してください。
Channelsの場合は、GitLabプラグインに必要な安定レベルを選択します。
使用しているPyCharmのバージョンに対して、ダウンロードを選択して正しいGitLabプラグインのバージョンをダウンロードし、インストールします。

JCEFエラー

JCEF（Java Chromium Embedded Framework）に関連するGitLab Duoチャットで問題が発生した場合は、次の手順を試してください:

上部のバーで、ヘルプ > Find Actionに移動し、Registryを検索します。
ide.browser.jcef.sandbox.enableを検索します。
チェックボックスをオフにして、この設定を無効にします。
レジストリダイアログを閉じます。
IDEを再起動します。
上部のバーで、ヘルプ > Find Actionに移動し、Choose Boot Java Runtime for the IDEを検索します。
現在のIDEのバージョンと同じで、JCEFがバンドルされているブートJavaランタイムバージョンを選択します:
IDEを再起動します。

サポートに必要な情報

サポートに問い合わせる前に、最新のGitLabワークフロー拡張機能がインストールされていることを確認してください。すべてのリリースは、JetBrains Marketplaceのバージョンタブで入手できます。

影響を受けるユーザーからこの情報を収集し、バグレポートで提供してください:

ユーザーに表示されるエラーメッセージ。
ワークフローと言語サーバーのログ:
診断出力。IntelliJ製品で、ヘルプ > Diagnostics Tools > Collect Troubleshooting Informationに移動します。
- GitLabについてセクションで、Build Versionをコピーします。
- プラグイン固有のバージョンの場合: Pluginsセクションで、出力をコピーします。
システムの詳細。IntelliJ製品で、ヘルプ > Diagnostics Tools > Collect Troubleshooting Informationに移動します。
- オペレーティングシステムの種類とバージョンの場合: ダイアログでオペレーティングシステムをコピーします。
- マシンの仕様については、Systemセクションをコピーします。
影響のスコープについて説明します。影響を受けるユーザーは何人ですか?
エラーを再現する方法を説明します。可能であれば、画面録画を含めてください。
他のGitLab Duo機能がどのように影響を受けるかを説明します:
- GitLab Quickチャットは機能していますか?
- コード提案は機能していますか?
- Web IDE Duoチャットは応答を返しますか?
拡張機能の分離テストを実行します。他の拡張機能をすべて無効にするかアンインストールして、別の拡張機能が問題の原因になっているかどうかを確認してください。これにより、問題が拡張機能にあるのか、外部ソースにあるのかを判断できます。