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

GitLab Duoアドオン

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

GitLab Duoアドオンは、PremiumまたはUltimateのサブスクリプションをAIネイティブな機能で拡張します。GitLab Duoを使用すると、開発ワークフローを加速し、反復的なコードタスクを削減し、プロジェクト全体のより深いインサイトを得ることができます。

3つのアドオンが利用可能です: GitLab Duo Core、Pro、およびEnterprise。

各アドオンは、GitLab Duo機能のセットへのアクセスを提供します。

GitLab Duo Core

以下をお持ちの場合、GitLab Duo Coreが自動的に含まれます:

  • GitLab 18.0以降。
  • PremiumまたはUltimateサブスクリプション。

GitLab 17.11以前から利用している場合は、WebまたはIDEの機能をオンにすると、GitLab Duo Coreの使用を開始する必要があります。

GitLab 18.0以降の新規ユーザーの場合、GitLab Duo Coreの機能は自動的にオンになり、それ以上のアクションは必要ありません。

GitLab Duo Coreにどのロールがアクセスできるかを確認するには、GitLab Duoグループの権限を参照してください。

GitLab Duo Self-Hosted

オフラインライセンスをお持ちのお客様の場合、GitLab Duo CoreはGitLab Duoセルフホストでは利用できません。GitLab Duo CoreがGitLab AIゲートウェイへの接続を必要とするためです。

オンラインライセンスをお持ちのお客様は、GitLab Duo CoreをGitLab Duoセルフホストと組み合わせて使用できますが、GitLab Duo Coreを有効にするには、インスタンス全体のGitLab Duoチャットおよびコード提案にGitLab AIベンダーモデルを選択する必要があります。

GitLab Duo Coreの制限

GitLab利用規約とともに、利用制限は、PremiumおよびUltimateプランのお客様による、含まれているコード提案およびGitLab Duoチャット機能の使用に適用されます。

GitLabは、これらの制限の施行が開始される30日前までに事前通知を提供します。その時点で、組織の管理者は、消費を監視および管理するためのツールを持ち、追加の容量を購入できるようになります。

機能1ユーザーあたりの月間リクエスト数
コード提案2,000
GitLab Duo Chat100

制限は、GitLab Duo ProまたはGitLab Duo Enterpriseには適用されません。

GitLab Duo ProとGitLab Duo Enterprise

GitLab Duo ProおよびGitLab Duo Enterpriseでは、シートを購入してチームメンバーに割り当てる必要があります。シートベースのモデルにより、特定のチームのニーズに基づいて、機能へのアクセスとコスト管理を制御できます。

Purchase GitLab Duo

GitLab Duo Enterpriseを購入するには、GitLabセールスチームにお問い合わせください。

GitLab Duo Proのシートを購入するには、カスタマーポータルを使用するか、GitLabセールスチームにお問い合わせください。

ポータルを使用するには、次の手順に従います:

  1. GitLabカスタマーポータルにサインインします。
  2. サブスクリプションカードで、縦方向の省略記号（ ellipsis_v ）を選択します。
  3. Buy GitLab Duo Pro（GitLab Duo Proを購入する） を選択します。
  4. GitLab Duoのシート数を入力します。
  5. Purchase summary（購入の概要）セクションを確認します。
  6. Payment methodドロップダウンリストから、お支払い方法を選択します。
  7. ライセンスを購入するを選択します。

GitLab Duoのシートを追加購入する

グループネームスペースまたはSelf-Managedインスタンス用に、GitLab Duo ProまたはGitLab Duo Enterpriseのシートを追加購入できます。購入が完了すると、シートはサブスクリプション内のGitLab Duoのシートの合計数に追加されます。

前提要件:

  • GitLab Duo ProまたはGitLab Duo Enterpriseアドオンを購入する必要があります。

GitLab.comの場合

前提要件:

  • オーナーロールを持っている必要があります。
  1. 左側のサイドバーで、検索または移動先を選択して、グループを見つけます。
  2. 設定 > GitLab Duoを選択します。
  3. シートの利用で、シートをアサインを選択します。
  4. ライセンスを購入するを選択します。
  5. カスタマーポータルのシートの追加フィールドに、シートの数を入力します。金額は、グループネームスペースに関連付けられているサブスクリプション内のシート数を超えることはできません。
  6. Billing information（料金情報）セクションで、ドロップダウンリストから支払い方法を選択します。
  7. Privacy Policy（プライバシーポリシー）とTerms of Service（利用規約）のチェックボックスを選択します。
  8. ライセンスを購入するを選択します。
  9. GitLab SaaSタブを選択し、ページを更新します。

GitLab Self-ManagedおよびGitLab Dedicatedの場合

前提要件:

  • 管理者である必要があります。
  1. GitLabカスタマーポータルにサインインします。
  2. サブスクリプションカードのGitLab Duo Proセクションで、シートを追加を選択します。
  3. シートの数を入力します。金額は、サブスクリプション内のシート数を超えることはできません。
  4. Purchase summary（購入の概要）セクションを確認します。
  5. Payment methodドロップダウンリストから、お支払い方法を選択します。
  6. ライセンスを購入するを選択します。

