グループ

GitLabでは、1つ以上の関連プロジェクトを同時に管理するためにグループを使います。

グループを使ってプロジェクトの権限を管理することができます。誰かがグループにアクセスすると、グループ内のすべてのプロジェクトにアクセスできるようになります。

また、グループ内のプロジェクトのイシューやマージリクエストをすべて表示したり、グループのアクティビティを示すアナリティクスを表示したりできます。

グループを使って、グループのメンバー全員と一度にコミュニケーションできます。

大規模な組織の場合は、サブグループを作成することもできます。

グループの作成と管理の詳細については、「グループの管理」を参照してください。

note
自己管理されているお客様には、トップレベルのグループを1つ作成し、組織全体の概要を確認できるようにすることが有益な場合があります。すべてのグループの組織ビューを作成する取り組みの詳細については、エピック9266を参照してください。単一のトップレベルグループは、完全なセキュリティダッシュボードとセンター、脆弱性とコンプライアンスセンター、およびバリューストリーム分析を通じて、組織全体のインサイトを提供します。

グループの可視性

プロジェクトと同様に、グループも可視性を制限する設定が可能です：

  • 匿名ユーザー。
  • すべての認証ユーザー。
  • 明示的なグループメンバーのみ。

アプリケーション設定レベルでの可視レベルの制限は、グループにも適用されます。内部に設定されている場合、匿名ユーザーの探索ページは空になります。グループページには可視レベルアイコンがあります。

管理者ユーザーは、直接の親グループの可視レベルよりも高い可視レベルのサブグループまたはプロジェクトを作成できません。

グループの表示

すべての公開グループを表示します：

  1. 左のサイドバーで、Search を選択するか、次のページに進んでください。
  2. 私のグループをすべて表示」を選択します。
  3. 右上の[グループを検索]を選択します。

あなたが直接または間接的にメンバーであるグループを表示するには：

  1. 左のサイドバーで、Search を選択するか、次のページに進んでください。
  2. 私のグループをすべて表示」を選択します。

このページには、あなたがメンバーであるグループが表示されます：

  • サブグループの親グループに所属している場合。
  • グループまたはサブグループのプロジェクトの直接的または継承されたメンバーシップを通じて。

グループの活動を見る

プロジェクトのアクティビティを表示します：

  1. 左のサイドバーで、Search（検索）を選択するか、Go to（移動）を選択してグループを探します。
  2. 管理 > アクティビティを選択します。

  3. オプション貢献者の種類によってアクティビティをフィルタリングするには、タブを選択します：

    • すべて：グループおよびグループのプロジェクトに所属するグループメンバーのすべての貢献。
    • プッシュイベント：グループのプロジェクトにおけるプッシュイベント。
    • マージイベント：グループのプロジェクトで受け入れられたマージリクエスト。
    • イシューイベント：グループのプロジェクトで開かれたイシューと閉じられたイシュー。
    • エピックイベント：グループ内でオープン、クローズされたエピック。
    • コメントグループのメンバーがグループのプロジェクトに投稿したコメント。
    • Wiki：グループ内のWikiページの更新。
    • デザイン：グループのプロジェクトに追加、更新、削除されたデザイン。
    • チーム：グループのプロジェクトに参加したメンバー、脱退したメンバー。

グループを作成

グループを作成します：

  1. 左サイドバーの上部にある「新規作成（{プラス}）」から「新規グループ」を選択します。
  2. グループの作成］を選択します。
  3. グループ名」にグループの名前を入力します。グループ名として使用できない単語のリストについては、予約名を参照してください。
  4. 名前空間に使用されるグループのパスをGroup URL に入力します。
  5. 視認性のレベルを選択します。
  6. 以下の質問に答えて、GitLab体験をパーソナライズしましょう：
    • あなたのロールは何ですか？
    • このグループを利用しているのは誰ですか？
    • このグループを何に使っていますか？
  7. GitLabメンバーや他のユーザーをグループに招待します。

グループの詳細については、GitLab 名前空間（ユーザー、グループ、サブグループ）をご覧ください。

グループを削除する

デフォルトで遅延削除を有効にし、GitLab16.0でGitLab.comとセルフマネージドで即座に削除するオプションを削除。

グループとその内容を削除するには

  1. 左のサイドバーで、Search（検索）を選択するか、Go to（移動）を選択してグループを探します。
  2. 左サイドバーで、設定 > 一般を選択します。
  3. 詳細」セクションを展開します。
  4. グループの削除] セクションで、[グループの削除] を選択します。
  5. グループ名を入力します。
  6. 確認」を選択します。

