グループ

GitLabでは、グループを使用して、1つまたは複数の関連プロジェクトを同時に管理します。

グループを使用すると、すべてのグループメンバーとコミュニケーションを取り、プロジェクトの権限を管理できます。グループへのアクセス権を持っているユーザーは、そのグループ内のすべてのプロジェクトへのアクセス権を取得します。

また、グループ内のプロジェクトのすべてのイシューとマージリクエスト、およびグループのアクティビティーに関する分析を表示することもできます。

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

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

グループ階層

グループは、ツリー構造で編成されています:

• top-level group（トップレベルグループ）は、組織の「ルート」に作成されたグループです。1つの組織に、1つまたは複数のトップレベルグループを含めることができます。トップレベルグループには、1つまたは複数のサブグループを含めることができます。
• parent group（親グループ）は、1つまたは複数のサブグループを含むグループです。
• subgroup（サブグループ）は、別のグループに属するグループです。

たとえば、次の図について説明します:

• 組織に4つのグループがあります。1つのトップレベルグループ（T）に1つのサブグループ（G）があり、G内に2つのサブグループ（AとB）が含まれています。
• Tはトップレベルグループであり、Gの親グループです。
• GはTのサブグループ（子）であり、AとBの親グループです。
• AとBはGのサブグループ（子）です。

%%{init: { "fontFamily": "GitLab Sans", 'theme':'neutral' }}%%
flowchart TD
  accTitle: Group hierarchy
  accDescr: Example of a group hierarchy in an organization

  subgraph Organization
    T[Group T] --> G[Group G]
    G --> A[Group A]
    G --> B[Group B]
end

グループ構造

グループの設定方法は、ユースケース、チーム規模、アクセス要件によって異なります。次の表に、グループを構成する最も一般的なモデルを示します。

グループの表示レベル

プロジェクトと同様に、グループは次のユーザーに表示されるように設定できます:

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

アプリケーション設定レベルでの表示レベルの制限は、グループにも適用されます。内部に設定すると、検索ページは匿名ユーザーに対して空になります。グループページには、表示レベルのアイコンがあります。

ユーザーは、直属の親グループよりも高い表示レベルでサブグループまたはプロジェクトを作成することはできません。

複数のグループを表示する

すべての公開グループまたは内部グループを確認するには:

1. 左側のサイドバーで、検索または移動先を選択します。新しいナビゲーションをオンにしている場合、このフィールドは上部のバーにあります。
2. すべてのグループを表示を選択します。
3. 右上隅で、グループを検索するを選択します。

メンバーになっているグループを表示する

直接または間接的にメンバーシップを持っているグループを表示するには:

1. 左側のサイドバーで、検索または移動先を選択します。新しいナビゲーションをオンにしている場合、このフィールドは上部のバーにあります。
2. すべてのグループを表示を選択します。

このページには、以下によって自分がメンバーであるグループが表示されます:

• サブグループの親グループのメンバーシップ。
• グループまたはサブグループ内のプロジェクトの直接または継承されたメンバーシップ。

非アクティブなグループを表示

グループが削除の保留中であるか、アーカイブされている場合、グループは非アクティブになります。

すべての非アクティブなグループを表示するには、次の手順に従います:

1. 左側のサイドバーで、検索または移動先を選択して、グループを見つけます。新しいナビゲーションをオンにしている場合、このフィールドは上部のバーにあります。
2. すべてのグループを表示を選択します。
3. 非アクティブタブを選択します。

リスト内の各非アクティブなグループには、グループがアーカイブ済みか削除の保留中かを示すバッジが表示されます。

グループが削除の保留中の場合、リストには以下も表示されます:

• グループが最終的に削除されるようにスケジュールされている時間。
• 復元アクション。グループを復元すると、次のようになります:
  • 削除の保留中のラベルが削除されます。グループは削除のスケジュールから削除されます。
  • グループが非アクティブタブから削除されます。

1つのグループを表示する

グループの概要ページには、グループとそのメンバー、サブグループ、プロジェクトに関する次の情報が表示されます:

• グループの説明
• 最近のアクティビティー
• 作成されたマージリクエストとイシューの数
• 追加されたメンバーの数
• サブグループとプロジェクト
• 共有プロジェクト
• アーカイブされたプロジェクト

