{{< details >}}

  • Tier: 基础版, 专业版, 旗舰版
  • Offering: 极狐GitLab 私有化部署

{{< /details >}}

极狐GitLab 的 管理员 区域提供了一个 Web UI 来管理和配置极狐GitLab 私有化部署实例的功能。如果您是管理员，要访问 管理员 区域：

  • 在极狐GitLab 17.3 及更高版本：在左侧边栏底部，选择 管理员。
  • 在极狐GitLab 16.7 及更高版本：在左侧边栏底部，选择 管理区。
  • 在极狐GitLab 16.1 及更高版本：在左侧边栏，选择 搜索或转到，然后选择 管理员。
  • 在极狐GitLab 16.0 及更早版本：在顶部栏选择 主菜单 > 管理员。

如果极狐GitLab 实例使用 Admin Mode，您必须为您的会话启用管理模式 才能看到 管理员。

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

只有在极狐GitLab 私有化部署的管理员才能访问 管理员 区域。在JihuLab.com 上，管理员 区域功能不可用。

{{< /alert >}}

管理项目

要从 管理员 区域的项目页面管理极狐GitLab 实例中的所有项目：

  1. 在左侧边栏底部，选择 管理员。
  2. 选择 概览 > 项目。
  3. 选择 全部、私有、内部 或 公开 选项卡以仅列出符合该标准的项目。

  4. 可选。结合这些筛选和排序选项以找到您想要的项目：

    • 选择 按名称过滤。输入您想要查找的项目名称，极狐GitLab 会在您输入文本时筛选项目。

    • 选择 排序 以按以下方式排序项目：

      • 更新日期
      • 最近创建
      • 名称
      • 最多星标
      • 最早创建
      • 最早更新
      • 最大仓库

    • 选择 排序 以筛选项目：

      • 隐藏（或显示）已归档项目
      • 仅显示已归档的项目
      • 由任何人拥有
      • 由我拥有

    • 要筛选命名空间中的项目，选择 命名空间。输入文本以筛选您想要的命名空间，然后选择它。

编辑项目

要从 管理员 区域的项目页面编辑项目的名称或描述：

  1. 在左侧边栏底部，选择 管理员。
  2. 选择 概览 > 项目。
  3. 在您要编辑的项目旁边，选择 编辑。
  4. 编辑 项目名称 或 项目描述。
  5. 选择 保存变更。

删除项目

要删除项目：

  1. 在左侧边栏底部，选择 管理员。
  2. 选择 概览 > 项目。
  3. 在您要编辑的项目旁边，选择 删除。

管理用户

{{< history >}}

  • 在极狐GitLab 17.0 中引入用户筛选功能。

{{< /history >}}

管理员 区域的用户页面显示每个用户的以下信息：

  • 用户名
  • 电子邮件地址
  • 项目成员数
  • 组成员数
  • 帐户创建日期
  • 上次活动日期

要从 管理员 区域的用户页面管理所有用户：

  1. 在左侧边栏底部，选择 管理员。
  2. 选择 概览 > 用户。

  3. 可选。要更改排序顺序，默认为用户名：

    1. 选择排序下拉列表。
    2. 选择所需的顺序。

  4. 可选。使用用户搜索框按以下方式搜索和筛选用户：

    • 用户访问级别。
    • 是否启用或禁用双因素认证。
    • 用户状态。
  5. 可选。在用户搜索字段中输入文本，然后按 Enter。此不区分大小写的文本搜索对名称、用户名和电子邮件应用部分匹配。

要编辑用户，找到用户的行并选择 编辑。

删除用户

要从 管理员 区域的用户页面删除用户，或删除用户及其贡献：

  1. 在左侧边栏底部，选择 管理员。
  2. 选择 概览 > 用户。
  3. 找到您要删除的用户。在行中选择 用户管理 ({{< icon name=”ellipsis_v”>}})，然后选择所需的选项。

用户模拟

管理员可以模拟任何其他用户，包括其他管理员。这使您可以查看用户在极狐GitLab 中看到的内容，并代表用户采取行动。

要模拟用户：

  • 通过 UI：
    1. 在左侧边栏底部，选择 管理员。
    2. 在左侧边栏选择 概览 > 用户。
    3. 从用户列表中选择一个用户。
    4. 在右上角选择 模拟。
  • 使用 API，通过模拟令牌。