グループはグループダッシュボードから削除することもできます：

  1. 左のサイドバーで、Search を選択するか、次のページに進んでください。
  2. 私のグループをすべて表示」を選択します。
  3. 削除したいグループの({ellipsis_v})を選択します。
  4. 削除］を選択します。
  5. グループの削除] セクションで、[グループの削除] を選択します。
  6. グループ名を入力します。
  7. 確認」を選択します。

このアクションはグループを削除します。また、グループ内のすべてのプロジェクトを削除するバックグラウンドジョブが追加されます。

GitLab 12.8以降、GitLabPremiumと Ultimateでは、このアクションはグループを削除するためのバックグラウンドジョブを追加します。デフォルトでは、ジョブは7日先の削除をスケジュールします。この保存期間はインスタンス設定で変更することができます。

GitLab 13.6以降では、削除を設定したユーザーが削除が行われる前にグループから削除された場合、ジョブはキャンセルされ、グループの削除はスケジュールされなくなります。

グループの即時削除

待ちたくない場合は、すぐにグループを削除することができます。

前提条件：

削除マークを付けたグループをすぐに削除するには：

  1. 左のサイドバーで、Search（検索）を選択するか、Go to（移動）を選択してグループを探します。
  2. 設定] > [全般]を選択します。
  3. 詳細設定] を展開します。
  4. グループを永久に削除」セクションで、「グループを削除」を選択します。
  5. と聞かれたら、動作を確認する。

あなたのグループ、そのサブグループ、プロジェクト、およびイシューやマージリクエストを含むすべての関連リソースが削除されます。

グループの復元

GitLab 12.8で導入されました。

削除マークがついているグループを復元する場合。

  1. 左のサイドバーで、Search（検索）を選択するか、Go to（移動）を選択してグループを探します。
  2. 設定] > [全般]を選択します。
  3. 詳細」セクションを展開します。
  4. グループの復元]セクションで、[グループの復元]を選択します。

グループへのアクセス権を要求する

管理者が許可すれば、ユーザーとしてグループのメンバーになることができます。

  1. 左のサイドバーで、Search を選択するか、次のページに進んでください。
  2. 私のグループをすべて表示」を選択します。
  3. 右上の「グループを探索」を選択します。
  4. グループ名でグループを検索します。
  5. 検索結果で、グループ名を選択します。
  6. グループページで、グループ名の下にある「Request Access」を選択します。

最も最近アクティビティに参加したグループオーナーのうち、最大10人にあなたのリクエストがEメールで届きます。どのグループオーナーもリクエストを承認または拒否することができます。

リクエストが承認される前に気が変わった場合は、「アクセスリクエストの撤回」を選択してください。

グループメンバーの表示

グループのメンバーを表示します：

  1. 左のサイドバーで、Search（検索）を選択するか、Go to（移動）を選択してグループを探します。
  2. 管理 > メンバーを選択します。

表にメンバーが表示されます：

  • アカウント名とユーザー名
  • メンバーシップのソース透明性を保つために、GitLabはグループメンバーの全てのメンバーシップソースを表示します。複数のメンバーシップソースを持つメンバーは、別々のメンバーとして表示され、カウントされます。例えば、あるメンバーがグループに直接追加された場合と継承によって追加された場合の両方がある場合、そのメンバーはMembersテーブルに異なるソースで2回表示され、グループの2人のメンバーとしてカウントされます。
  • グループ内の最大ロールグループ内の
  • グループメンバーの有効期限
  • アカウントに関するアクティビティ
note
グループメンバーのソースの表示に一貫性がない場合があります。詳細については、イシュー414557を参照してください。

グループのメンバーのフィルタと並べ替え

グループのメンバーを探すには、ソート、フィルター、検索ができます。

グループの絞り込み

グループをフィルタリングしてメンバーを検索します。デフォルトでは、グループとサブグループのすべてのメンバーが表示されます。

グループメンバーのリストでは、以下のバッジを表示できます：

  1. 左のサイドバーで、Search（検索）を選択するか、Go to（移動）を選択してグループを探します。
  2. 管理 > メンバーを選択します。
  3. メンバーのリストの上にある［メンバーのフィルタ］ボックスに、フィルタ条件を入力します。
    • グループのメンバーのみを表示するには、[会員資格 = 直接] を選択します。
    • グループとそのサブグループのメンバーを表示するには、「メンバーシップ= 継承」を選択します。
    • 二要素認証が有効または無効なメンバーを表示するには、「2FA = 有効」または「2FA=無効」を選択します。
    • GitLab 14.0以降では、SAML SSOまたはSCIMプロビジョニングによって作成されたGitLabユーザーを表示するには、Enterprise = trueを選択します。

