极狐 GitLab

群组

Tier: 基础版，专业版，旗舰版

Offering: JihuLab.com，私有化部署

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

你可以使用群组与所有群组成员沟通，并管理项目的权限。 如果有人拥有群组的访问权限，他们就能访问该群组中的所有项目。

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

对于大型组织，你还可以创建子群组。

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

群组层级#

群组以树形结构组织：

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

例如，在下图中：

  • 该组织有四个群组：一个顶级群组 (T)，包含一个子群组 (G)，以及 G 内的两个子群组 (A 和 B)。
  • T 是顶级群组，也是 G 的父群组。
  • G 是 T 的子群组，也是 A 和 B 的父群组。
  • A 和 B 是 G 的子群组。
Rendering chart...

群组结构#

设置群组的方式取决于你的使用场景、团队规模和访问需求。 下表描述了最常见的群组结构模型。

模型结构使用场景
简单一个群组用于所有项目。在小型团队中工作或针对特定解决方案（例如，营销网站），需要无缝协作和资源访问。
团队为不同类型的团队（例如，产品和工程）设置不同的群组或子群组。在大型组织中工作，其中一些团队自主工作，或需要集中资源并限制外部团队成员的访问。
客户为每个客户设置一个群组。为需要不同资源和访问级别的多个客户提供定制解决方案。
功能为一种功能类型（例如，AI/ML）设置一个群组或子群组。开发复杂产品，其中某项功能需要特定资源和主题专家的协作。
在私有化部署实例上，如果你想查看整个组织的概览，应创建一个顶级群组。 有关创建所有群组的组织视图的更多信息， [参见史诗 9266](https://jihulab.com/groups/gitlab-cn/-/epics/9266)。 顶级群组通过完整的 [安全仪表板和中心](../application_security/security_dashboard/_index.md)、 [漏洞报告](../application_security/vulnerability_report/_index.md)、 [合规中心](../compliance/compliance_center/_index.md) 和 [价值流分析](value_stream_analytics/_index.md)，提供对整个组织的洞察。

群组可见性#

与项目类似，群组可以配置为对以下用户可见：

  • 匿名用户。
  • 所有已认证用户。
  • 仅明确添加的群组成员。

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

用户无法创建可见性级别高于其直接父群组的子群组或项目。

探索群组#

要探索所有公开或内部群组：

  1. 在顶部栏中，选择 搜索或跳转到。
  2. 从下拉列表中，选择 探索。
  3. 在左侧边栏中，选择 群组。

查看你所属的群组#

版本历史
  • 成员 标签页在极狐GitLab 18.2 引入，带有一个名为 your_work_groups_vue 的功能标志。默认禁用。
  • 在极狐GitLab 18.3 GA。功能标志 your_work_groups_vue 移除。

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

  1. 在顶部栏中，选择 搜索或跳转到。
  2. 从下拉列表中，选择 查看我的所有群组。

此页面显示你通过以下方式成为成员的群组：

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

查看不活跃群组#

版本历史
  • 不活跃 标签页在极狐GitLab 18.2 引入，带有一个名为 your_work_groups_vue 的功能标志。默认禁用。
  • 在极狐GitLab 18.3 GA。功能标志 your_work_groups_vue 移除。
  • 探索群组 页面上的 不活跃 标签页在极狐GitLab 18.8 引入，带有一个名为 explore_groups_vue 的功能标志。默认禁用。
  • 在极狐GitLab 18.11 GA。功能标志 explore_groups_vue 移除。

当群组待删除或已归档时，该群组即为不活跃。

要查看所有不活跃群组：

  1. 在顶部栏中，选择 搜索或跳转到。
  2. 从下拉列表中，选择以下任一：
    • 查看我的所有群组 以筛选你所属的群组。
    • 探索 以筛选公开或内部群组。
  3. 选择 不活跃 标签页。

列表中的每个不活跃群组都会显示一个徽章，表明该群组已归档或待删除。

如果群组待删除，列表还会显示：

  • 群组计划最终删除的时间。
  • 恢复 操作。恢复群组时：
    • 待删除 标签被移除。群组不再计划删除。
    • 群组从 不活跃 标签页中移除。

查看群组#

版本历史
  • 使用群组 ID 访问群组在极狐GitLab 17.5 引入。

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

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

要查看群组：

  • 在顶部栏中，选择 搜索或跳转到 并找到你的群组。

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

你可以通过群组 ID 而非名称访问群组，地址为 https://gitlab.example.com/-/g/<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. 选择 复制群组 ID。

查看群组活动#

要查看群组活动：

  1. 在顶部栏中，选择 搜索或跳转到 并找到你的群组。

  2. 在左侧边栏中，选择 管理 > 活动。

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

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

创建群组#

要创建群组：

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

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

你可以从群组通用设置中编辑群组详细信息。

先决条件：

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

要编辑群组详细信息：

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

离开群组#

版本历史
  • 离开群组的按钮在极狐GitLab 16.7 移动到操作菜单。

离开群组后：

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

要离开群组：

  1. 在顶部栏中，选择 搜索或跳转到 并找到你的群组。
  2. 在群组概览页面，右上角选择 操作 ()。
  3. 选择 离开群组，然后再次选择 离开群组。

计划删除群组#

版本历史

默认情况下，当你首次删除群组时，它会进入待删除状态。 再次删除群组可立即移除它。

先决条件：

要删除群组及其内容：

  1. 在顶部栏中，选择 搜索或跳转到 并找到你的群组。
  2. 在群组概览页面，右上角选择 操作 ()。
  3. 选择 删除。
  4. 在确认对话框中，输入群组路径并选择 是，删除群组。

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

  1. 在顶部栏中，选择 搜索或跳转到 > 查看我的所有群组。
  2. 选择要删除的群组旁边的 ()。
  3. 选择 删除。
  4. 在确认对话框中，输入群组路径并选择 是，删除群组。

此操作会添加一个后台作业来计划删除群组。在 JihuLab.com 上，群组将在 30 天后删除。在私有化部署实例上， 你可以通过实例设置修改保留期限。

当群组计划删除后，计划的 CI/CD 流水线将停止运行。

如果计划删除群组的用户在删除发生前失去了对群组的访问权限（例如，离开群组、角色被降级或被禁止访问群组）， 则删除作业将改为恢复群组，并且群组不再计划删除。

如果计划删除群组的用户在作业运行前重新获得所有者角色或管理员访问权限，则作业将永久删除该群组。

立即删除群组#

版本历史

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

先决条件：

要永久删除已计划删除的群组：

  1. 在顶部栏中，选择 搜索或跳转到 并找到你的群组。
  2. 在群组概览页面，右上角选择 操作 ()。
  3. 选择 永久删除。
  4. 在确认对话框中，输入群组路径并选择 是，删除群组。

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

恢复群组#

要恢复计划删除的群组：

  1. 在顶部栏中，选择 搜索或跳转到 并找到你的群组。
  2. 在群组概览页面，右上角选择 操作 ()。
  3. 选择 恢复。

使用操作菜单管理群组#

你可以查看所有群组的列表， 并使用 操作 菜单管理它们。

先决条件：

  • 除离开群组外，所有可用操作都需要所有者角色。

要访问群组的 操作 菜单：

  1. 在顶部栏中，选择 搜索或跳转到 > 查看我的所有群组。
  2. 在 群组 页面上，找到你的群组并选择 操作 菜单 ()。
  3. 选择一个操作。

根据群组状态，以下操作可用：

群组状态可用操作
活跃编辑、归档、转移、离开群组、删除
已归档取消归档、离开群组、删除
待删除恢复、离开群组

请求访问群组#

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

  1. 在顶部栏中，选择 搜索或跳转到 > 查看我的所有群组。
  2. 在右上角，选择 探索群组。
  3. 在 搜索 文本框中，输入你想加入的群组名称。
  4. 在搜索结果中，选择群组名称。
  5. 在群组页面上，群组名称下方，选择 请求访问。

最多十位最近活跃的群组所有者会收到包含你请求的电子邮件。 任何群组所有者都可以批准或拒绝该请求。

如果你在请求被批准前改变主意，选择 撤回访问请求。

查看群组成员#

要查看群组成员：

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

表格显示成员的：

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

筛选和排序群组成员#

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

筛选群组#

筛选群组以查找成员。默认显示群组和子群组中的所有成员。

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

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

搜索群组#

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

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

排序群组成员#

你可以按 账号、授予访问权限时间、角色 或 上次登录 排序成员。

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

向群组添加用户#

版本历史
  • 访问过期电子邮件通知在极狐GitLab 16.2 引入。
  • 子群组和项目的直接成员的访问过期日期在极狐GitLab 17.4 移除。

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

先决条件：

  1. 在顶部栏中，选择 搜索或跳转到 并找到你的群组。

  2. 在左侧边栏中，选择 管理 > 成员。

  3. 选择 邀请成员。

  4. 如果用户：

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

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

  6. 可选。对于 访问过期日期，输入或选择一个日期。 从该日期起，用户将无法再访问项目。

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

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

  7. 选择 邀请。 如果你通过以下方式邀请用户：

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

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

查看待审批升级的用户#

如果角色升级的管理员审批已开启，将现有用户提升为计费角色的成员资格请求需要管理员审批。

要查看待审批升级的用户：

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

如果 角色升级 标签页未显示，则群组没有待审批的升级。

从群组中移除成员#

先决条件：

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

要从群组中移除成员：

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

极狐GitLab 管理员还可以确保被移除的用户无法自行重新邀请。

向群组添加项目#

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

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

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

    选择群组

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

默认情况下，至少具有：

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

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

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

有关全局更改此设置的更多信息，请参阅创建项目所需的默认最低角色。