所有模拟活动都通过审计事件捕获。默认情况下，模拟功能是启用的。极狐GitLab 可以配置为禁用模拟。

用户身份

{{< details >}}

  • 层级：专业版，旗舰版

{{< /details >}}

{{< history >}}

  • 在极狐GitLab 15.3 中引入查看用户的 SCIM 身份。

{{< /history >}}

使用身份验证提供程序时，管理员可以查看用户的身份。此页面显示用户的身份，包括 SCIM 身份。使用此信息来排除与 SCIM 相关的问题并确认用于帐户的身份。

执行此操作：

  1. 在左侧边栏底部，选择 管理员。
  2. 选择 概览 > 用户。
  3. 从用户列表中选择一个用户。
  4. 选择 模拟。

用户权限导出

{{< details >}}

  • 层级：专业版，旗舰版
  • Offering: 极狐GitLab 私有化部署

{{< /details >}}

当您导出用户权限时，导出的信息显示用户在组和项目中的直接成员资格。它包括这些数据，并限制为前 100,000 个用户：

  • 用户名
  • 邮箱
  • 类型
  • 路径
  • 访问级别（项目和群组）
  • 上次活动日期。有关填充此列的活动列表，请参阅用户 API 文档。

要为您的极狐GitLab 实例中的所有活跃用户导出用户权限：

  1. 在左侧边栏底部，选择 管理员。
  2. 选择 概览 > 用户。
  3. 在右上角，选择 导出权限为 CSV ({{< icon name=”export” >}})。

用户统计

用户统计页面按角色提供用户帐户的概述。这些统计数据每天计算一次。最后更新后的用户更改不予反映。这些总数也包括在内：

  • 计费用户
  • 被阻止的用户
  • 总用户

极狐GitLab 的计费基于计费用户的数量。

向用户添加电子邮件

要手动向用户帐户添加电子邮件地址：

  1. 在左侧边栏底部，选择 管理员。
  2. 选择 概览 > 用户。
  3. 找到用户并选择他们。
  4. 选择 编辑。
  5. 在 邮件 中输入新的电子邮件地址。这会将新电子邮件地址添加到用户并将以前的电子邮件地址设置为次要。
  6. 选择 保存变更。

用户群组

Cohorts 选项卡显示新用户的每月群组及其随时间的活动。

防止用户创建顶级组

默认情况下，用户可以创建顶级组。要防止用户创建顶级组：

  1. 在左侧边栏底部，选择 管理员。
  2. 选择 概览 > 用户。
  3. 找到用户并选择他们。
  4. 选择 编辑。
  5. 清除 可以创建顶级群组 复选框。
  6. 选择 保存变更。

还可以限制哪些角色可以创建另一组的子群组。

管理组

要管理极狐GitLab 实例中的所有组：

  1. 在左侧边栏底部，选择 管理员。

  2. 选择 概览 > 群组。页面显示组的：

    • 名称。
    • 描述。
    • 大小。
    • 组中的项目数。
    • 成员数。
    • 隐私级别：组是私有、内部还是公开的。
  3. 要管理组，找到组的行并选择 编辑 或 删除。

  4. 可选。要更改排序顺序，请选择排序下拉列表并选择所需的顺序。可用的排序选项是：

    • 创建日期（默认）。
    • 更新日期。
    • 存储大小。此选项按总存储使用情况对组进行排序，包括 Git 仓库和组中所有项目的 Large File Storage (LFS)。有关更多信息，请参阅使用配额。
  5. 可选。要按名称搜索组，请在搜索字段中输入您的条件。组搜索不区分大小写，并应用部分匹配。
  6. 可选。要创建新群组，选择 新群组。

管理主题

{{< history >}}

  • 在极狐GitLab 15.5 中引入合并主题功能。

{{< /history >}}

使用主题对类似项目进行分类和查找。

查看所有主题

要查看极狐GitLab 实例中的所有主题：

  1. 在左侧边栏底部，选择 管理员。
  2. 选择 概览 > 主题。

对于每个主题，页面显示其名称和标记有该主题的项目数。

搜索主题

  1. 在左侧边栏底部，选择 管理员。
  2. 选择 概览 > 主题。
  3. 在搜索框中输入您的搜索条件。主题搜索不区分大小写，并应用部分匹配。

创建主题