グループを表示するには:

• 左側のサイドバーで、検索または移動先を選択して、グループを見つけます。新しいナビゲーションをオンにしている場合、このフィールドは上部のバーにあります。

グループのサブグループとプロジェクトを検索し、昇順または降順に並べ替えることができます。

https://gitlab.example.com/-/g/<id>で、名前の代わりにIDを使用してグループにアクセスできます。たとえば、グループexample-groupのIDが123456の場合、https://gitlab.example.com/example-groupまたはhttps://gitlab.example.com/-/g/123456でグループにアクセスできます。

グループIDを見つける

GitLab APIを使用してグループを操作する場合は、グループIDが必要になる場合があります。

グループIDを見つけるには:

1. 左側のサイドバーで、検索または移動先を選択して、グループを見つけます。新しいナビゲーションをオンにしている場合、このフィールドは上部のバーにあります。
2. グループの概要ページの右上隅で、アクション（ ）を選択します。
3. Copy Group ID（グループIDをコピー）を選択します。

グループのアクティビティーを表示する

グループのアクティビティーを表示するには:

1. 左側のサイドバーで、検索または移動先を選択して、グループを見つけます。新しいナビゲーションをオンにしている場合、このフィールドは上部のバーにあります。

2. 管理 > アクティビティーを選択します。

3. オプション。コントリビュートの種類でアクティビティーをフィルタリングするには、次のタブを選択します:

   • すべて: グループメンバーによる、グループおよびグループのプロジェクト内のすべてのコントリビュート。
   • プッシュイベント: グループのプロジェクトでのプッシュイベント。
   • マージイベント: グループのプロジェクトで承認されたマージリクエスト。
   • イシューイベント: グループのプロジェクトでオープンまたはクローズされたイシュー。
   • コメント: グループメンバーによってグループのプロジェクトに投稿されたコメント。
   • Wiki: グループ内のWikiページの更新。
   • デザイン: グループのプロジェクトで追加、更新、削除されたデザイン。
   • チーム: グループのプロジェクトに参加および離脱したグループメンバー。

グループを作成する

グループを作成するには:

1. 左側のサイドバーの上部で、新規作成（ ）を選択し、新規グループを選択します。新しいナビゲーションをオンにしている場合、このボタンは右上隅にあります。
2. グループを作成を選択します。
3. グループ名テキストボックスに、グループの名前を入力します。グループ名として使用できない単語のリストについては、予約済みの名前を参照してください。
4. グループURLテキストボックスに、ネームスペースに使用するグループのパスを入力します。
5. グループの表示レベルを選択します。
6. オプション。GitLabエクスペリエンスをパーソナライズするには:
   • **だれがこのグループを使用しますか？**で、オプションを選択します。
   • **このグループを何に使う予定ですか？**ドロップダウンリストから、オプションを選択します。
7. オプション。グループにメンバーを招待するには、Email 1（メール1）テキストボックスに、招待するユーザーのメールアドレスを入力します。他のユーザーを招待するには、他のメンバーを招待を選択し、ユーザーのメールアドレスを入力します。
8. グループを作成を選択します。

グループの詳細については、GitLab Namespaces (users, groups and subgroups)（GitLabネームスペース（ユーザー、グループ、サブグループ））をご覧ください。

グループ名、説明、アバターを編集する

グループの詳細は、グループの一般設定から編集できます。

前提要件:

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

グループの詳細を編集するには:

1. 左側のサイドバーで、検索または移動先を選択して、グループを見つけます。新しいナビゲーションをオンにしている場合、このフィールドは上部のバーにあります。
2. 設定 > 一般を選択します。
3. グループ名テキストボックスに、グループ名を入力します。グループ名の制限を参照してください。
4. オプション。**グループの説明 (オプション)**テキストボックスに、グループの説明を入力します。説明は500文字に制限されています。
5. オプション。グループアバターで、ファイルを選択を選択し、画像を選択します。理想的な画像サイズは192 x 192ピクセルで、許可される最大ファイルサイズは200 KBです。
6. 変更を保存を選択します。

