群组

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

您可以使用群组来管理项目的权限。如果某人有权访问该群组，则他们可以访问该群组中的所有项目。

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

您可以使用群组同时与群组的所有成员进行通信。

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

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

群组层次结构

群组以树形结构进行组织：

  • 一个创建在组织 “root” 上的 顶级群组。一个组织可以有一个或多个顶级群组。一个顶级群组可以包含一个或多个子群组。
  • 一个 父群组 是一个包含一个或多个子群组的群组。
  • 一个 子群组 是另一个群组的一部分。

比如，在下面的图表中：

  • 组织有四个群组：一个顶级群组（T），它包含一个子群组（G），和两个在 G 中的子群组（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

群组结构

群组的设置取决于您自身的情况、团队规模以及访问要求。下表描述了最常见的群组结构。

模型 结构 用例
简单 所有项目一个群组。 针对小团队或需要无缝协作和资源访问的特定解决方案（例如，营销网站）。
团队 不同的团队类型（比如，产品和工程）具有不同的群组或子群组。 在一个大型组织中开展工作，其中一些团队自主运作，而另一些团队则需要集中化的资源，并且外部团队成员对其的访问权限有限。
客户 每个客户一个群组。 为需要不同资源和访问权限的多个客户提供自定义解决方案。
功能性 每个功能类型（比如 AI/ML，一个群组或子群组。 开发复杂的产品，其中某一项功能需要特定的资源以及各领域专家之间的协作。
note 在私有化部署实例上，如果您想要查看整个组织的概览，您应该创建一个顶级群组。顶级群组通过一个完整的安全仪表盘和中心、漏洞报告、合规中心和价值流分析查看整个组织。

群组可见性

与项目一样，群组可以配置为将其可见性限制为：

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

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

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

查看群组

要查看所有公共群组：

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

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

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

此页面显示您所属的群组：

  • 您拥有子组的父组的成员资格。
  • 您拥有群组或子组中项目的直接或继承成员身份。

查看单个群组

群组概览页面会展示群组和其成员、子群组、和项目的相关信息，诸如：

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

要查看当群组：

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

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

查看群组活动

要查看项目的活动：

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

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

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

通过群组 ID 访问群组

  • 引入于极狐GitLab 17.5 版本。

您可以通过群组的 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. 可选。要邀请成员到群组中，在 Email 1 文本框中输入成员的电子邮件地址。要邀请更多成员，请选择 邀请另一个成员 并输入成员的电子邮件地址。
  8. 选择 创建群组。

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

您可以从群组通用设置中编辑您的群组详情。

先决条件：

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

要编辑群组详情：

  1. 在左侧导航栏，选择 搜索或转到 并找到您的群组。
  2. 选择 设置 > 通用。
  3. 在 群组名称 文本框中输入群组的名称。有关不能用作群组名称的单词列表，请参阅保留名称。
  4. 可选。在 群组描述 文本框中输入群组的描述。该描述限制为 500 个字符。
  5. 可选。在 群组头像 中选择 选择文件 并选择图像。理想图像尺寸为 192 x 192 像素，允许的最大文件大小为 200 KB。
  6. 选择 保存更改。

离开群组

  • 离开群组的按钮已从 GitLab 16.7 移动到操作菜单中。

当您离开一个群组时：

  • 您不再是群组、子群组和项目的成员，也无法参与贡献。
  • 所有分配给您的问题和合并请求都会取消分配。

要离开群组：

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

移除群组

  • 默认启用延迟删除，并在 JihuLab.com 和私有化部署实例上移除”立即删除”的选项于极狐GitLab 16.0。

移除群组及其内容：

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

也可以从群组仪表盘中移除群组：

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

此操作会移除群组，此外还添加了一个后台作业来删除群中的所有项目。

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

如果设置删除的用户在删除发生之前从群组中删除，则该作业会取消，并且不再计划删除该群组。

caution 如果安排了删除群组操作的用户在删除任务运行之前重新获得了所有者角色或管理员权限，那么该任务将永久性地删除该群组。

查看等待删除的群组

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

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

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

立即删除群组

  • 默认启用延迟删除，并在 JihuLab.com 和私有化部署实例上移除”立即删除”的选项于极狐GitLab 16.0。

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

先决条件：

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

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

您的群组、其子组、项目和所有相关资源，包括议题和合并请求，都会被删除。