要创建主题：

  1. 在左侧边栏底部，选择 管理员。
  2. 选择 概览 > 主题。
  3. 选择 新主题。
  4. 输入 主题别名（名称） 和 主题标题。
  5. 可选。输入 描述 并添加 主题头像。
  6. 选择 保存变更。

创建的主题显示在 浏览主题 页面上。

分配的主题仅对有权访问项目的所有人可见，但每个人都可以看到极狐GitLab 实例上存在的主题。不要在主题名称中包含敏感信息。

编辑主题

您可以随时编辑主题的名称、标题、描述和头像。要编辑主题：

  1. 在左侧边栏底部，选择 管理员。
  2. 选择 概览 > 主题。
  3. 在该主题的行中选择 编辑。
  4. 编辑主题 slug（名称）、标题、描述或头像。
  5. 选择 保存变更。

移除主题

如果您不再需要主题，可以永久删除它。要移除主题：

  1. 在左侧边栏底部，选择 管理员。
  2. 选择 概览 > 主题。
  3. 要移除主题，请在该主题的行中选择 移除。

合并主题

您可以将分配给主题的所有项目移动到另一个主题。然后，源主题被永久删除。合并的主题被删除后，无法恢复。

要合并主题：

  1. 在左侧边栏底部，选择 管理员。
  2. 选择 概览 > 主题。
  3. 选择 合并主题。
  4. 从 源主题 下拉列表中选择您要合并和删除的主题。
  5. 从 目标主题 下拉列表中选择您要将源主题合并到的主题。
  6. 选择 合并。

管理 Gitaly 服务器

您可以从 管理员 区域的 Gitaly 服务器 页面列出极狐GitLab 实例中的所有 Gitaly 服务器。有关更多详细信息，请参阅 Gitaly。

要访问 Gitaly servers 页面：

  1. 在左侧边栏底部，选择 管理员。
  2. 选择 概览 > Gitaly 服务器。

页面包含有关每个 Gitaly 服务器的以下信息：

字段 描述
存储 仓库存储
地址 Gitaly 服务器正在侦听的网络地址
服务器版本 Gitaly 版本
Git 版本 安装在 Gitaly 服务器上的 Git 版本
最新版本 指示 Gitaly 服务器版本是否为最新可用版本。绿色点表示服务器是最新的。

管理组织

{{< history >}}

  • 在极狐GitLab 16.10 中引入，带有名为 ui_for_organizations 的标志。默认情况下禁用。

{{< /history >}}

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

在极狐GitLab 私有化部署中，默认情况下此功能不可用。要使其可用，管理员可以启用名为 ui_for_organizations 的功能标志。在JihuLab.com 中，此功能不可用。此功能尚未准备好用于生产环境。

{{< /alert >}}

管理员 区域中的组织页面默认按最后更新时间的逆序列出所有项目。每个项目显示：

  • 名称
  • 命名空间
  • 描述
  • 大小，每 15 分钟更新一次

要从此页面管理极狐GitLab 实例中的所有组织：

  1. 在左侧边栏底部，选择 管理员。
  2. 选择 概览 > 组织。

CI/CD 部分

管理 runners

{{< history >}}

  • 在极狐GitLab 15.8 中从 概览 > Runners 移至 CI/CD > Runners。

{{< /history >}}

要管理极狐GitLab 实例中的所有 runners：

  1. 在左侧边栏底部，选择 管理员。
  2. 选择 CI/CD > Runners。

每个 runner 显示以下信息：

属性 描述
状态 runner 的状态。在极狐GitLab 15.1 及更高版本中，针对旗舰版，提供了升级状态。
Runner 详情 有关 runner 的信息，包括部分令牌和 runner 注册计算机的详细信息。
版本 极狐GitLab Runner 版本。
作业 runner 运行的作业总数。
标签 与 runner 关联的标签。
上次联系 表示 runner 上次联系极狐GitLab 实例的时间戳。

您还可以编辑、暂停或移除每个 runner。

有关更多信息，请参阅 极狐GitLab Runner。

搜索和筛选 runners

要搜索 runners 的描述：

  1. 在 搜索或过滤结果 文本框中输入您要查找的 runner 的描述。
  2. 按 Enter。

要按状态、类型和标签筛选 runners：

  1. 选择选项卡或 搜索或过滤结果 文本框。
  2. 选择任何 类型，或按 状态 或 标签 筛选。
  3. 选择或输入您的搜索条件。

按状态筛选的 runner 的属性