グループを検索

名前、ユーザー名、公開Eメールでメンバーを検索できます。

  1. 左のサイドバーで、Search（検索）を選択するか、Go to（移動）を選択してグループを探します。
  2. 管理 > メンバーを選択します。
  3. メンバー一覧の上にある[メンバーのフィルタ]ボックスに検索条件を入力します。
  4. メンバーのフィルタ」ボックスの右側にある虫眼鏡（{search}）を選択します。

グループ内のメンバーの並べ替え

アカウント、付与されたアクセス、最大ロール、最終サインインでメンバーを並べ替えることができます。

  1. 左のサイドバーで、Search（検索）を選択するか、Go to（移動）を選択してグループを探します。
  2. 管理 > メンバーを選択します。
  3. メンバーリストの上にある右上のアカウントリストから、フィルタリングする条件を選択します。
  4. ソートを昇順と降順に切り替えるには、「アカウント」リストの右側にある矢印（{ソート最下位}ま たは{ソート最上位}）を選択します。

ユーザーをグループに追加する

GitLab 16.2で導入されたアクセス期限切れメール通知。

ユーザーにグループ内の全てのプロジェクトへのアクセス権を与えることができます。

前提条件

  • オーナーロールが必要です。
  1. 左のサイドバーで、Search（検索）を選択するか、Go to（移動）を選択してグループを探します。
  2. 管理 > メンバーを選択します。
  3. メンバーを招待] を選択します。
  4. フィールドに入力します。
    • ロールはグループ内のすべてのプロジェクトに適用されます。詳細については、権限を参照してください。
    • オプション。アクセスの有効期限を選択します。この日付以降、ユーザーはプロジェクトにアクセスできなくなります。
  5. 招待］を選択します。

アクセス権の有効期限を選択した場合、グループメンバーには、アクセス権の有効期限が切れる7日前に電子メールで通知が送信されます。

自動的に追加されないメンバーは、[招待] タブに表示されます。ユーザーがこのタブに表示される理由は次のとおりです：

グループからメンバーを削除

前提条件：

  • オーナーロールが必要です。
  • メンバはグループの直接のメンバシップを持っている必要があります。メンバーシップが親グループから継承されている場合、そのメンバーは親グループからのみ削除できます。

グループからメンバーを削除するには

  1. 左のサイドバーで、Search（検索）を選択するか、Go to（移動）を選択してグループを探します。
  2. 管理 > メンバーを選択します。
  3. 削除するメンバーの横にある垂直の省略記号（{ellipsis_v}）を選択します。
  4. メンバの削除] を選択します。
  5. オプション。メンバーの削除確認ボックスで
    • サブグループおよびプロジェクトから直接ユーザーのメンバシップを削除するには、[サブグループおよびプロジェク トからも直接ユーザーのメンバシップを削除する] チェック ボックスをオンにします。
    • リンクされたイシューとマージリクエストからユーザーの割り当てを解除するには、リンクされたイシューとマージリクエストからもこのユーザーの割り当てを解除する チェックボックスを選択します。
  6. メンバの削除] を選択します。

削除されたユーザーが再度招待できないようにします。

メンテナーやオーナーのロールを持つ悪意のあるユーザーは、GitLab管理者が削除したグループやプロジェクトに再び招待できるというレースコンディションを悪用することができます。

この問題を避けるために、GitLab管理者は削除されたユーザーが自分自身を招待できないようにすることができます。

プロジェクトをグループに追加する

新しいプロジェクトをグループに追加するには、2種類の方法があります。

  • グループを選択し、新規プロジェクトを選択します。その後、プロジェクトの作成を続けることができます。

  • プロジェクト作成中に、ドロップダウンリストからグループを選択します。

    Select group

グループにプロジェクトを追加できる人の指定

デフォルトでは、ユーザーは

  • このデフォルトは変更することができます。このデフォルトは変更できます。
  • 少なくともメンテナーのロールはプロジェクトをグループにフォークできます。このデフォルトでは、Developerロールを持つユーザーは、保護されたブランチを含むプロジェクトをフォークできず、変更もできません。

グループの下にプロジェクトを作成できるロールを変更するには、以下の手順に従います：

  1. 左のサイドバーで、Search（検索）を選択するか、Go to（移動）を選択してグループを探します。
  2. 設定] > [全般]を選択します。
  3. 権限とグループの機能」セクションを展開します。
  4. プロジェクトの作成が許可されているロールドロップダウン リストで、必要なオプションを選択します。
  5. 変更を保存を選択します。

この設定をグローバルに変更するには、「プロジェクト作成のデフォルトの保護」を参照してください。