グループを離脱する

グループを離脱すると、次のようになります:

• グループ、そのサブグループ、およびプロジェクトのメンバーではなくなり、コントリビュートできなくなります。
• 割り当てられていたすべてのイシューとマージリクエストの割り当てが解除されます。

グループを離脱するには:

1. 左側のサイドバーで、検索または移動先を選択して、グループを見つけます。新しいナビゲーションをオンにしている場合、このフィールドは上部のバーにあります。
2. グループの概要ページの右上隅で、アクション（ ）を選択します。
3. このグループから離脱するを選択し、もう一度このグループから離脱するを選択します。

グループを削除する

デフォルトでは、グループを初めて削除すると、削除保留状態になります。すぐに削除するには、グループをもう一度削除します。

前提要件:

• グループのオーナーロールが必要です。
• グループにプロジェクトが含まれている場合、プロジェクトの削除を許可する必要があります。

グループとそのコンテンツを削除するには:

1. 左側のサイドバーで、検索または移動先を選択して、グループを見つけます。新しいナビゲーションをオンにしている場合、このフィールドは上部のバーにあります。
2. 設定 > 一般を選択します。
3. 高度な設定セクションを展開します。
4. グループを削除セクションで、削除を選択します。
5. 確認ダイアログで、グループ名を入力し、確認を選択します。

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

1. 左側のサイドバーで、検索または移動先を選択します。新しいナビゲーションをオンにしている場合、このフィールドは上部のバーにあります。
2. すべてのグループを表示を選択します。
3. 削除するグループの（ ）を選択します。
4. 削除を選択します。
5. 確認ダイアログで、グループ名を入力し、確認を選択します。

このアクションにより、グループを削除対象としてマークするバックグラウンドジョブが追加されます。GitLab.comでは、グループは30日後に削除されます。GitLab Self-Managedでは、インスタンスの設定から保持期間を変更できます。

グループの削除をスケジュールしたユーザーが、削除の実行前にグループへのアクセス権を失った場合（グループを離脱したり、ロールがダウングレードされたり、グループからBANされたりした場合）、復元するジョブは代わりにグループを復元するため、グループは削除対象としてスケジュールされなくなります。

グループをすぐに削除する

待機期間を経ずに、グループをすぐに削除することもできます。

前提要件:

• グループのオーナーロールが必要です。
• グループを削除対象としてマークしている必要があります。

削除対象としてマークされたグループをすぐに削除するには:

1. 左側のサイドバーで、検索または移動先を選択して、グループを見つけます。新しいナビゲーションをオンにしている場合、このフィールドは上部のバーにあります。
2. 設定 > 一般を選択します。
3. 高度な設定を展開します。
4. グループを削除セクションで、今すぐ削除を選択します。
5. 要求されたら、アクションを確認します。

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

グループを復元する

削除対象としてマークされているグループを復元するには:

1. 左側のサイドバーで、検索または移動先を選択して、グループを見つけます。新しいナビゲーションをオンにしている場合、このフィールドは上部のバーにあります。
2. 設定 > 一般を選択します。
3. 高度な設定セクションを展開します。
4. グループを復元セクションで、グループを復元を選択します。

アクションメニューを使用してグループを管理する

すべてのグループのリストを表示し、アクションメニューで管理できます。

前提要件:

• グループからの離脱を除く、使用可能なすべてのアクションにはオーナーロールが必要です。

グループのアクションメニューにアクセスするには、次の手順に従います:

1. 左側のサイドバーで、検索または移動先 > すべてのグループを表示を選択します。新しいナビゲーションをオンにしている場合、このフィールドは上部のバーにあります。
2. グループページで、グループを見つけてアクションメニューを選択します（ ）。
3. アクションを選択します。

グループの状態に応じて、次のアクションを使用できます:

グループへのアクセスをリクエストする

ユーザーは、管理者が許可すれば、グループのメンバーになることをリクエストできます。

1. 左側のサイドバーで、検索または移動先を選択します。新しいナビゲーションをオンにしている場合、このフィールドは上部のバーにあります。
2. すべてのグループを表示を選択します。
3. 右上隅で、グループを検索するを選択します。
4. 名前で検索テキストボックスに、参加するグループの名前を入力します。
5. 検索結果で、グループの名前を選択します。
6. グループページで、グループ名の下にあるアクセスをリクエストを選択します。

