群组

在极狐GitLab中，您可以使用群组同时管理一个或多个相关项目。

您可以使用群组与所有群组成员进行沟通，并管理项目的权限。 如果某人有群组访问权限，他们将可以访问群组中的所有项目。

您还可以查看群组中项目的所有议题和合并请求，以及有关群组活动的分析。

对于较大的组织，您还可以创建子群组。

有关创建和管理群组的更多信息，请参见管理群组。

群组层级#

群组以树形结构组织：

• 顶级群组是组织的“根”创建的群组。一个组织可以有一个或多个顶级群组。顶级群组可以包含一个或多个子群组。
• 父群组是包含一个或多个子群组的群组。
• 子群组是属于另一个群组的群组。

例如，在下图中：

• 组织有四个群组：一个顶级群组（T），其中包含一个子群组（G），G 内有两个子群组（A 和 B）。
• T 是顶级群组和 G 的父群组。
• G 是 T 的子群组（子）和 A 和 B 的父群组。
• A 和 B 是 G 的子群组（子）。

Rendering chart...

群组结构#

设置群组的方式取决于您的用例、团队规模和访问要求。 下表描述了组织群组的最常见模型。

群组可见性#

像项目一样，群组可以配置为对以下用户可见：

• 匿名用户。
• 所有经过身份验证的用户。
• 仅明确的群组成员。

应用设置级别上的可见性级别限制也适用于群组。如果设置为内部，探索页面对匿名用户为空。群组页面有一个可见性级别图标。

用户不能创建比直接父群组可见性级别更高的子群组或项目。

查看群组#

要探索您所属的所有公共群组：

1. 在左侧边栏中，选择 搜索或转到。
2. 选择 查看我所有的群组。
3. 在右上角，选择 探索群组。

要查看您直接或间接拥有成员资格的群组：

1. 在左侧边栏中，选择 搜索或转到。
2. 选择 查看我所有的群组。

此页面显示您通过以下途径成为成员的群组：

• 子群组的父群组成员资格。
• 群组或子群组中项目的直接或继承成员资格。

查看群组#

群组概览页面显示有关群组及其成员、子群组和项目的信息，例如：

• 群组描述
• 最近活动
• 创建的合并请求和议题数量
• 添加的成员数量
• 子群组和项目
• 共享项目
• 存档项目

要查看群组：

• 在左侧边栏中，选择 搜索或转到并找到您的群组。

您可以搜索群组的子群组和项目，并按升序或降序排列它们。

查看群组活动#

要查看群组的活动：

1. 在左侧边栏中，选择 搜索或转到并找到您的群组。

2. 选择 管理 > 活动。

3. 可选。要按贡献类型过滤活动，请选择一个标签：

   • 所有：群组成员在群组和群组项目中的所有贡献。
   • 推送事件：群组项目中的推送事件。
   • 合并事件：群组项目中接受的合并请求。
   • 议题事件：群组项目中打开和关闭的议题。
   • 评论：群组项目中群组成员发布的评论。
   • Wiki：群组中的 Wiki 页面更新。
   • 设计：群组项目中添加、更新和删除的设计。
   • 团队：加入和离开群组项目的群组成员。

使用群组 ID 访问群组#

您可以使用群组的 ID 而不是名称在 https://gitlab.example.com/-/g/<id> 访问群组。例如，如果您的群组 example-group 的 ID 是 123456，您可以在 https://gitlab.example.com/example-group 或 https://gitlab.example.com/-/g/123456 访问该群组。

如果您想使用极狐GitLab API与群组交互，您可能需要群组 ID。

要复制群组 ID：

1. 在左侧边栏中，选择 搜索或转到并找到您的群组。
2. 在群组概览页面的右上角，选择 操作 (
   )。
3. 选择 复制群组 ID。

创建群组#

要创建群组：

1. 在左侧边栏顶部，选择 创建新 (
   ) 和 新群组。
2. 选择 创建群组。
3. 在 群组名称 文本框中，输入群组名称。有关不能用作群组名称的词列表，请参见 保留名称。
4. 在 群组 URL 文本框中，输入用于命名空间的群组路径。
5. 选择群组的可见性级别。
6. 可选。要个性化您的极狐GitLab体验：
   • 对于 谁将使用此群组？，选择一个选项。
   • 从 您将使用此群组做什么？ 下拉列表中选择一个选项。
7. 可选。要邀请成员加入群组，在 电子邮件 1 文本框中，输入您要邀请的用户的电子邮件地址。要邀请更多用户，请选择 邀请另一个成员 并输入用户的电子邮件地址。
8. 选择 创建群组。

编辑群组名称、描述和头像#

您可以从群组常规设置编辑群组详细信息。

前提条件：

• 您必须拥有群组的所有者角色。

