管理群组

使用群组同时管理一个或多个相关项目。

note 在私有化部署实例上,如果您想看整个组织的概览,您应该创建一个顶级群组。顶级群组通过安全仪表盘和中心漏洞报告合规中心价值流分析来提供整个组织的完整洞察。

添加群组 README

您可以通过添加 README 文件来提供关于您的团队的信息并邀请用户参与您的项目。README 文件显示在群组概览页面上。所有群组成员都可以查看和编辑 README。

先决条件:

  • 要从群组设置创建 README,您必须拥有群组的所有者角色。

要添加群组 README:

  1. 在左侧边栏中,选择 搜索或转到 > 查看我的所有群组
  2. 选择 设置 > 通用
  3. 群组 README 部分,选择 添加 README。此操作创建一个新项目 gitlab-profile,其中包含 README.md 文件。
  4. 在创建 README 的提示中,选择 创建并添加 README。您将被重定向到 Web IDE,其中创建 README 文件。
  5. 在 Web IDE 中,编辑并提交 README.md 文件。

更改群组的所有者

您可以更改群组的所有者。每个群组必须始终至少有一个具有所有者角色的成员。

  • 作为管理员:
    1. 在左侧导航栏,选择 搜索或转到 > 查看我的所有群组
    2. 选择 管理 > 成员
    3. 给其他成员分配所有者角色。
    4. 刷新页面。现在您可以从原来的所有者中移除所有者角色。
  • 作为当前群组的所有者:
    1. 在左侧导航栏,选择 搜索或转到 > 查看我的所有群组
    2. 选择 管理 > 成员
    3. 给其他成员分配所有者角色。
    4. 用新的所有者登录并从自身中移除所有者角色。

更改群组的路径

更改群组的路径(群组 UIR)可能会产生意想不到的副作用。在您继续之前,请阅读项目API中的重定向行为。

如果您正在修改路径,所以(路径)可以由其他群组或用户来声明,您也必须重命名群组。但是名称和路径必须唯一。

要保留原先命名空间的成员关系并保护 URL 重定向,您必须创建一个新群组并转移项目到新群组。

要更改您的群组路径(群组 URL):

  1. 在左侧边栏中,选择 搜索或转到 并找到您的群组。
  2. 选择 设置 > 通用
  3. 展开 高级 部分。
  4. 更改群组 URL 下,输入新名称。
  5. 选择 更改群组 URL
caution 如果命名空间包含带有 Container Registry 标签的项目,则无法重命名命名空间,因为该项目无法移动。
caution 为了保证具有数千子群组的群组能够被正确处理,您应该在测试环境中测试路径更改。考虑临时增加 Puma 工作线程超时时间

更改群组的默认分支保护

默认情况下,每个群组会继承设置在全局级别的分支保护设置。

要更改特定群组的设置,查看群组级别的默认分支保护

要全局更改此设置,查看初始化默认分支保护

note 在极狐GitLab 专业版和旗舰版中中,极狐GitLab 管理员可以选择从更新默认分支保护中禁用群组所有者

为初始化分支使用自定义名称

当您在极狐GitLab 中创建新项目时,默认分支会随着首次推送而创建。群组所有者可以为群组的项目自定义初始化分支以满足群组的需求。

转移群组

转移群组将他们从一个位置移动到另一个位置(同一个实例)。您可以:

  • 转移子群组到新的父群组。
  • 通过将顶级群组转换到期望的群组,将其转换为子群组。
  • 通过将顶级群组转移到当前群组之外,将其转换为子群组。

如果您需要拷贝群组到不同的极狐GitLab 实例,通过直接转移来迁移群组

当转移群组时,注意:

  • 修改群组的父级可能会带来意外的副作用。查看当仓库路径更改时发生了什么
  • 您必须具有源和目标群组的所有者角色。
  • 您必须更新本地仓库以指向新位置。
  • 如果直接上级群组的可见性低于该群组当前的可见性,则子群组和项目的可见性会随之改变以匹配新的父群组的可见性。
  • 只有明确的群组成员身份会被转移,不包括继承的成员关系。如果该群组的所有者只是通过继承获得成员身份,那么这会导致该群组没有所有者。在这种情况下,转移群组的用户会变成群组的所有者。
  • 如果该群组是一个顶级群组,且在该群组的任何项目中或其任何子群组中存在遵循命名约定npm 软件包,那么转移操作将会失败。
  • 归档项目中的 container_registry 镜像必须在转移之前被删除。更多详情,可查阅故障排除
  • 使用群组级别端点的既有软件有(Maven, NuGet, PyPI, Composer, and Debian)需要按照该软件包设置群组级别端点的步骤进行更新。
  • 如果软件包使用实例级别的端点(MavennpmConan),则需要更新既有软件包的名称,而且群组要被移动到另外一个顶级群组。
  • 在 JihuLab.com 上有订阅的顶级群组无法被转移。要想转移,则首先要移除顶级群组的订阅。然后顶级群组可以被当作子群组转移到其他顶级群组。