最近アクティブなグループオーナーの上位10人までが、リクエストを記載したメールを受信します。グループオーナーは、リクエストを承認または拒否できます。

リクエストが承認される前に気が変わった場合は、アクセスリクエストを取り消すを選択します。

グループメンバーを表示する

グループのメンバーを表示するには:

1. 左側のサイドバーで、検索または移動先を選択して、グループを見つけます。新しいナビゲーションをオンにしている場合、このフィールドは上部のバーにあります。
2. 管理 > メンバーを選択します。

表には、メンバーについて次の内容が表示されます:

• アカウント名とユーザー名。
• ソースのソース。透明性を確保するため、GitLabはグループメンバーのすべてのメンバーシップソースを表示します。複数のメンバーシップソースを持つメンバーは、個別のメンバーとして表示およびカウントされます。たとえば、メンバーがグループに直接および継承によって追加されている場合、そのメンバーは異なるソースとともにメンバーテーブルに2回表示され、グループに属する2人の個別メンバーとしてカウントされます。
• グループでのロール。
• グループメンバーシップの有効期限。
• アカウントに関連するアクティビティー。

すべてのネームスペースメンバー（およびそれぞれの占有シート）を表示するには、トップレベルのネームスペースで、使用量クォータページを表示します。

グループ内のメンバーをフィルタリングおよび並べ替える

グループ内のメンバーを見つけるには、並べ替え、フィルタリング、または検索を実行します。

グループをフィルタリングする

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

グループメンバーのリストでは、エントリに次のバッジが表示されることがあります:

• SAML: メンバーに接続されているSAMLアカウントがあることを示します。
• エンタープライズ: トップレベルグループのメンバーがEnterpriseユーザーであることを示します。

1. 左側のサイドバーで、検索または移動先を選択して、グループを見つけます。新しいナビゲーションをオンにしている場合、このフィールドは上部のバーにあります。
2. 管理 > メンバーを選択します。
3. メンバーリストの上にあるメンバーをフィルターするテキストボックスに、検索条件を入力します。表示するには:
   • グループの直接メンバーを表示するには、Membership = Direct（メンバーシップ = 直接）を選択します。
   • グループの継承、共有、および継承共有メンバーを表示するには、Membership = Indirect（メンバーシップ = 間接）を選択します。
   • 2要素認証が有効または無効になっているメンバーを表示するには、2FA = Enabled（2FA = 有効）または2FA = Disabled（2FA = 無効）を選択します。
   • Enterpriseユーザーであるトップレベルグループのメンバーを表示するには、Enterprise = trueを選択します。

グループを検索する

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

1. 左側のサイドバーで、検索または移動先を選択して、グループを見つけます。新しいナビゲーションをオンにしている場合、このフィールドは上部のバーにあります。
2. 管理 > メンバーを選択します。
3. メンバーのリストの上にあるメンバーをフィルターするボックスに、検索条件を入力します。
4. メンバーをフィルターするボックスの右側にある虫眼鏡（ ）を選択します。

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

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

1. 左側のサイドバーで、検索または移動先を選択して、グループを見つけます。新しいナビゲーションをオンにしている場合、このフィールドは上部のバーにあります。
2. 管理 > メンバーを選択します。
3. メンバーリストの上にある右上隅のアカウントリストから、フィルタリング条件を選択します。
4. 並べ替えの昇順と降順を切り替えるには、アカウントリストの右側にある矢印（ または ）を選択します。

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

ユーザーにグループ内のすべてのプロジェクトへのアクセス権を付与できます。

前提要件:

• グループのオーナーロールを持っている必要があります。
• GitLab Self-Managedインスタンスの場合:
  • 新規サインアップが無効になっている場合、管理者がユーザーを追加する必要があります。
  • ユーザー招待が許可されていない場合、管理者がユーザーを追加する必要があります。
  • 管理者による承認が有効になっている場合、管理者が招待を承認する必要があります。

