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

プラン: Premium、Ultimate
提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated
ステータス: ベータ

このページには、今後の製品や機能に関する情報が記載されています。重要な点として、ここに示されているのは情報提供のみを目的とした情報であることにご注意ください。この情報だけに基づいて購入や計画の決定をなさらないようにしてください。製品や機能の開発、リリース、タイミングは、GitLab Inc.独自の裁量により変更が加えられたり遅延したりすることがあります。

このページのステップで問題が解決しない場合は、Eclipseプラグインのプロジェクトで未解決のイシューの一覧を確認してください。イシューが問題と一致する場合は、そのイシューを更新してください。お使いの問題に一致するイシューがない場合は、イシューを新規作成して、サポートに必要な情報を記入してください。

エラーログを確認する

お使いのIDEのメニューバーで、Window（ウインドウ）を選択します。
Show View（ビューの表示）を展開し、Error Log（エラーログ）を選択します。
gitlab-eclipse-pluginプラグインを参照しているエラーを検索します。

ワークスペースログファイルの場所を特定する

ワークスペースログファイル（.logという名前）は、<your-eclipse-workspace>/.metadataディレクトリにあります。

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

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

IDEで、Eclipse > 設定を選択します。
左側のサイドバーで、GitLabを選択します。
Language Server Log Level（言語サーバーのログレベル）に、debugと入力します。
Apply and Close（適用して閉じる）を選択します。

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

/Users/<user>/eclipse/<eclipse-version>/Eclipse.app/Contents/MacOS/.gitlab_pluginディレクトリに移動し、<user>と<eclipse-version>を適切な値に置き換えます。
エラーログを開きます。Language server logs saved to: <file>.ログを探します。<file>は、language_server.logファイルへの絶対パスです。

サポートに必要な情報

サポートリクエストを作成する際は、次の情報を提供してください:

現在のEclipse用プラグインのGitLabのバージョン。
1. About Eclipse IDEダイアログを開きます。
  - Windowsの場合は、IDEで、ヘルプ > About Eclipse IDE（Eclipse IDEについて）を選択します。
  - MacOSの場合は、IDEで、Eclipse > About Eclipse IDE（Eclipse IDEについて）を選択します。
2. ダイアログで、Installation details（インストール詳細）を選択します。
3. GitLab for Eclipse（Eclipse用GitLab）を見つけて、バージョンの値をコピーします。
お使いのEclipseのバージョン。
1. About Eclipse IDEダイアログを開きます。
  - Windowsの場合は、IDEで、ヘルプ > About Eclipse IDE（Eclipse IDEについて）を選択します。
  - MacOSの場合は、IDEで、Eclipse > About Eclipse IDE（Eclipse IDEについて）を選択します。
使用しているオペレーティングシステム。
GitLab.com、GitLab Self-Managed、またはGitLab Dedicatedのいずれかのインスタンスを使用していますか？
プロキシを使用していますか？
自己署名証明書を使用していますか？
ワークスペースログ。
言語サーバーのデバッグログ。
該当する場合は、問題のビデオまたはスクリーンショット。
該当する場合は、問題を再現する手順。
該当する場合は、問題を解決するために試みた手順。

証明書エラー

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

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

IDEの右下隅にあるGitLabアイコンを選択します。
ダイアログで、Show Settings（設定を表示）を選択します。これにより、設定ダイアログがツール > GitLab Duoに開きます。
GitLab Language Server（GitLab言語サーバー）を選択して、セクションを展開します。
HTTP Agent Options（HTTPエージェントオプション）を選択して展開します。
次のいずれかの操作を行います:
- オプションPass CA certificate from Duo to the Language Server（Duoから言語サーバーにCA証明書を渡す）を選択します。
- **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証明書に関するEclipseのドキュメントを参照してください。
IDEの上部のメニューバーに移動し、設定を選択します。
左側のサイドバーで、ツール > GitLab Duoを選択します。
デフォルトのブラウザが、使用しているURL to GitLab instance（GitLabインスタンスへのURL）を信頼していることを確認します。
Ignore certificate errors（証明書エラーを無視する）オプションを有効にします。
Verify setup（セットアップの確認）を選択します。
OKまたは保存を選択します。