Assign GitLab Duo seats

前提要件:

  • GitLab Duo ProまたはGitLab Duo Enterpriseアドオンを購入するか、アクティブなGitLab Duoトライアルが必要です。
  • GitLab Self-ManagedおよびGitLab Dedicatedの場合:
    • GitLab Duo Proアドオンは、GitLab 16.8以降で利用可能です。
    • GitLab Duo Enterpriseアドオンは、GitLab 17.3以降でのみ利用可能です。

GitLab Duo ProまたはGitLab Duo Enterpriseを購入すると、ユーザーにシートを割り当てて、アドオンへのアクセスを許可できます。

GitLab.comの場合

前提要件:

  • オーナーロールを持っている必要があります。

プロジェクトまたはグループでGitLab Duo機能を使用するには、少なくとも1つのトップレベルグループでユーザーにシートを割り当てる必要があります。

  1. 左側のサイドバーで、検索または移動先を選択して、グループを見つけます。
  2. 設定 > GitLab Duoを選択します。
  3. シートの利用で、シートをアサインを選択します。
  4. ユーザーの右側にある切り替えをオンにして、GitLab Duoのシートを割り当てます。

ユーザーに確認メールが送信されます。

GitLab Self-Managedの場合

前提要件:

  • 管理者である必要があります。
  1. 左側のサイドバーの下部で、管理者を選択します。
  2. GitLab Duoを選択します。
    • GitLab Duoメニュー項目が使用できない場合は、購入後にサブスクリプションを同期します:
      1. 左側のサイドバーで、サブスクリプションを選択します。
      2. サブスクリプションの詳細の最後の同期の右側で、サブスクリプションの同期（ retry ）を選択します。
  3. シートの利用で、シートをアサインを選択します。
  4. ユーザーの右側にある切り替えをオンにして、GitLab Duoのシートを割り当てます。

ユーザーに確認メールが送信されます。

  • このメールを無効にするには、sm_duo_seat_assignment_email機能フラグをfalseに設定します。この機能フラグは、デフォルトで有効になっています。

シートを割り当てたら、GitLab DuoがGitLab Self-Managedインスタンス用にセットアップされていることを確認してください。

シートの割り当てと一括消去

複数のユーザーに対して、シートを一括で割り当てたり、消去したりできます。

SAML Group Sync

GitLab.comグループは、SAMLグループ同期を使用してGitLab Duoのシートの割り当てを管理できます。

GitLab.comの場合

  1. 左側のサイドバーで、検索または移動先を選択して、グループを見つけます。
  2. 設定 > GitLab Duoを選択します。
  3. 右下のほうで、ページの表示を調整して、選択可能なユーザー数を増やすために50または100項目を表示できます。
  4. シートを割り当てまたは消去するユーザーを選択します:
    • 複数のユーザーを選択するには、各ユーザーの左側にあるチェックボックスをオンにします。
    • すべて選択するには、テーブルの上部にあるチェックボックスをオンにします。
  5. シートを割り当てまたは消去します:
    • シートを割り当てるには、シートを割り当てる、次にシートをアサインを選択して確定します。
    • シートからユーザーを消去するには、シートを消去を選択し、次にシートを消去を選択して確定します。

GitLab Self-Managedの場合

前提要件:

  • 管理者である必要があります。
  • GitLab 17.5以降が必要です。
  1. 左側のサイドバーの下部で、管理者を選択します。
  2. GitLab Duoを選択します。
  3. 右下のほうで、ページの表示を調整して、選択可能なユーザー数を増やすために50または100項目を表示できます。
  4. シートを割り当てまたは消去するユーザーを選択します:
    • 複数のユーザーを選択するには、各ユーザーの左側にあるチェックボックスをオンにします。
    • すべて選択するには、テーブルの上部にあるチェックボックスをオンにします。
  5. シートを割り当てまたは消去します:
    • シートを割り当てるには、シートを割り当てる、次にシートをアサインを選択して確定します。
    • シートからユーザーを消去するには、シートを消去を選択し、次にシートを消去を選択して確定します。
  6. ユーザーの右側にある切り替えをオンにして、GitLab Duoのシートを割り当てます。

GitLab Self-Managedインスタンスの管理者は、Rakeタスクを使用して、シートを一括で割り当てたり、消去したりすることもできます。

LDAP構成でのGitLab Duoのシートの管理

LDAPグループメンバーシップに基づいて、LDAP対応ユーザーのGitLab Duoのシートを自動的に割り当てたり、消去したりできます。

この機能を有効にするには、LDAP設定でduo_add_on_groupsプロパティを構成する必要があります。

duo_add_on_groupsが構成されると、LDAP対応ユーザー間でのDuoシート管理の信頼できる唯一の情報源になります。詳細については、シートの割り当てワークフローを参照してください。

