软件要求
- Redis 版本
硬件要求
数据库
- PostgreSQL 要求
  - 使用 GitLab Geo 的额外需求
  - 独立使用 GitLab 数据库
Puma 设置
Redis 和 Sidekiq
Prometheus and its exporters
GitLab Runner
支持的 Web 浏览器
安全

极狐GitLab 安装系统要求

此页面包含有关安装和使用极狐GitLab 所需的最低要求的信息。

软件要求

Redis 版本

极狐GitLab 13.0 及更高版本需要 Redis 5.0 及更高版本。

建议使用 Redis 6.0 及更高版本，已包含于 Omnibus GitLab 安装包。

硬件要求

存储

必要的硬盘空间在很大程度上取决于您想在极狐GitLab 中存储的仓库的大小，但作为准则，您应该至少拥有与所有仓库组合占用的空间一样多的可用空间。

Omnibus GitLab 软件包需要大约 2.5 GB 的存储空间用于安装。

如果您想在未来灵活增加硬盘空间，请考虑使用逻辑卷管理（LVM）进行挂载，以便您在需要更多硬盘空间时进行添加。

除了本地硬盘，您也可以挂载支持网络文件系统（NFS）协议的卷。卷可能位于文件服务器、网络附加存储（NAS）设备、存储区域网络（SAN）或云提供商的弹性块存储卷上。

如果您有足够的 RAM 和较新的 CPU，极狐GitLab 的速度主要受硬盘驱动器寻道时间的限制。使用高转速（7200 转及以上）或固态驱动器（SSD），可提高极狐GitLab 的响应能力。

由于文件系统性能可能会影响极狐GitLab 的整体性能，我们不建议使用基于云的文件系统进行存储。

Git 仓库的 NFS 存储已废弃。

CPU

CPU 需求取决于用户数量和预期的工作负载，确切需求更多地取决于您的工作负载。您的工作负载受多重因素影响，不限于您的用户活跃程度、您使用的自动化程度、镜像、制品库大小和变更大小。

以下是针对部分用户数量群体，推荐的最低 CPU 硬件要求。

4 核 是推荐的最小核数，支持多达 500 名用户
8 核支持多达 1000 名用户

内存

内存需求取决于用户数量和预期的工作负载，确切需求更多地取决于您的工作负载。您的工作负载受多重因素影响，不限于您的用户活跃程度、您使用的自动化程度、镜像、制品库大小和变更大小。

以下是针对部分用户数量群体，推荐的最低内存硬件要求。

4GB RAM 是必需的最小内存，支持多达 500 名用户
8GB RAM 支持多达 1000 名用户

除了上述需求之外，我们通常建议您的服务器上至少有 2GB 的 swap 存储空间，即使您已有足够可用的 RAM。如果您的可用内存发生变化，swap 可帮助您减小错误发生的概率。我们也建议您将内核的 swappiness 设置为低值，例如 10，在充分利用 RAM 的同时，使 swap 在需要时可用。

尽管不期望出现会降低性能的过大的 swapping，但它是针对内存不足情况的极其重要的最后手段。在出现意外的系统负载期间，例如同一主机上的操作系统更新或其他服务，峰值内存负载峰值可能远高于平均水平。拥有大量 swapping 有助于避免 Linux OOM killer 不安全地终止潜在的关键进程，例如 PostgreSQL，这可能会产生灾难性的后果。

数据库

PostgreSQL 是唯一支持的数据库，捆绑在 Omnibus GitLab 软件包中。您也可以使用外部 PostgreSQL 数据库。

PostgreSQL 要求

运行 PostgreSQL 的服务器应至少具有 5-10 GB的存储空间，具体需求根据用户数量决定。

我们强烈建议使用下表所述的最小 PostgreSQL 版本，已经过开发和测试验证。

极狐GitLab 版本	最小 PostgreSQL 版本
13.0	11
14.0	12.7
15.0	12.10
16.0（计划）	13.6

您也必须确保下表所述的扩展已加载到每个 GitLab 数据库。

扩展	最小 GitLab 版本
`pg_trgm`	8.6
`btree_gist`	13.1
`plpgsql`	11.7

已知以下托管 PostgreSQL 服务不兼容，不应使用：

版本	托管服务
14.4+	Amazon Aurora

使用 GitLab Geo 的额外需求

如果您使用 GitLab Geo，我们强烈建议您运行由 Omnibus GitLab 管理的数据库实例，我们的开发和测试也基于该类型的实例。我们尝试与大多数外部数据库兼容（例如 AWS Relational Database Service (RDS)），但我们不能保证兼容性。

独立使用 GitLab 数据库

为极狐GitLab、Geo、Gitaly 集群或其他组件创建或使用的数据库，应该作为极狐GitLab 的专属独立使用。除非遵循官方文档或技术支持的指示，不要直接更改数据库、schema、用户或其它属性。

