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

JetBrains IDE用のGitLabプラグイン

GitLab Duoプラグインは、IntelliJ、PyCharm、GoLand、Webstorm、RubymineなどのJetBrains IDEとGitLab Duoを統合します。

拡張機能をインストールして設定するには、インストールとセットアップを参照してください。

実験的またはベータ機能を有効にする

プラグインの一部の機能は、実験的またはベータステータスです。これらを使用するには、オプトインする必要があります:

  1. IDEの上部のメニューバーに移動し、設定を選択します:
    • MacOS: ⌘+,を押します
    • WindowsまたはLinux: Control+Alt+Sを押します
  2. 左側のサイドバーで、ツールを展開し、GitLab Duoを選択します。
  3. Enable Experiment or BETA features（実験的またはベータ機能を有効にする）を選択します。
  4. 変更を適用するには、IDEを再起動します。

拡張機能を更新する

拡張機能を最新バージョンに更新するには、次の手順に従います:

  1. JetBrains IDEで、設定 > Plugins（プラグイン）に移動します。
  2. Marketplaceから、GitLab Duo（発行元: GitLab, Inc.）を選択します。
  3. 更新を選択して、最新のプラグインバージョンに更新します。

テレメトリを有効にする

GitLab Duoプラグインは、JetBrains IDEのテレメトリ設定を使用して、使用状況とエラー情報をGitLabに送信します。JetBrains IDEでテレメトリを有効にするには:

  1. IDEの上部のメニューバーに移動し、設定を選択します。たとえば、PyCharmで、PyCharm > 設定を選択します。
  2. 左側のサイドバーで、ツールをGitLab Duoを選択します。
  3. 高度な設定で、Enable telemetry（テレメトリを有効にする）チェックボックスをオンにします。
  4. OKまたは適用を選択して、変更を保存します。

1Password CLIとの統合

  • プラン: Premium、Ultimate
  • 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated

パーソナルアクセストークンをハードコードされたではなく、1Passwordシークレット参照を使用するようにプラグインを設定できます。

前提要件:

  • 1Passwordデスクトップアプリがインストールされている。
  • 1Password CLIツールがインストールされている。

JetBrains用GitLabを1Password CLIと統合する方法:

  1. GitLabに対して認証する次のいずれかの操作を行います:

  2. 1Passwordアイテムを開きます。

  3. シークレット参照をコピーします。

    gitlab 1Password Shellプラグインを使用している場合、トークンは"op://Private/GitLab Personal Access Token/token"のパスワードとして保存されます。

IDEから:

  1. IDEの上部のメニューバーに移動し、設定を選択します。
  2. 左側のサイドバーで、ツールを展開し、GitLab Duoを選択します。
  3. 認証で、1Password CLIタブを選択します。
  4. Integrate with 1Password CLI（1Password CLIと統合）を選択します。
  5. オプション。Secret reference（シークレット参照）で、1Passwordからコピーしたシークレット参照を貼り付けます。
  6. オプション。認証情報を確認するには、Verify setup（セットアップの確認）を選択します。
  7. OKまたは保存を選択します。

プラグインに関するイシューのレポート

gitlab-jetbrains-pluginイシュートラッカーで、イシュー、バグ、または機能リクエストを報告してください。BugまたはFeature Proposalテンプレートを使用します。

GitLab Duoの使用中にエラーが発生した場合は、IDEに組み込まれているエラーレポートツールでレポートすることもできます:

  1. ツールにアクセスするには、次のいずれかの操作を行います:
    • エラーが発生した場合、エラーメッセージでSee details and submit report（詳細を表示してレポートを送信）を選択します。
    • ステータスバーの右下にある感嘆符を選択します。
  2. IDE Internal Errors（IDE内部エラー）ダイアログで、エラーについて説明します。
  3. Report and clear all（すべてレポートしてクリア）を選択します。
  4. デバッグ情報が入力されたGitLabイシューフォームがブラウザーで開きます。
  5. イシューテンプレートのプロンプトに従って、説明を入力し、できるだけ多くのコンテキストを提供します。
  6. イシューの作成を選択して、バグレポートを提出します。