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

{{< alert type=”note” >}}

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

{{< /alert >}}

添加群组 README

您可以添加一个 README 文件，以提供关于您的团队的信息并邀请用户为您的项目做贡献。README 显示在群组概览页面上。所有群组成员都可以查看和编辑 README。

先决条件：

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

要添加群组 README：

  1. 在左侧边栏，选择 搜索或前往 并找到您的群组。
  2. 选择 设置 > 常规。
  3. 在 群组 README 部分，选择 添加 README。此操作将创建一个包含 README.md 文件的新项目 gitlab-profile。
  4. 在创建 README 的提示中，选择 创建并添加 README。您将被重定向到 Web IDE，在那里创建一个 README 文件。
  5. 在 Web IDE 中，编辑并提交 README.md 文件。

更改群组的拥有者

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

  • 作为管理员：
    1. 在左侧边栏，选择 搜索或前往 并找到您的群组。
    2. 选择 管理 > 成员。
    3. 给其他成员赋予 拥有者 角色。
    4. 刷新页面。您现在可以从原始拥有者中移除 拥有者 角色。
  • 作为当前群组的拥有者：
    1. 在左侧边栏，选择 搜索或前往 并找到您的群组。
    2. 选择 管理 > 成员。
    3. 给其他成员赋予 拥有者 角色。
    4. 让新的拥有者登录并从您那里移除 拥有者 角色。

更改群组的路径

更改群组的路径（群组 URL）可能会产生意外的副作用。在继续之前，请阅读 项目 和 API 中重定向的行为。

如果您正在更改路径以便其他群组或用户可以声明它，您还必须重命名群组。名称和路径都必须是唯一的。

为了保留原始命名空间的所有权并保护 URL 重定向，请创建一个新群组并将项目转移到该群组。

要更改群组路径（群组 URL）：

  1. 在左侧边栏，选择 搜索或前往 并找到您的群组。
  2. 选择 设置 > 常规。
  3. 展开 高级 部分。
  4. 在 更改群组 URL 下输入新名称。
  5. 选择 更改群组 URL。

{{< alert type=”warning” >}}

如果命名空间中包含带有 容器注册表 标签的项目，则无法重命名命名空间，因为项目无法移动。

{{< /alert >}}

{{< alert type=”warning” >}}

为了确保拥有数千个子群组的群组能够正确处理，您应该在测试环境中测试路径更改。考虑临时增加 Puma 工作者超时。

{{< /alert >}}

更改群组的默认分支保护

极狐GitLab 实例的管理员可以配置 实例中所有项目 的默认分支保护。该实例中的群组继承在全局级别设置的分支保护。群组拥有者可以为群组中的项目 覆盖实例设置。在 极狐GitLab 专业版或旗舰版 中，实例的管理员可以禁用此权限。

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

当您在极狐GitLab 中创建新项目时，默认分支会在第一次推送时创建。群组拥有者可以为群组的项目 自定义初始分支 以满足您的群组需求。

转移群组

转移群组会将它们从极狐GitLab 实例中的一个地方移动到另一个地方。您可以：

  • 将子群组转移到新的父群组。
  • 通过将顶级群组转移到所需群组，将其转换为子群组。
  • 通过将子群组从其当前群组中转移出来，将其转换为顶级群组。

如果您需要将群组复制到不同的极狐GitLab 实例，请通过直接转移 迁移群组。

转移群组时请注意：

  • 更改群组的父级可能会产生意外的副作用。请参阅 仓库路径更改时发生了什么。
  • 您必须更新本地仓库以指向新位置。
  • 如果直接父群组的可见性低于群组当前的可见性，则子群组和项目的可见性级别会更改为匹配新的父群组的可见性。
  • 只有显式群组成员资格会被转移，而不是继承的成员资格。如果群组的拥有者只有继承的成员资格，这将导致群组没有拥有者。在这种情况下，转移群组的用户将成为群组的拥有者。
  • 如果群组是顶级群组并且在群组中的任何项目或任何子群组中存在遵循 命名约定 的 npm 软件包，则转移失败。
  • 必须在转移前删除已归档项目中的 container_registry 镜像。有关更多信息，请参阅 故障排除部分。
  • 使用群组级端点（Maven、NuGet、PyPI、Composer 和 Debian）的现有软件包需要根据软件包设置群组级端点的步骤进行更新。
  • 如果软件包使用实例级端点 (Maven、npm、Conan) 并且群组被移动到另一个顶级群组，则需要更新现有软件包名称。
  • 在 JihuLab.com 上订阅的顶级群组无法转移。为了使转移成为可能，必须首先删除顶级群组的订阅。然后顶级群组可以作为子群组转移到另一个顶级群组。