要转移群组:

  1. 在导航栏左侧,选择 搜索或前往 并找到您的群组。
  2. 选择 设置 > 通用
  3. 展开 高级 部分。
  4. 选择 转移群组
  5. 从下拉菜单中选择目标群组。
  6. 选择 转移群组

禁用邮件通知

您可以禁用与群组相关的邮件通知,包括群组、子群组和项目。

要禁用邮件通知:

  1. 在左侧导航栏,选择 搜索或前往 并找到您的群组。
  2. 选择 设置 > 通用
  3. 展开 权限和群组功能 部分。
  4. 清除 启用邮件通知 复选框。

在邮件通知中禁用差异预览

  • 引入于极狐GitLab 15.6,使用名为 diff_preview_in_email 的功能标志,默认禁用。
  • 在极狐GitLab 17.1 中,在 JihuLab.com 和私有化部署实例上启用功能标志 diff_preview_in_email
功能标志控制此功能的可用性。更多详情,可以查看历史。

当您在合并请求的代码上添加评论时,极狐GitLab 会将差异预览包含在邮件通知中。有些组织策略将邮件视为不安全的系统,或者无法控制自己的邮件基础设施。这可能会对 IP 或源代码的访问控制造成风险。

先决条件:

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

要为群组中的所有项目禁用差异预览:

  1. 在左侧导航栏,选择 搜索或前往 并找到您的群组。
  2. 选择 设置 > 通用
  3. 展开 权限和群组功能 部分。
  4. 清除 包含差异预览 复选框。
  5. 选择 保存更改

禁用群组提及

当有人提及某个群组时,你可以阻止这些用户被添加到对话中,并且不让他们收到通知。

提及功能已被禁用的群组会在自动补全下拉列表中以相应的方式显示出来。

这些视觉提示对于拥有众多用户的群组来说特别有帮助。

要禁用群组提及:

  1. 在左侧导航栏,选择 搜索或前往 并找到您的群组。
  2. 选择 设置 > 通用
  3. 展开 权限和群组功能 部分。
  4. 选择 禁用群组提及
  5. 选择 保存更改

导出成员到 CSV

您可以将群组或子群组中的成员列表导出为 CSV:

  1. 在左侧导航栏,选择 搜索或前往 并找到您的群组或子群组。
  2. 选择 管理 > 成员
  3. 选择 导出为 CSV
  4. CSV 文件生成后,会以附件的形式发送到请求者邮箱。

输出列表会列出直接成员和继承自祖先群组的成员。对于在所选群组中拥有 Minimal Access 的成员,其 Max RoleSource 会从其在子群组中的成员身份推导而来。

群组的用户容量

  • 在极狐GitLab 16.3 中为 JihuLab.com 启用。
  • 在极狐GitLab 17.1 中 GA。功能标志 saas_user_caps 被移除。

关于私有化部署实例用户容量的更多详情,可以查看用户容量

当付费用户数量超过用户容量时,群组所有者必须审批新用户。

启用了用户上限功能的群组,其自身及其子群组的群组共享功能将被禁用。

为群组指定用户容量

先决条件:

  • 您必须被分配为群组的所有者。

要指定用户容量:

  1. 在左侧导航栏,选择 搜索或前往 并找到您的群组。您可以仅在顶级群组设置容量。
  2. 选择 设置 > 通用
  3. 展开 权限和群组功能 部分。
  4. 席位控制 中,选择 设置用户容量 勾选亮并属于用户数量。
  5. 选择 保存更改

如果群组中的用户已经超过了用户容量的值,用户不会被移除,但你您也无法在不通过审核的情况下添加用户。

增加用户容量并不会审核等待成员。

Remove the user cap for a group

您可以移除用户容量,这样就不会对添加到群组中的用户数量有任何限制。

先决条件:

  • 您必须被指派为群组的所有者角色。

要移除用户容量:

  1. 在左侧导航栏,选择 搜索或前往 并找到您的群组。
  2. 选择 设置 > 通用
  3. 展开 权限和群组功能 部分。
  4. 席位控制 中,选择 打开访问
  5. 选择 保存更改

减少用户容量不会审核等待成员。

为群组审批等待成员

当付费用户达到用户容量设置时,任何新成员都会被置于待审批状态,必须被审批。

等待成员不能被视为付费用户。成员只有在被审批后才能被视为付费用户。