要编辑群组详细信息：

1. 在左侧边栏中，选择 搜索或转到并找到您的群组。
2. 选择 设置 > 常规。
3. 在 群组名称 文本框中，输入您的群组名称。请参见群组名称的限制。
4. 可选。在 群组描述（可选） 文本框中，输入您的群组描述。 描述限制为 500 个字符。
5. 可选。 在 群组头像 下，选择 选择文件，然后选择图像。理想的图像尺寸是 192 x 192 像素，允许的最大文件大小是 200 KB。
6. 选择 保存更改。

离开群组#

当您离开群组时：

• 您不再是群组、其子群组和项目的成员，并且不能贡献。
• 所有分配给您的议题和合并请求都被取消分配。

要离开群组：

1. 在左侧边栏中，选择 搜索或转到并找到您的群组。
2. 在群组概览页面的右上角，选择 操作 ({ellipsis_v})。
3. 选择 离开群组，然后再次选择 离开群组。

删除群组#

要删除群组及其内容：

1. 在左侧边栏中，选择 搜索或转到并找到您的群组。
2. 选择 设置 > 常规。
3. 展开 高级 部分。
4. 在 删除群组 部分，选择 删除群组。
5. 在确认对话框中，输入群组名称并选择 确认。

您还可以从群组仪表板删除群组：

1. 在左侧边栏中，选择 搜索或转到。
2. 选择 查看我所有的群组。
3. 为要删除的群组选择 (
   )。
4. 选择 删除。
5. 在 删除群组 部分，选择 删除群组。
6. 在确认对话框中，输入群组名称并选择 确认。

在极狐GitLab 专业版 和 旗舰版 中，此操作将添加一个后台作业以标记群组以进行删除。默认情况下，该作业计划在未来七天内删除。您可以通过实例设置修改此保留期。

如果计划群组删除的用户在删除发生之前失去对群组的访问权限（例如，通过离开群组、角色降级或被群组禁止），删除作业将恢复并取消存档群组，因此该群组将不再计划删除。

查看待删除的群组#

要查看待删除的子群组列表：

1. 在左侧边栏中，选择 搜索或转到并找到您的群组。
2. 选择 子群组和项目。

标记为待删除的群组标记为 待删除。

立即删除群组#

如果您不想等待，可以立即删除群组。

前提条件：

• 您必须拥有群组的所有者角色。
• 您已标记群组以进行删除。

要立即删除标记为删除的群组：

1. 在左侧边栏中，选择 搜索或转到并找到您的群组。
2. 选择 设置 > 常规。
3. 展开 高级。
4. 在 永久删除群组 部分，选择 删除群组。
5. 在询问时确认操作。

此操作删除群组、其子群组、项目及所有相关资源，包括议题和合并请求。

恢复群组#

要恢复标记为删除的群组：

1. 在左侧边栏中，选择 搜索或转到并找到您的群组。
2. 选择 设置 > 常规。
3. 展开 高级 部分。
4. 在 恢复群组 部分，选择 恢复群组。

请求访问群组#

作为用户，您可以请求成为群组成员，如果管理员允许的话。

1. 在左侧边栏中，选择 搜索或转到。
2. 选择 查看我所有的群组。
3. 在右上角，选择 探索群组。
4. 在 按名称搜索 文本框中，输入您要加入的群组名称。
5. 在搜索结果中，选择群组名称。
6. 在群组页面上，群组名称下方选择 请求访问。

最多十个最近活跃的群组所有者会收到您的请求电子邮件。 任何群组所有者可以批准或拒绝请求。

如果您在请求获得批准之前改变主意，请选择 撤回访问请求。

查看群组成员#

要查看群组成员：

1. 在左侧边栏中，选择 搜索或转到并找到您的群组。
2. 选择 管理 > 成员。

表格显示成员的：

• 账户名称和用户名。
• 其成员资格的来源。 为了透明性，极狐GitLab 显示群组成员的所有成员资格来源。 具有多个成员资格来源的成员显示并计为单独的成员。 例如，如果成员通过继承和直接方式都被添加到群组， 在 成员 表中，该成员会显示两次，具有不同的来源， 并计为该群组的两名独立成员。
• 在群组中的角色。
• 群组成员资格的到期日期。
• 与其账户相关的活动。

要查看所有命名空间成员（及其各自占用的席位），在顶级命名空间中，查看 使用配额 页面。

筛选和排序群组成员#

要在群组中查找成员，您可以排序、筛选或搜索。

筛选群组#

筛选群组以查找成员。默认情况下，群组和子群组中的所有成员都会显示。

在群组成员列表中，条目可以显示以下徽章：

• SAML，表示成员有一个与他们关联的SAML账户。
• 企业，表示顶级群组的成员是企业用户。

