正式なドキュメントは英語版であり、この日本語訳は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以前からの既存のGitLabユーザーは、GitLab Duo Coreの機能を有効にする必要があります。

GitLab 18.0以降の新規GitLabユーザーの場合、GitLab Duo Core機能は自動的に有効になるため、それ以上の操作は必要ありません。

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

GitLab Duo Self-Hosted

オフラインライセンスをお持ちの場合、GitLab Duo CoreはGitLab Duo Self-Hostedでは利用できません。GitLab Duo CoreはGitLab AIゲートウェイへの接続が必要だからです。

オンラインライセンスをお持ちの場合、GitLab Duo CoreをGitLab Duo Self-Hostedと組み合わせて使用できます。GitLab Duo Coreを使用するには、GitLab Duo Chat（Classic）およびインスタンスのコード提案に対して、GitLabマネージドモデルを選択する必要があります。

GitLab Duo Coreの制限

GitLab利用規約とともに、使用制限が、PremiumおよびUltimateのGitLabユーザーの、含まれるコード提案およびGitLab Duo Chat機能の使用に適用されます。

これらの制限が有効になる30日前に、GitLabは事前通知を行います。その時点で、組織の管理者は消費量を監視および管理するためのツールを利用でき、追加の容量を購入できるようになります。

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

Duo ProおよびEnterprise

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

GitLab Duo Agent Platform Self-Hosted

  • 提供形態: GitLab Self-Managed

オフラインライセンスをお持ちのお客様は、GitLab Duo Agent Platform Self-Hostedアドオンを購入して、エージェントPlatformでセルフホストモデルを使用する必要があります。

このアドオンをお持ちのお客様は、使用量ではなく、シート使用量に基づいて請求されます。

オンラインライセンスをお持ちのお客様は、アドオンなしでエージェントPlatformでセルフホストモデルを使用でき、使用量に基づいて請求されます。

GitLab Duo Agent Platform Self-Hostedを購入するには、GitLab Salesチームにお問い合わせください。

GitLab Duoの購入

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

Duo Proのユーザーのアカウント数を購入するには、カスタマーポータルを使用するか、GitLab Salesチームにお問い合わせください。

ポータルを使用するには:

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

追加のGitLab Duoユーザーのアカウント数を購入

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

前提条件:

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

GitLab.comの場合

前提条件:

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

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

前提条件:

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

GitLab Duoユーザーのアカウント数を割り当てる

前提条件:

  • Duo ProまたはEnterpriseアドオンを購入するか、有効なGitLab Duoトライアルを保持している必要があります。
  • GitLab Self-ManagedおよびGitLab Dedicatedの場合:
    • Duo ProアドオンはGitLab 16.8以降で利用可能です。
    • GitLab Duo EnterpriseアドオンはGitLab 17.3以降でのみ利用可能です。

Duo Proまたは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がSelf-Managedインスタンスに設定されていることを確認してください。

GitLab Duoユーザーのアカウント数を一括で割り当ておよび削除

複数のユーザーに対してユーザーのアカウント数を一括で割り当てたり、削除したりできます。

SAMLグループ同期

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ユーザーのアカウント数を割り当てます。

Self-Managedインスタンスの管理者は、Rakeタスクを使用してユーザーのアカウント数を一括で割り当てたり削除したりすることもできます。

LDAP設定によるGitLab Duoユーザーのアカウント数の管理

LDAPグループグループメンバーシップに基づいて、LDAPが有効なユーザーにGitLab Duoユーザーのアカウント数を自動的に割り当てたり削除したりできます。

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

duo_add_on_groupsが設定されると、LDAPが有効なユーザー間のGitLab Duoユーザーのアカウント数管理における信頼できる唯一の情報源になります。詳細については、ユーザーのアカウント数の割り当てワークフローを参照してください。

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

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

前提条件:

  • Duo ProまたはEnterpriseアドオンを購入するか、有効なGitLab Duoトライアルを保持している必要があります。

Duo Proまたは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ユーザーのアカウント数のDuo Proサブスクリプションがあり、すべてのユーザーのアカウント数が割り当てられています。
  • 30ユーザーのアカウント数でサブスクリプションを更新します。サブスクリプションを超過した20人のユーザーは、Duo Proのユーザーのアカウント数の割り当てから自動的に削除されます。
  • 更新前に20人のユーザーのみにDuo Proユーザーのアカウント数が割り当てられていた場合、ユーザーのアカウント数の削除は発生しません。

ユーザーのアカウント数は、次の基準に基づいてこの順序で削除のために選択されます:

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

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

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

ユーザーのアカウント数が削除された後、利用可能になり、新しいユーザーに再割り当てることができます。

トラブルシューティング

UIを使用してユーザーにユーザーのアカウント数を割り当てることができません

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

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

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

    An error occurred while loading billable members list.

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