この自動化されたプロセスにより、組織のLDAPグループ構造に基づいて、Duoシートが効率的に割り当てられるようになります。詳細については、LDAPを使用したGitLab Duoアドオンシート管理を参照してください。

割り当てられたGitLab Duoユーザーを表示

前提要件:

  • GitLab Duo ProまたはGitLab Duo Enterpriseアドオンを購入するか、アクティブなGitLab Duoトライアルが必要です。

GitLab Duo ProまたはGitLab Duo Enterpriseを購入すると、ユーザーにシートを割り当てて、アドオンへのアクセスを許可できます。次に、割り当てられたGitLab Duoユーザーの詳細を表示できます。

GitLab Duoシート使用状況ページには、各ユーザーに関する次の情報が表示されます:

  • ユーザーの氏名とユーザー名
  • シートの割り当てステータス
  • 公開メールアドレス: ユーザーの公開プロファイルに表示されるメール。
  • 最後のGitLabアクティビティー: ユーザーがGitLabで最後にアクションを実行した日付。
  • 最後のGitLab Duoアクティビティー: ユーザーが最後にGitLab Duo機能を使用した日付。GitLab Duoのアクティビティーによって更新されます。

これらのフィールドは、GraphQL APIのAddOnUserタイプからのデータを使用します。

GitLab.comの場合

前提要件:

  • オーナーロールを持っている必要があります。
  1. 左側のサイドバーで、検索または移動先を選択して、グループを見つけます。
  2. 設定 > GitLab Duoを選択します。
  3. シートの利用で、シートをアサインを選択します。
  4. フィルターバーから、アサインされたシートと可能を選択します。
  5. ユーザーリストは、GitLab Duoのシートが割り当てられているユーザーのみにフィルター処理されます。

GitLab Self-Managedの場合

前提要件:

  • 管理者である必要があります。
  • GitLab 17.5以降が必要です。
  1. 左側のサイドバーの下部で、管理者を選択します。
  2. GitLab Duoを選択します。
    • GitLab Duoメニュー項目が使用できない場合は、購入後にサブスクリプションを同期します:
      1. 左側のサイドバーで、サブスクリプションを選択します。
      2. サブスクリプションの詳細の最後の同期の右側で、サブスクリプションの同期（ retry ）を選択します。
  3. シートの利用で、シートをアサインを選択します。
  4. GitLab Duoのシートに割り当てられたユーザーでフィルターするには、ユーザーをフィルターバーで、アサインされたシートを選択し、次に可能を選択します。
  5. ユーザーリストは、GitLab Duoのシートが割り当てられているユーザーのみにフィルター処理されます。

シートの自動消去

GitLab Duoアドオンのシートは、対象となるユーザーのみがアクセスできるように、自動的に消去されます。これは、次の場合に発生します:

  • シートの超過
  • ブロック、BAN、および非アクティブ化されたユーザー

サブスクリプションの有効期限時

GitLab Duoアドオンを含むサブスクリプションが有効期限切れになった場合、シートの割り当ては28日間保持されます。サブスクリプションが更新された場合、またはこの28日間の期間中にGitLab Duoを含む新しいサブスクリプションが購入された場合、ユーザーは自動的に再度割り当てられます。それ以外の場合、シートの割り当ては消去され、ユーザーを再度割り当てる必要があります。

シートの超過の場合

購入したGitLab Duoアドオンのシートの数が減少した場合、サブスクリプションで利用可能なシートの数に合わせてシートの割り当てが自動的に消去されます。

例:

  • すべてのシートが割り当てられている50シートのGitLab Duo Proサブスクリプションがあります。
  • 30シートのサブスクリプションを更新します。サブスクリプションを超える20人のユーザーは、GitLab Duo Proシートの割り当てから自動的に消去されます。
  • 更新前に20人のユーザーのみがGitLab Duo Proシートに割り当てられていた場合、シートの消去は発生しません。

シートは、次の基準に基づいて、この順序で消去対象として選択されます:

  1. まだコード提案を使用していないユーザー（最も最近割り当てられた順）。
  2. コード提案を使用したユーザー（コード提案の最新の使用状況の少ない順）。

ブロック、BAN、および非アクティブ化されたユーザーの場合

1日に1～2回、CronJobがGitLab Duoシートの割り当てをレビューします。GitLab Duoのシートが割り当てられているユーザーがブロック、BAN、または非アクティブ化された場合、GitLab Duo機能へのアクセスは自動的に消去されます。

シートを削除すると、そのシートは利用可能になり、新しいユーザーに再割り当てできます。

トラブルシューティング

UIを使用してユーザーに割り当てることができません

使用量クォータページで、次の両方の問題が発生した場合、UIを使用してユーザーにシートを割り当てることはできません:

  • シートタブが読み込まれません。

  • 次のエラーメッセージが表示されます:

    An error occurred while loading billable members list.

回避策として、このスニペット内のGraphQLのクエリを使用して、ユーザーにシートを割り当てることができます。