先决条件：

  • 您必须拥有源群组和目标群组的 拥有者 角色。

要转移群组：

  1. 在左侧边栏，选择 搜索或前往 并找到您的群组。
  2. 选择 设置 > 常规。
  3. 展开 高级 部分。
  4. 选择 转移群组。
  5. 在下拉菜单中选择群组名称。
  6. 选择 转移群组。

禁用电子邮件通知

您可以禁用与群组相关的所有电子邮件通知，包括其子群组和项目。

要禁用电子邮件通知：

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

禁用电子邮件通知中的差异预览

{{< history >}}

  • 在极狐GitLab 15.6 引入，使用名为 diff_preview_in_email 的功能标志。默认情况下禁用。
  • 在极狐GitLab 17.1 中 GA。功能标志 diff_preview_in_email 被移除。

{{< /history >}}

当您在合并请求中评论代码时，极狐GitLab 会在电子邮件通知中包含几行差异以发送给参与者。一些组织政策将电子邮件视为不太安全的系统，或者可能无法控制其电子邮件基础设施。这可能会对 IP 或源代码的访问控制构成风险。

先决条件：

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

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

  1. 在左侧边栏，选择 搜索或前往 并找到您的群组。
  2. 选择 设置 > 常规。
  3. 展开 权限和群组功能。
  4. 清除 包含差异预览。
  5. 选择 保存更改。

群组和项目访问令牌的过期电子邮件

{{< history >}}

  • 在极狐GitLab 17.7 中引入对继承的群组成员的通知，使用名为 pat_expiry_inherited_members_notification 的功能标志。默认禁用。
  • 功能标志 pat_expiry_inherited_members_notification 在极狐GitLab 17.10 中默认启用。
  • 极狐GitLab 17.11 中功能标志 pat_expiry_inherited_members_notification 被移除。

{{< /history >}}

以下群组和项目成员会收到关于即将过期的访问令牌的通知电子邮件：

  • 对于群组访问令牌：
    • 拥有 拥有者 角色的成员。
    • 在极狐GitLab 17.7 及更高版本中，如果该群组或其父群组配置了适当的设置，则继承该群组的 拥有者 角色的成员。
  • 对于项目访问令牌：
    • 项目的成员至少拥有 维护者 角色。
    • 在极狐GitLab 17.7 及更高版本中，如果该项目属于群组并且该群组或其父群组配置了适当的设置，则由于项目属于群组而继承 拥有者 或 维护者 角色的项目成员。

您可以启用对群组继承成员的通知：

  1. 在左侧边栏，选择 搜索或前往 并找到您的群组。
  2. 选择 设置 > 常规。
  3. 展开 权限和群组功能。
  4. 在 群组和项目访问令牌过期通知电子邮件应发送给： 下，选择 群组或项目的所有直接和继承成员。
  5. 可选。选中 对所有子群组强制执行 复选框。
  6. 选择 保存更改。

有关更多信息，请参阅：

添加额外的 Webhook 触发器以处理群组访问令牌过期

{{< history >}}

  • 在极狐GitLab 17.9 中添加了 60 天和 30 天触发器到项目和群组访问令牌 Webhook，使用名为 pat_expiry_inherited_members_notification 的功能标志。默认禁用。
  • 极狐GitLab 17.11 中功能标志 pat_expiry_inherited_members_notification 被移除。

{{< /history >}}

极狐GitLab 在群组令牌过期之前发送多个 过期电子邮件 并触发相关的 Webhook。默认情况下，极狐GitLab 仅在令牌过期前 7 天触发这些 Webhook。当启用此功能时，极狐GitLab 还可以在令牌过期前 60 天和 30 天触发这些 Webhook。

要为这些 Webhook 启用额外的触发器：

  1. 在左侧边栏，选择 搜索或前往 并找到您的群组。
  2. 选择 设置 > 常规。
  3. 展开 权限和群组功能 部分。
  4. 选中 扩展群组访问令牌过期 Webhook 执行 复选框。
  5. 选择 保存更改。

禁用群组提及

您可以防止用户在对话中被添加并在任何人 提及群组 中时收到通知。

禁用提及的群组在自动完成下拉列表中以相应方式显示。

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

要禁用群组提及：

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

将成员导出为 CSV