恢复群组

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

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

请求访问群组

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

  1. 在左侧边栏中，选择 搜索或转到。
  2. 选择 查看我的所有群组。
  3. 在右上角，选择 浏览群组。
  4. 按名称搜索群组。
  5. 在搜索结果中，选择群组名称。
  6. 在群组页面的群组名称下，选择 请求访问。

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

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

查看群组成员

要查看群组的成员：

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

表格显示成员的：

  • 账户名称和用户名。
  • 他们的会员资格的来源。 为了透明起见，极狐GitLab 显示群组成员的所有成员资格来源。 具有多个成员资格来源的成员将显示并计为单独的成员。 例如，如果已直接或通过继承的方式将成员添加到群组中，则该成员会在 成员 表格中显示两次（具有不同的来源），并被计为该群组的两个单独成员。
  • 群组中的最大角色。
  • 群组会员资格的 到期 日期。
  • 与其账户相关的 活动。
note 群组成员的 来源 可能会不一致。

表格展示成员的：

  • 帐号 的名称和用户名。
  • 成员关系的 来源。对于透明性来讲，极狐GitLab 会展示群组成员的所有成员关系来源。拥有多种成员身份来源的成员会被分别显示，并作为独立的成员进行计数。比如，如果已直接或通过继承的方式将成员添加到群组中，则该成员会在 成员 表格中显示两次（具有不同的来源），并被计为该群组的两个单独成员。
  • 群组中的角色。
  • 群组成员关系的 过期 日期。
  • 与帐号相关联的 活动。
note 群组成员 来源 的显示可能会不一致。

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

在群组中筛选并为成员排序

要查找群组中的成员，您可以排序、过滤或搜索。

过滤群组

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

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

  • SAML，表示成员有一个与其连接的 SAML 账户。
  • 企业，表示该成员是企业用户。
  1. 在左侧边栏中，选择 搜索或转到 并找到您的群组。
  2. 选择 管理 > 成员。
  3. 在成员列表上方的 筛选成员 框中，输入筛选条件。
    • 要仅查看群组中的成员，请选择 成员资格 = 直接。
    • 要查看群组及其子组的成员，请选择 成员资格 = 继承。
    • 要查看启用或禁用双因素身份验证的成员，请选择 2FA = 启用 或 禁用。
    • 查看由 SAML SSO 或 SCIM 配置创建的极狐GitLab 用户，请选择 企业 = 真。

在群组中搜索

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

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

对群组中的成员进行排序

您可以按 账户、授予的访问权限、最大角色 或 上次登录 对成员进行排序。

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

将用户添加到群组中

  • 过期访问电子邮件通知引入于极狐GitLab 16.2。
  • 对于子群组和项目的访问过期日期在极狐GitLab 17.4 中被移除。

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

先决条件：

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

  4. 如果用户：

    • 有极狐GitLab 帐号，请输入用户的用户名。
    • 没有极狐GitLab 帐号，请输入用户的电子邮件地址。
  5. 选择一个 默认角色 或 自定义角色。

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

    如果您输入了一个访问过期日期，群组成员会在访问过期前七天接收电子邮件通知。

    caution 维护者具有所有的权限直到他们的角色过期，包括扩展自己的访问过期日期的能力。

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

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

未自动添加的用户将展示在 邀请的 选项卡中。此选项卡包括用户这些用户：

查看等待提升的用户

如果启用了管理员审批角色提升，成员请求将提升现有用户到可计费角色需要管理员批准。

要查看等待提升的用户：

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

如果 角色提升 选项卡未显示，则群组没有等待提升的用户。

从群组移除成员

先决条件：

  • 您必须具有所有者角色。
  • 成员必须是群组的直接成员。如果成员资格是从父群组继承的，则仅可以从父群组中移除该成员。

要从群组中移除成员：

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

将项目添加到群组中

有两种不同的方法可以将新项目添加到群组中：

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

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

    Select group

指定可以将项目添加到群组中的人员

默认情况下：

  • 至少具有开发者角色的用户可以在群组下创建项目。可以更改此默认值。
  • 至少具有维护者角色的用户可以将项目派生到一个群组中。此默认设置可防止具有开发者角色的用户分叉包含受保护分支并且不能更改的项目。

要更改可以在群组下创建项目的角色：

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

要全局更改此设置，请参阅默认项目创建保护。