1. 在左侧边栏中，选择 搜索或转到并找到您的群组。
2. 选择 管理 > 成员。
3. 在成员列表上方的 筛选成员 文本框中，输入您的搜索条件。查看：
   • 群组的直接成员，选择 成员资格 = 直接。
   • 群组的继承、共享和继承共享成员，选择 成员资格 = 间接。
   • 启用或禁用两因素认证的成员，选择 2FA = 启用 或 2FA = 禁用。
   • 顶级群组的企业用户成员，选择 企业 = true。

搜索群组#

您可以按姓名、用户名或公开电子邮件搜索成员。

1. 在左侧边栏中，选择 搜索或转到并找到您的群组。
2. 选择 管理 > 成员。
3. 在成员列表上方的 筛选成员 框中，输入搜索条件。
4. 在 筛选成员 框右侧，选择放大镜 (
   )。

排序群组成员#

您可以按 账户、授予访问权限、角色 或 最后登录 排序成员。

1. 在左侧边栏中，选择 搜索或转到并找到您的群组。
2. 选择 管理 > 成员。
3. 在成员列表上方的右上角，从 账户 列表中选择排序的标准。
4. 要在升序和降序之间切换，在 账户 列表右侧，选择箭头 (
   或
   )。

向群组添加用户#

您可以授予用户对群组中所有项目的访问权限。

前提条件：

• 您必须拥有群组的所有者角色。
• 如果注册已禁用，管理员必须先通过电子邮件添加用户。
• 如果管理员角色提升审批已开启，管理员必须批准邀请。

1. 在左侧边栏中，选择 搜索或转到并找到您的群组。

2. 选择 管理 > 成员。

3. 选择 邀请成员。

4. 如果用户：

   • 拥有极狐GitLab账户，输入用户的用户名。
   • 没有极狐GitLab账户，输入用户的电子邮件地址。

5. 选择默认角色或自定义角色。

6. 可选。对于 访问到期日期，输入或选择日期。 从该日期起，用户将不能再访问项目。

   如果您输入访问到期日期，群组成员将在访问到期前七天收到电子邮件通知。

维护者在其角色到期之前拥有完整权限，包括延长自己访问到期日期的能力。

1. 选择 邀请。 如果您按以下方式邀请用户：

   • 极狐GitLab用户名，用户会被添加到成员列表。
   • 电子邮件地址，用户会收到电子邮件邀请并被提示创建账户。 如果邀请未被接受，极狐GitLab将在两天、五天和十天后发送提醒邮件。 未接受的邀请将在 90 天后自动删除。

未自动添加的成员显示在 已邀请 标签中。 该标签包括以下用户：

• 尚未接受邀请。
• 正在等待管理员批准。
• 超过群组用户上限。

查看等待提升的用户#

如果管理员角色提升批准已开启，促进现有用户进入计费角色的成员请求需要管理员批准。

要查看等待提升的用户：

1. 在左侧边栏中，选择 搜索或转到并找到您的群组。
2. 选择 管理 > 成员。
3. 选择 角色提升 标签。

如果 角色提升 标签未显示，群组没有等待提升的用户。

从群组中移除成员#

前提条件：

• 您必须拥有所有者角色。
• 成员必须在群组中拥有直接成员资格。如果 成员资格是从父群组继承的，则只能从父群组中移除成员。

要从群组中移除成员：

1. 在左侧边栏中，选择 搜索或转到并找到您的群组。
2. 选择 管理 > 成员。
3. 在要移除的成员旁边，选择垂直省略号 (
   )。
4. 选择 移除成员。
5. 可选。在 移除成员 确认对话框中，选择一个或两个复选框：
   • 也从子群组和项目中移除直接用户成员资格
   • 也将此用户从关联的议题和合并请求中取消分配
6. 选择 移除成员。

极狐GitLab管理员也可以确保移除的用户不能再次邀请自己。

向群组添加项目#

您可以通过两种方式向群组添加新项目：

• 选择一个群组，然后选择 新项目。您可以继续创建您的项目。

• 在创建项目时，从下拉列表中选择一个群组。

  

指定谁可以向群组添加项目#

默认情况下，至少具有以下角色的用户：

• 开发者角色可以在群组下创建项目。此默认设置可以更改。
• 维护者角色可以将项目分叉到群组。此默认设置阻止具有开发者角色的用户分叉包含受保护分支的项目，并且无法更改。

要指定哪些角色可以在群组中创建项目：

1. 在左侧边栏中，选择 搜索或转到并找到您的群组。
2. 选择 设置 > 常规。
3. 展开 权限和群组功能 部分。
4. 从 创建项目所需的最低角色 中选择一个选项。
5. 选择 保存更改。

有关全局更改此设置的更多信息，请参见定义哪些角色可以创建项目的默认最低角色。