1. 左側のサイドバーで、検索または移動先を選択して、グループを見つけます。新しいナビゲーションをオンにしている場合、このフィールドは上部のバーにあります。

2. 管理 > メンバーを選択します。

3. メンバーを招待を選択します。

4. 招待されるユーザーの状況に応じて、次の操作を行います:

   • GitLabアカウントを持っている場合は、ユーザーのユーザー名を入力します。
   • GitLabアカウントを持っていない場合は、ユーザーのメールアドレスを入力します。

5. デフォルトロールまたはカスタムロールを選択します。

6. オプション。アクセス有効期限に、日付を入力または選択します。その日付以降、ユーザーはプロジェクトにアクセスできなくなります。

   アクセス有効期限を入力した場合、グループメンバーはアクセス権が有効期限切れになる7日前にメール通知を受け取ります。

   メンテナーは、自分のアクセス権の有効期限を延長する機能を含め、ロールの有効期限が切れるまで完全な権限を持ちます。

7. 招待を選択します。ユーザーを招待した方法に応じて、次のようになります:

   • GitLabのユーザー名: ユーザーはメンバーリストに追加されます。
   • メールアドレス: ユーザーはメールによる招待を受け取り、アカウントを作成するように求められます。招待が承認されない場合、GitLabは2日後、5日後、および10日後にリマインダーメールを送信します。未承認の招待は、90日後に自動的に削除されます。

自動的に追加されないメンバーは、招待済みタブに表示されます。このタブには、次のユーザーが含まれます:

• 招待をまだ承諾していないユーザー
• 管理者からの承認を待機しているユーザー
• グループのユーザーキャパシティを超えているユーザー

昇格保留中のユーザーを表示する

ロールの昇格に対する管理者の承認が有効になっている場合は、既存のユーザーを請求対象のロールに昇格するメンバーシップリクエストには、管理者による承認が必要です。

昇格保留中のユーザーを表示するには:

1. 左側のサイドバーで、検索または移動先を選択して、グループを見つけます。新しいナビゲーションをオンにしている場合、このフィールドは上部のバーにあります。
2. 管理 > メンバーを選択します。
3. ロールの昇格タブを選択します。

ロールの昇格タブが表示されない場合、グループには保留中の昇格はありません。

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

前提要件:

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

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

1. 左側のサイドバーで、検索または移動先を選択して、グループを見つけます。新しいナビゲーションをオンにしている場合、このフィールドは上部のバーにあります。
2. 管理 > メンバーを選択します。
3. 削除するメンバーの横にある縦方向の省略記号（ ）を選択します。
4. メンバーを削除を選択します。
5. オプション。メンバーを削除確認ダイアログで、次のチェックボックスの一方または両方を選択します:
   • サブグループやプロジェクトからも直接ユーザーのメンバーシップを削除する
   • Also unassign this user from linked issues and merge requests（関連するイシューとマージリクエストからもこのユーザーの割り当てを解除する）
6. メンバーを削除を選択します。

GitLab管理者は、削除されたユーザーが自分自身を再度招待できないようにすることもできます。

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

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

• グループを選択し、新規プロジェクトを選択します。次に、プロジェクトの作成を続行します。

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

  

グループにプロジェクトを追加できるユーザーを指定する

デフォルトでは、少なくとも次のロールを持つユーザーが次の操作を実行できます:

• デベロッパーロールは、グループにプロジェクトを作成できます。このデフォルトは変更できます。
• メンテナーロールは、プロジェクトをグループにフォークできます。このデフォルトにより、デベロッパーロールを持つユーザーは保護ブランチを含むプロジェクトをフォークできません。また、このデフォルトは変更できません。

グループでプロジェクトを作成できるロールを指定するには:

1. 左側のサイドバーで、検索または移動先を選択して、グループを見つけます。新しいナビゲーションをオンにしている場合、このフィールドは上部のバーにあります。
2. 設定 > 一般を選択します。
3. 権限とグループ機能セクションを展開します。
4. プロジェクトの作成に必要な最小ロールから、オプションを選択します。
5. 変更を保存を選択します。

この設定をグローバルに変更する方法の詳細については、プロジェクトの作成に必要なデフォルトの最小ロールを参照してください。