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

GitLab Duoへのアクセスを設定

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

グループのGitLab Duoをオンまたはオフにしたり、1つ以上のグループのGitLab Duoへのアクセスを制限したりできます。

GitLab Duoへのアクセスを制限

前提条件:

  • トップレベルグループのオーナーロール。

トップレベルグループのGitLab Duoへのアクセスを制限するには:

  1. 上部のバーで、検索または移動先を選択して、グループを見つけます。

  2. 左側のサイドバーで、設定 > GitLab Duoを選択します。

  3. 設定の変更を選択します。

  4. グループメンバーシップに基づいてアクセス権を制限するで、グループの追加を選択します。

  5. ドロップダウンリストからグループを選択します。

    最初のグループを選択すると、デフォルトですべての対象ユーザールールも追加されます。このルールを使用して、他のすべてのユーザーのアクセスを設定できます。このルールは、グループがGitLab Duo Non-AgenticまたはGitLab Duo Agent Platformへのアクセス権を持たず、既存のすべてのグループが削除された場合に自動的に削除されます。

  6. グループの直接メンバーがGitLab Duo Non-AgenticおよびGitLab Duo Agent Platformにアクセスできるかどうかを選択します。

  7. 変更を保存を選択します。

これらの設定は、次のユーザーに適用されます:

  • グループメンバーシップに基づいてアクセス権を制限するの下で設定されたグループのいずれかの直接メンバーであり、トップレベルグループのプロジェクトまたはサブグループでAIアクションを実行するユーザー。
  • トップレベルグループをdefault GitLab Duo namespaceとして持ち、AIアクションが実行されるトップレベルグループのメンバーではないユーザー。

アクセス制御を設定する場合、トップレベルグループの直接サブグループであるグループのみを選択できます。アクセス制御ルールでは、ネストされたサブグループを使用できません。

前提条件:

  • 管理者アクセス権。

インスタンスのGitLab Duoへのアクセスを制限するには:

  1. 右上隅で、管理者を選択します。

  2. 左側のサイドバーで、GitLab Duoを選択します。

  3. 設定の変更を選択します。

  4. グループメンバーシップに基づいてアクセス権を制限するで:

    • 既存のグループを追加するには、グループの追加を選択します。
    • 新しいグループを作成するには、グループを作成を選択します。

  5. ドロップダウンリストからグループを選択します。

    最初のグループを選択すると、デフォルトですべての対象ユーザールールも追加されます。このルールを使用して、他のすべてのユーザーのアクセスを設定できます。このルールは、グループがGitLab Duo Non-AgenticまたはGitLab Duo Agent Platformへのアクセス権を持たず、既存のすべてのグループが削除された場合に自動的に削除されます。

  6. グループの直接メンバーがGitLab Duo Non-AgenticおよびGitLab Duo Agent Platformにアクセスできるかどうかを選択します。

  7. 変更を保存を選択します。

これらの設定は、グループメンバーシップに基づいてアクセス権を制限するの下で設定されたグループのいずれかの直接メンバーであるユーザーに適用されます。

アクセス制御を設定する場合、トップレベルグループのみを選択できます。サブグループはアクセス制御ルールで使用できません。

グループメンバーシップを手動で管理しない場合は、LDAPまたはSAMLを使用してメンバーシップを同期できます。

グループメンバーシップ

ユーザーが複数のグループに割り当てられている場合、そのユーザーは割り当てられたすべてのグループの機能にアクセスできます。たとえば、ユーザーがグループAでGitLab Duo Non-Agenticへのアクセス権を持ち、グループBでGitLab Duo Agent Platformへのアクセス権を持つ場合、そのユーザーは両方の機能セットにアクセスできます。

すべての対象ユーザールールが設定されている場合、次のユーザーはGitLab Duo Non-AgenticとGitLab Duo Agent Platformの両方にアクセスできます:

  • GitLab.comの場合: トップレベルグループのすべてのメンバー。
  • GitLab Self-Managed: すべてのユーザー。

追加の制御（トップレベルグループまたはインスタンスの機能を無効にするなど）は引き続き適用されます。

グループメンバーシップを同期する

認証にLDAPまたはSAMLを使用する場合は、グループメンバーシップを自動的に同期できます:

  1. LDAPまたはSAMLプロバイダーを設定して、GitLab Duo Agent Platformユーザーを表すグループを含めます。
  2. GitLabで、グループがLDAPまたはSAMLプロバイダーにリンクされていることを確認します。
  3. プロバイダー側のグループでユーザーが追加または削除されると、グループメンバーシップが自動的に更新されます。

詳細については、以下を参照してください:

アクセス制御を使用する

アクセス制御は、段階的なロールアウトやテストと検証に利用できます。

段階的なロールアウト

GitLab Duoの段階的なロールアウトを実装するには:

  1. パイロットユーザーのグループを作成します（例: pilot-users）。
  2. 一部のユーザーをこのグループに追加します。
  3. 機能を検証し、ユーザーをトレーニングしながら、徐々にグループにユーザーを追加します。
  4. 本格的なロールアウトの準備ができたら、すべてのユーザーをグループに追加します。

テストと検証

制御された環境でGitLab Duoの機能をテストするには:

  1. テスト専用のグループを作成します（例: agent-testers）。
  2. テストグループまたはプロジェクトを作成します。
  3. agent-testersグループにテストユーザーを追加します。
  4. 幅広いロールアウトの前に、機能を検証し、ユーザーをトレーニングします。

トラブルシューティング

ユーザーがGitLab Duo機能にアクセスできません

ユーザーがGitLab Duo機能にアクセスできないシナリオは次のとおりです:

  • グループに対してGitLab Duo Non-AgenticまたはGitLab Duo Agent Platformへのアクセスが設定されていません。
  • グループに対してGitLab Duo Non-AgenticまたはGitLab Duo Agent Platformへのアクセスが設定されていますが、次のいずれかに該当します:
    • ユーザーがグループの直接メンバーではない。
    • すべての対象ユーザールールが設定されていません。

この問題を解決するには、次のいずれかを実行します。

  • ユーザーを設定されたグループのいずれかに直接メンバーとして追加します。
  • すべての対象ユーザーにGitLab Duo Non-AgenticまたはGitLab Duo Agent Platformへのアクセス権を付与します。
  • すべてのグループメンバーシップアクセスルールを削除します。

特定のグループでGitLab Duoサイドバーが表示されない

GitLab 18.8と以前のバージョンでは、グループにGitLab Duo Agent Platformへのアクセス権を付与しても、GitLab Duo Non-Agenticへのアクセス権を付与しない場合、そのグループのメンバーにはGitLab Duoサイドバーが表示されません。回避策として、グループがGitLab Duo Non-AgenticとGitLab Duo Agent Platformの両方にアクセスできることを確認してください。

このイシューを解決するには、GitLab 18.9以降にアップグレードしてください。