批量删除 runners

{{< history >}}

  • 在极狐GitLab 15.4 中引入。
  • 在极狐GitLab 15.5 中移除功能标志。

{{< /history >}}

要同时删除多个 runners：

  1. 在左侧边栏底部，选择 管理员。
  2. 选择 概览 > Runners。
  3. 在您要删除的 runner 左侧，选择复选框。要选择页面上的所有 runners，请选择列表上方的复选框。
  4. 选择 删除所选。

管理作业

{{< history >}}

  • 在极狐GitLab 15.8 中从 概览 > 作业 移至 CI/CD > 作业。

{{< /history >}}

要管理极狐GitLab 实例中的所有作业：

  1. 在左侧边栏底部，选择 管理员。
  2. 选择 CI/CD > 作业。所有作业按作业 ID 递减顺序列出。
  3. 选择 所有 选项卡以列出所有作业。选择 等待、运行 或 已完成 选项卡以仅列出该状态的作业。

对于每个作业，列出以下详细信息：

字段 描述
状态 作业状态。可能是 通过、跳过 或 失败。
作业 包含指向作业、分支和启动作业的提交的链接。
流水线 包含指向特定流水线的链接。
项目 作业所属的项目和组织的名称。
Runner 分配执行作业的 CI runner 的名称。
阶段 在 .gitlab-ci.yml 文件中声明作业的阶段。
名称 在 .gitlab-ci.yml 文件中指定的作业名称。
时间 作业的持续时间，以及作业完成的时间。
覆盖率 测试覆盖率的百分比。

监控部分

以下主题记录了 管理员 区域的 Monitoring 部分。

系统信息

{{< history >}}

  • 在极狐GitLab 15.2 中引入对相对时间的支持。“运行时间”统计被重命名为“系统启动”。

{{< /history >}}

系统信息页面提供以下统计信息：

字段 描述
CPU 可用 CPU 核心数
内存使用 使用中的内存和可用的总内存
磁盘使用 使用中的磁盘空间和可用的总磁盘空间
系统启动时间 承载极狐GitLab 的系统启动时间。在极狐GitLab 15.1 及更早版本中，这是一个运行时间统计。

这些统计信息仅在您访问 系统信息 页面时更新，或在您的浏览器中刷新页面时更新。

后台作业

后台作业页面显示 Sidekiq 仪表板。极狐GitLab 使用 Sidekiq 执行后台进程。

Sidekiq 仪表板包含：

  • 每个作业状态的选项卡。
  • 后台作业统计的细分。
  • Processed 和 Failed 作业的实时图表，具有可选择的轮询间隔。
  • Processed 和 Failed 作业的历史图表，具有可选择的时间跨度。
  • Redis 统计信息，包括：
    • 版本号
    • 运行时间，以天为单位
    • 连接数
    • 当前内存使用量，以 MB 为单位
    • 峰值内存使用量，以 MB 为单位

日志

这些日志文件的内容可以帮助排查问题。每个日志文件的内容按时间顺序列出。为了最大限度地减少性能问题，每个日志文件最多显示 2000 行。

日志文件 内容
application_json.log 极狐GitLab 用户活动
git_json.log 极狐GitLab 与 Git 仓库交互失败
production.log 从 Puma 收到的请求以及为提供这些请求而采取的操作
sidekiq.log 后台作业
repocheck.log 仓库活动
integrations_json.log 极狐GitLab 与集成系统之间的活动
kubernetes.log Kubernetes 活动

有关这些日志文件及其内容的详细信息，请参阅 日志系统。

日志视图已从 管理员 区域仪表板中移除，以防止多节点系统管理员混淆。此视图为多节点设置提供部分信息。对于多节点系统，请将日志导入 Elasticsearch 和 Splunk 等服务。

审计事件

{{< details >}}

  • 层级：专业版，旗舰版
  • Offering: 极狐GitLab私有化部署

{{< /details >}}

审计事件页面列出了对极狐GitLab 服务器所做的更改。使用此信息来控制、分析和跟踪每次更改。

统计

仪表板的 实例概览 部分列出了极狐GitLab 实例的当前统计数据。使用应用程序统计 API检索此信息。

这些统计信息显示小于 10,000 的值的确切计数。对于 10,000 及更高的值，当使用 TablesampleCountStrategy 和 ReltuplesCountStrategy 策略进行计算时，这些统计信息显示近似数据。