{{< details >}}

  • 层级：专业版，旗舰版
  • 提供：JihuLab.com，私有化部署

{{< /details >}}

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

  1. 在左侧边栏，选择 搜索或前往 并找到您的群组或子群组。
  2. 选择 管理 > 成员。
  3. 选择 导出为 CSV。
  4. 生成 CSV 文件后，它会作为附件通过电子邮件发送给请求的用户。

输出列出直接成员和从祖先群组继承的成员。对于在选定群组中具有 最小访问 的成员，其 最大角色 和 来源 是从其在子群组中的成员资格派生的。

启用受限访问

{{< details >}}

  • 层级：专业版，旗舰版
  • 提供：JihuLab.com
  • 状态：Beta

{{< /details >}}

{{< history >}}

  • 在极狐GitLab 17.5 中引入。

{{< /history >}}

使用受限访问来防止超额费用。当您超过订阅中的席位数量时，会产生超额费用，并且必须在下一个 季度对账 时支付。

启用受限访问后，群组无法在订阅中没有剩余席位时添加新的计费用户。

{{< alert type=”note” >}}

如果群组启用了 用户上限 并且有待处理成员，则启用受限访问时所有待处理成员将自动从群组中移除。

{{< /alert >}}

先决条件：

  • 您必须拥有群组的 拥有者 角色。
  • 群组或其子群组或项目不得在外部共享。

要启用受限访问：

  1. 在左侧边栏，选择 设置 > 常规。
  2. 展开 权限和群组功能。
  3. 在 席位控制 下，选择 受限访问。

已知问题

启用受限访问时，可能会出现以下已知问题并导致超额：

  • 如果您通过 SAML 或 SCIM 添加新成员，并且已超出订阅中的席位数量，仍然可以超过席位数量。
  • 如果多个拥有 拥有者 角色的用户同时添加成员，仍然可以超过席位数量。
  • 如果新的计费成员延迟接受邀请，仍然可以超过席位数量。
  • 如果您从使用用户上限更改为受限访问，并且在更改为受限访问之前有待批准的成员，则这些成员将保持待处理状态。如果在使用受限访问时批准待处理成员，您可能会超过订阅中的席位数量。
  • 如果您通过极狐GitLab 销售团队续订订阅的用户数量少于当前订阅的用户数量，您将产生超额费用。为避免此费用，请在续订开始前删除额外用户。例如，如果您有 20 名用户并续订订阅 15 名用户，则将为额外的 5 名用户收取超额费用。

此外，受限访问可能会阻止标准非超额流程：

  • 更新或添加到计费角色的服务机器人被错误地阻止。
  • 通过电子邮件邀请或更新现有计费用户意外被阻止。

群组的用户上限

{{< history >}}

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

{{< /history >}}

有关极狐GitLab 私有化部署的用户上限的更多信息，请参阅 用户上限。

当计费成员数量达到用户上限时，群组拥有者必须批准新成员。

启用了用户上限功能的群组会禁用群组及其子群组的 群组共享。

指定群组的用户上限

先决条件：

  • 您必须被分配群组的 拥有者 角色。

要指定用户上限：

  1. 在左侧边栏，选择 搜索或前往 并找到您的群组。您只能在顶级群组上设置上限。
  2. 选择 设置 > 常规。
  3. 展开 权限和群组功能。
  4. 从 席位控制 中，选择 设置用户上限 复选框并在字段中输入用户数量。
  5. 选择 保存更改。

如果群组中已有比用户上限值更多的用户，则不会删除用户。但是，未经批准您无法添加更多用户。

增加用户上限不会批准待处理成员。

移除群组的用户上限

您可以移除用户上限，因此您可以为群组添加任意数量的成员。

先决条件：

  • 您必须被分配群组的 拥有者 角色。

要移除用户上限：

  1. 在左侧边栏，选择 搜索或前往 并找到您的群组。
  2. 选择 设置 > 常规。
  3. 展开 权限和群组功能。
  4. 从 席位控制 中，选择 开放访问。
  5. 选择 保存更改。

减少用户上限不会批准待处理成员。

批准群组的待处理成员

当计费用户数量达到用户上限时，任何新成员都会处于待处理状态并需要批准。

待处理成员不计入计费。只有在成员被批准且不再处于待处理状态后才计入计费。

先决条件：

  • 您必须被分配群组的 拥有者 角色。

要批准因超过用户上限而待处理的成员：

  1. 在左侧边栏，选择 搜索或前往 并找到您的群组。
  2. 选择 设置 > 使用配额。
  3. 在 席位 选项卡上，在警报下，选择 查看待批准。
  4. 对于您想批准的每个成员，选择 批准。