极狐GitLab 主应用目前使用三个 schema：
- 默认的 public schema
- gitlab_partitions_static（自动创建）
- gitlab_partitions_dynamic（自动创建）
不应手动创建其它 schema。
作为 Rails 数据库迁移的一部分，极狐GitLab 主应用可能会创建新的 schema。当进行 GitLab 升级时，会发生这种情况。GitLab 数据库账户需要访问权限，才能执行此操作。
在升级过程中，会创建和修改表，是一种管理分区表的正常操作。
您不应修改 GitLab schema（例如添加触发器或修改表）。数据库迁移已基于现有代码库中的 schema 定义进行了测试。如果 schema 被修改，版本升级可能会失败。

Puma 设置

Puma 的推荐设置取决于它运行的基础设施。Linux 安装包默认为推荐的 Puma 设置。无论安装方式为何，您都可以调整 Puma 设置。

如果您正在使用 Linux 安装包，查看 Puma 设置文档，获取更改 Puma 设置的说明。

如果您正在使用 Helm chart，查看 webservice chart。

Puma workers

推荐的 workers 数量应取以下两者之间的最大值：

2
CPU 和内存资源可用性的组合（查看如何为 Linux 安装包自动配置）。

以下述场景为例：

具有 2 个内核/8 GB 内存的节点应配置 2 个 Puma worker。
计算方法为：
```
The highest number from
2
And
[
the lowest number from
  - number of cores: 2
  - memory limit: (8 - 1.5) = 6
]
```
因此，2 和 2 中的最高值是 2。

一个 4 核/4 GB 内存的节点应该配置 2 个 Puma worker。

The highest number from
2
And
[
the lowest number from
  - number of cores: 4
  - memory limit: (4 - 1.5) = 2.5
]

因此，2 和 2 中的最高值是 2。

一个 4 核/8 GB 内存的节点应该配置 4 个 Puma worker。

The highest number from
2
And
[
the lowest number from
  - number of cores: 4
  - memory limit: (8 - 1.5) = 6.5
]

因此，2 和 4 中的最高值是 4。

您可以增加 Puma workers 的数量，提供充足的 CPU 和内存容量。更多的 Puma workers 通常有助于减少应用的响应时间，提高处理并行请求的能力。您必须进行测试，以验证基础架构的最佳设置。

Puma threads

推荐的 threads 数量取决于多重因素，包括总内存，和 legacy Rugged 代码。

如果操作系统最多有 2 GB 内存，推荐的 threads 数量为 1。较高的值会导致过度交换并降低性能。
如果 legacy Rugged 代码正在使用，推荐的 threads 数量为 1。
在所有其它情况下，推荐的 threads 数量为 4。我们不推荐设置更高的数值。

每个 Puma worker 的最大内存

默认情况下，每个 Puma worker 将被限制为 1024 MB 的内存。此设置可以调整，如果您需要增加 Puma Worker 的数量应该考虑。

Redis 和 Sidekiq

Redis 存储所有用户会话和后台任务队列。 Redis 的存储需求很小，每个用户大约 25kB。 Sidekiq 使用多线程进程处理后台作业。该进程从整个 Rails 堆栈（200MB+）开始，随着时间推移，会由于内存泄漏而不断增长。在非常活跃的服务器（10000 个计费用户）上，Sidekiq 进程可以使用 1GB 以上的内存。

Prometheus and its exporters

Prometheus 及其相关 exporters 默认开启，开启对极狐GitLab 的深度监控。在默认设置下，这些进程消耗大约 200 MB 的内存。

GitLab Runner

我们强烈建议您，不要在计划安装极狐GitLab 的机器上，同时安装 GitLab Runner。GitLab Runner 会消耗大量内存，取决于您决定如何配置 GitLab Runner，以及在 CI 环境中调试应用所使用的的工具。

如果您决定在同一台机器上运行 GitLab Runner 和 GitLab Rails 应用程序，上方计算的内存消耗值无效。

由于安全原因，在一台机器上安装所有组件并不安全，尤其是当您计划使用 shell executor 时。

如果您计划使用 CI 特性，我们建议每个 GitLab Runner 使用单独的机器。GitLab Runner 服务器的需求依赖以下因素：

您在 GitLab Runner 中配置的 executor 类型。
运行 build job 所需的资源。
Job 的并发设置。

由于每个 Job 都不同，您需要试验调整 Job 的并发性，以获得最佳设置。

支持的 Web 浏览器

我们已移除对 Internet Explorer 11 的官方支持。

极狐GitLab 支持以下 Web 浏览器：

对于以上列出的 Web 浏览器，极狐GitLab 支持：

当前和以前的主要浏览器版本。
支持的主要版本的当前小版本。

我们不支持在浏览器中禁用 JavaScript 的情况下运行极狐GitLab，在未来也没有计划支持，因为我们有例如议题看板等广泛需要 JavaScript 的功能。

安全

安装后，请务必阅读并遵循维护安全的极狐GitLab 安装的指导。