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

GitLab Duo CLIをセットアップする

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

GitLab Duo CLIは、GitLab CLI（glab）を通じて使用できます。GitLab CLIを使用すると、他のGitLab機能にアクセスでき、OAuthまたはパーソナルアクセストークンを使用して一度認証するだけで済みます。

または、GitLab Duo CLI（duo）をスタンドアロンのAIツールとしてインストールして使用し、パーソナルアクセストークンを使用して個別に認証することもできます。

どちらのセットアップも、すべてのGitLab Duo CLIオプション、コマンド、機能とともに、対話モードとヘッドレスモードをサポートしています。

前提条件

GitLab 18.11から19.1を使用している場合、ベータ版および実験的機能を有効にすることで、GitLab Duo CLIの最新バージョンを使用できます。

GitLab CLIを使用する場合

前提条件:

GitLab CLIを通じてGitLab Duo CLIを使用できるようにセットアップするには:

  1. GitLab Duo CLI用のglabコマンドを実行します:

    shell
    glab duo cli

  2. プロンプトに従って、GitLab Duo CLIバイナリをインストールします。

GitLab CLIが認証を自動的に処理するため、GitLab Duo CLIの使用をすぐに開始できます。

GitLab CLIを使用しない場合

GitLab Duo CLIをスタンドアロンツールとして使用するには、インストールしてから認証します。

インストールする

GitLab Duo CLIをコンパイル済みバイナリとしてインストールするには、インストールスクリプトをダウンロードして実行します。

macOSおよびLinuxの場合:

shell
bash <(curl --fail --silent --show-error --location "https://gitlab.com/gitlab-org/editor-extensions/gitlab-lsp/-/raw/main/packages/cli/scripts/install_duo_cli.sh")

Windowsの場合:

shell
irm "https://gitlab.com/gitlab-org/editor-extensions/gitlab-lsp/-/raw/main/packages/cli/scripts/install_duo_cli.ps1" | iex

認証する

初めてduoを実行したときに、glabがシステムにすでにインストールされ、認証されている場合、duoは自動的にglabを認証情報ヘルパーとして使用します。個別に認証する必要はありません。この機能を使用するには、glab 1.85.2以降およびduo 8.68.0以降が必要です。

この機能が利用可能になる前にduoを認証しており、今後は代わりにglabを認証情報ヘルパーとして使用する場合は、~/.gitlab/storage.jsonから認証設定を削除します。

前提条件:

認証するには:

  1. ターミナルでduoを実行します。GitLab Duo CLIを初めて実行すると、設定画面が表示されます。
  2. GitLabインスタンスのURLを入力し、Enterを押します:
    • GitLab.comの場合は、https://gitlab.comを入力します。
    • GitLab Self-ManagedまたはGitLab Dedicatedの場合は、インスタンスURLを入力します。
  3. GitLabトークンに、パーソナルアクセストークンを入力します。
  4. 設定を保存してCLIを終了するには、Enterを押します。
  5. CLIを再起動するには、ターミナルでduoを実行します。

初期設定後に設定を変更するには、duo config editを使用します。

環境変数を使用して認証する

前提条件:

GitLab Duo CLIは、標準のプロキシ環境変数に対応しています:

  • HTTP_PROXYまたはhttp_proxy: HTTPリクエスト用のプロキシURL。
  • HTTPS_PROXYまたはhttps_proxy: HTTPSリクエスト用のプロキシURL。
  • NO_PROXYまたはno_proxy: プロキシ経由から除外するホストのカンマ区切りリスト。

環境変数を使用して認証するには:

  1. GITLAB_TOKENまたはGITLAB_OAUTH_TOKENにパーソナルアクセストークンを設定します。

    shell
    export GITLAB_TOKEN="<your-personal-access-token>"

  2. オプション。GITLAB_BASE_URLまたはGITLAB_URLにカスタムGitLabインスタンスのURL（https://gitlab.example.comなど）を設定します。デフォルトはhttps://gitlab.comです。

    shell
    export GITLAB_BASE_URL="<your-instance-url>"

この方法は、インタラクティブな認証を使用できないヘッドレスモード、CI/CDパイプライン、スクリプト化されたワークフローに役立ちます。