先决条件:

  • 您必须被指派为群组的所有者角色。

要审批因为超过用户容量之后而成为等待状态的成员:

  1. 在左侧导航栏,选择 搜索或前往 并找到您的群组。
  2. 选择 设置 > 使用量配额
  3. 席位 标签下,点击 查看待审批
  4. 对于每一个您想要批准的成员,选择 批准

已知问题

如果群组、子群组或项目被外部共享,用户容量将无法启用。如果群组、子群组或项目被外部共享,它将被共享在命名空间层次结构之外,无论它在层次结构中的位置如何。

当群组、子群组或项目被外部共享时,要确保用户容量生效,必须限制群组共享仅在顶层命名空间。顶层命名空间限制允许同一命名空间中的邀请,并阻止来自外部共享的新用户(席位)添加。

群组文件模板

使用群组模板来为群组中的每个项目共享一系列模板。它与实例模板仓库类似。所选的项目应该遵循相同的命名约定。

您只能将群组中的项目选为模板源。这包括群组中的共享项目,但是它会 排除 掉子群组和父群组中的项目。

您可以同时为子群组和直接父群组配置此功能。子群组中的项目可以访问其子群组和直接父群组的模板。

学习如何为议题和合并请求创建模板,可以查看描述模板

通过将群组设置为模板源来在群组级别定义项目模板。更多详情,可以查阅群组级别项目模板

启用群组文件模板

要启用群组文件模板:

  1. 在左侧导航栏,选择 搜索或前往 并找到您的群组。
  2. 选择 设置 > 通用
  3. 展开 模板 部分。
  4. 选择一个项目作为模板仓库。
  5. 选择 保存更改

群组合并检查设置

  • 引入于极狐GitLab 15.9,使用名为 support_group_level_merge_checks_setting 的标志。默认禁用。
  • 在极狐GitLab 16.9 中 GA。功能标志 support_group_level_merge_checks_setting 被移除。

群组所有者可以在顶级群组上设置合并请求检查,这些设置将应用于所有子群组和项目。

如果设置继承自父群组或项目,那么子群组或项目将无法更改继承的设置。

为合并要求成功的流水线

您可以为群组中的所有子项目进行配置,要求在合并请求之前必须完成并流水线运行成功。

您还可以查看项目级别设置

先决条件:

  • 您必须是群组的所有者

要启用此设置:

  1. 在左侧导航栏,选择 搜索或前往 并找到您的群组。
  2. 选择 设置 > 通用.
  3. 展开 合并请求 部分。
  4. 合并检查 下,选择 流水线必须成功。如果没有流水线,则此设置会阻止合并请求被合并。
  5. 选择 保存更改

允许跳过流水线合并

您可以配置跳过流水线来合并请求。

还可以查看项目级别设置

先决条件:

  • 您必须是群组的所有者

要更改此行为:

  1. 在左侧导航栏,选择 搜索或前往 并找到您的群组。
  2. 选择 设置 > 通用.
  3. 展开 合并请求审核 部分。
  4. 合并检查 下,
    • 选择 流水线必须成功
    • 选择 跳过的流水线被视为成功
  5. 选择 保存更改

阻止合并直到所有的线程被解决

您可以阻止合并请求被合并直到所有的线程被解决。当启用此设置时,在你所在群组的子项目中,对于那些至少存在一个未解决讨论线程的合并请求,未解决讨论线程的数量会以橙色显示。

先决条件:

  • 您必须是群组的所有者。

要启用此设置:

  1. 在左侧导航栏,选择 搜索或前往 并找到您的群组。
  2. 选择 设置 > 通用.
  3. 展开 合并请求审核 部分。
  4. 合并检查 下,选择 所有线程必须解决
  5. 选择 保存更改

群组合并请求审核设置

群组审核设置为顶级群组中的所有项目管理项目合并请求审核设置。这些设置会级联所有属于群组的项目

要查看群组的合并请求审核设置:

  1. 在左侧导航栏,选择 搜索或前往 并找到您的群组。
  2. 选择 设置 > 通用.
  3. 展开 合并请求审核 部分。
  4. 选择您想要的设置。
  5. 选择 保存更改

不应将审核设置和审批规则

群组活动分析

对于一个群组,您可以查看在最近90天内创建了多少合并请求、议题和成员。

更改到群组 wiki不会出现在群组活动分析中。

查看群组活动

您可以查看在群组中最近采取的操作,或者在您的浏览器或 RSS 反馈中查看:

  1. 在左侧导航栏,选择 搜索或前往 并找到您的群组。
  2. 选择 管理 > 分析

要以原子格式查看活动反馈,选择 RSS )图标。