已知问题

如果群组、子群组或项目在外部共享，则无法启用用户上限。如果群组、子群组或项目在外部共享，则它在命名空间层次结构之外共享，无论其在层次结构中的级别如何。

为了确保在群组、子群组或项目在外部共享时适用用户上限，请仅在顶级命名空间中限制群组共享。顶级命名空间限制允许在同一命名空间中邀请，并防止来自外部共享的新用户（席位）添加。

群组文件模板

{{< details >}}

  • 层级：专业版，旗舰版
  • 提供：JihuLab.com，私有化部署

{{< /details >}}

使用群组文件模板与群组中的每个项目共享一组常用文件类型的模板。它类似于 实例模板仓库。所选项目应遵循该页面上记录的相同命名约定。

您只能选择群组中的项目作为模板源。这包括与群组共享的项目，但 不包括 子群组或群组正在配置的父群组中的项目。

您可以为子群组和直接父群组配置此功能。子群组中的项目可以访问该子群组及任何直接父群组的模板。

要了解如何为议题和合并请求创建模板，请参阅 描述模板。

通过设置群组作为模板源，在群组级别定义项目模板。有关更多信息，请参阅群组级项目模板。

启用群组文件模板

{{< details >}}

  • 层级：专业版，旗舰版
  • 提供：JihuLab.com，私有化部署

{{< /details >}}

要启用群组文件模板：

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

群组合并检查设置

{{< details >}}

  • 层级：专业版，旗舰版
  • 提供：JihuLab.com，私有化部署

{{< /details >}}

{{< history >}}

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

{{< /history >}}

群组拥有者可以在顶级群组上设置合并请求检查，适用于所有子群组和项目。

如果设置被子群组或项目继承，则无法在继承它们的子群组或项目中更改。

要求成功的流水线才能合并

您可以配置群组中的所有子项目，以要求在合并之前完成并成功的流水线。

另请参阅 项目级别设置。

先决条件：

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

要启用此设置：

  1. 在左侧边栏，选择 搜索或前往 并找到您的群组。
  2. 选择 设置 > 常规。
  3. 展开 合并请求。
  4. 在 合并检查 下，选择 流水线必须成功。此设置还会阻止在没有流水线的情况下合并合并请求。
  5. 选择 保存更改。

允许在跳过流水线后合并

您可以配置 跳过的流水线 以阻止合并请求合并。

另请参阅 项目级别设置。

先决条件：

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

要更改此行为：

  1. 在左侧边栏，选择 搜索或前往 并找到您的群组。
  2. 选择 设置 > 常规。
  3. 展开 合并请求。
  4. 在 合并检查 下：
    • 选择 流水线必须成功。
    • 选择 跳过的流水线被视为成功。
  5. 选择 保存更改。

阻止合并，除非所有线程已解决

您可以阻止合并请求被合并，直到所有线程都已解决。当启用此设置时，您群组中的子项目会在具有至少一个未解决线程的合并请求上以橙色显示未解决线程计数。

先决条件：

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

要启用此设置：

  1. 在左侧边栏，选择 搜索或前往 并找到您的群组。
  2. 选择 设置 > 常规。
  3. 展开 合并请求。
  4. 在 合并检查 下，选择 所有线程必须解决。
  5. 选择 保存更改。

群组合并请求审批设置

{{< details >}}

  • 层级：专业版，旗舰版
  • 提供：JihuLab.com，极狐GitLab 私有化部署，极狐GitLab 专属

{{< /details >}}

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

要查看群组的合并请求审批设置：

  1. 在左侧边栏，选择 搜索或前往 并找到您的群组。
  2. 选择 设置 > 常规。
  3. 展开 合并请求审批 部分。
  4. 选择您想要的设置。
  5. 选择 保存更改。

审批设置不应与 审批规则 混淆。

群组活动分析

{{< details >}}

  • 层级：专业版，旗舰版
  • 提供：JihuLab.com，极狐GitLab 私有化部署，极狐GitLab 专属

{{< /details >}}

对于群组，您可以查看在过去 90 天内创建了多少合并请求、议题和成员。

对 群组 Wiki 的更改不会出现在群组活动分析中。

查看群组活动

您可以在浏览器中或在 RSS 提要中查看群组中最近的操作：

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

要以 Atom 格式查看活动提要，请选择 RSS ({{< icon name=”rss” >}}) 图标。