Requirements · Gitlab 中文文檔

# Requirements > 原文：[https://docs.gitlab.com/ee/install/requirements.html](https://docs.gitlab.com/ee/install/requirements.html) * [Operating Systems](#operating-systems) * [Supported Linux distributions](#supported-linux-distributions) * [Unsupported Linux distributions and Unix-like operating systems](#unsupported-linux-distributions-and-unix-like-operating-systems) * [Microsoft Windows](#microsoft-windows) * [Software requirements](#software-requirements) * [Ruby versions](#ruby-versions) * [Go versions](#go-versions) * [Git versions](#git-versions) * [Node.js versions](#nodejs-versions) * [Redis versions](#redis-versions) * [Hardware requirements](#hardware-requirements) * [Storage](#storage) * [CPU](#cpu) * [Memory](#memory) * [Database](#database) * [PostgreSQL Requirements](#postgresql-requirements) * [Additional requirements for GitLab Geo](#additional-requirements-for-gitlab-geo) * [Puma settings](#puma-settings) * [Puma workers](#puma-workers) * [Puma threads](#puma-threads) * [Unicorn Workers](#unicorn-workers) * [Redis and Sidekiq](#redis-and-sidekiq) * [Prometheus and its exporters](#prometheus-and-its-exporters) * [GitLab Runner](#gitlab-runner) * [Supported web browsers](#supported-web-browsers) # Requirements[](#requirements "Permalink") 該頁面包含有關受支持的操作系統以及安裝和使用 GitLab 所需的硬件要求的有用信息. ## Operating Systems[](#operating-systems "Permalink") ### Supported Linux distributions[](#supported-linux-distributions "Permalink") * Ubuntu（16.04 / 18.04） * Debian（8/9/10） * CentOS 的（6/7/8） * openSUSE（Leap 15.1 / Enterprise Server 12.2） * 紅帽企業版 Linux（請使用 CentOS 軟件包和說明） * 科學版 Linux（請使用 CentOS 軟件包和說明） * Oracle Linux（請使用 CentOS 軟件包和說明）有關安裝選項，請參見[主要安裝頁面](README.html) . ### Unsupported Linux distributions and Unix-like operating systems[](#unsupported-linux-distributions-and-unix-like-operating-systems "Permalink") * Arch Linux * Fedora * FreeBSD * Gentoo * macOS 可以在這些操作系統上安裝 GitLab，但不支持. 請參閱[源安裝指南](installation.html)和[安裝指南](https://about.gitlab.com/install/)以獲取更多信息. ### Microsoft Windows[](#microsoft-windows "Permalink") GitLab 是針對基于 Linux 的操作系統開發的. 它**不能**在 Microsoft Windows 上運行，并且我們沒有計劃在不久的將來支持它. 有關最新的開發狀態，請查看此[問題](https://gitlab.com/gitlab-org/gitlab/-/issues/22337) . 請考慮使用虛擬機運行 GitLab. ## Software requirements[](#software-requirements "Permalink") ### Ruby versions[](#ruby-versions "Permalink") GitLab 需要 Ruby（MRI）2.6\. 從 GitLab 12.2 開始，我們不再支持 Ruby 2.5 及更低版本. 您必須使用 Ruby 的標準 MRI 實現. 我們喜歡[JRuby](https://www.jruby.org/)和[Rubinius](https://github.com/rubinius/rubinius#the-rubinius-language-platform) ，但是 GitLab 需要幾個具有本機擴展的 Gems. ### Go versions[](#go-versions "Permalink") 所需的最低 Go 版本為 1.13. ### Git versions[](#git-versions "Permalink") 從 GitLab 13.1： * 需要 Git 2.25.x 及更高版本. * [建議使用](https://gitlab.com/gitlab-org/gitaly/-/issues/2829) Git 2.27.x 及更高版本. ### Node.js versions[](#nodejs-versions "Permalink") 從 GitLab 12.9 開始，我們僅支持 node.js 10.13.0 或更高版本，并且我們放棄了對 node.js 8 的支持.（在 GitLab 11.8 中取消了對 node.js 6 的支持）. 我們建議使用 Node 12.x，因為它速度更快. GitLab 使用[Webpack](https://webpack.js.org/)編譯前端資產，這需要最低版本的 Node.js 10.13.0. 您可以使用`node -v`檢查您正在運行哪個版本. 如果您運行的版本低于`v10.13.0` ，則需要將其更新為較新的版本. 您可以在[Node.js 網站上](https://s0nodejs0org.icopy.site/en/download/)找到從社區維護的軟件包安裝或從源代碼進行編譯的[說明](https://s0nodejs0org.icopy.site/en/download/) . ## Redis versions[](#redis-versions "Permalink") GitLab 需要 Redis 5.0+. 從 GitLab 13.0 開始，不支持較低版本. ## Hardware requirements[](#hardware-requirements "Permalink") ### Storage[](#storage "Permalink") 所需的硬盤空間在很大程度上取決于要存儲在 GitLab 中的存儲庫的大小，但是根據*經驗，*您應該至少具有與所有存儲庫加起來一樣大的可用空間. 如果您將來想靈活地增加硬盤驅動器空間，請考慮使用[邏輯卷管理（LVM）進行](https://en.wikipedia.org/wiki/Logical_volume_management)安裝，以便在需要時可以添加更多硬盤驅動器. 除本地硬盤驅動器外，您還可以安裝支持網絡文件系統（NFS）協議的卷. 該卷可能位于文件服務器，網絡連接存儲（NAS）設備，存儲區域網絡（SAN）或 Amazon Web Services（AWS）彈性塊存儲（EBS）卷上. 如果您有足夠的 RAM 和最新的 CPU，則 GitLab 的速度主要受硬盤搜索時間限制. 具有快速驅動器（7200 RPM 及更高版本）或固態驅動器（SSD）將提高 GitLab 的響應速度. **注意：**由于文件系統性能可能會影響 GitLab 的整體性能，因此[我們不建議使用 AWS EFS 進行存儲](../administration/high_availability/nfs.html#avoid-using-awss-elastic-file-system-efs) . ### CPU[](#cpu "Permalink") CPU 需求取決于用戶數量和預期的工作量. 您的確切需求可能更多，具體取決于您的工作量. 您的工作負載受以下因素影響，這些因素包括但不限于：用戶的活躍程度，使用的自動化程度，鏡像和回購/更改大小. 以下是一些示例 GitLab 用戶庫大小的建議最低 CPU 硬件指南. * **4 芯**是核心的**推薦**最小數目和多達 500 個用戶支持 * 8 個內核最多支持 1000 個用戶 * 更多用戶？查閱[參考架構頁面](../administration/reference_architectures/index.html) ### Memory[](#memory "Permalink") 內存需求取決于用戶數量和預期的工作量. 您的確切需求可能更多，具體取決于您的工作量. 您的工作負載受以下因素影響，這些因素包括但不限于：用戶的活躍程度，使用的自動化程度，鏡像和回購/更改大小. 以下是一些示例 GitLab 用戶庫大小的建議最低內存硬件指南. * **4GB RAM**是**必需的**最小內存大小，最多可支持 500 個用戶 * 我們的[內存團隊](https://about.gitlab.com/handbook/engineering/development/enablement/memory/)正在努力減少內存需求. * 8GB RAM 最多支持 1000 個用戶 * 更多用戶？查閱[參考架構頁面](../administration/reference_architectures/index.html) 除上述之外，即使您當前有足夠的可用 RAM，我們通常也建議在服務器上至少有 2GB 的交換空間. 如果您的可用內存發生更改，那么進行交換將有助于減少發生錯誤的機會. 我們還建議將內核的 swappiness 設置配置為較低的值（例如`10`以充分利用您的 RAM，同時在需要時仍可使用交換功能. ## Database[](#database "Permalink") PostgreSQL 是唯一受支持的數據庫，與 Omnibus GitLab 軟件包捆綁在一起. 您也可以使用[外部 PostgreSQL 數據庫](https://docs.gitlab.com/omnibus/settings/database.html) . 在 GitLab 12.1 中刪除了對 MySQL 的支持. 建議在 MySQL / MariaDB 上使用 GitLab 的現有用戶在升級之前[遷移到 PostgreSQL](../update/mysql_to_postgresql.html) . ### PostgreSQL Requirements[](#postgresql-requirements "Permalink") 運行 PostgreSQL 的服務器應*至少有* 5-10 GB 的可用存儲空間，盡管確切的要求[取決于用戶數量](../administration/reference_architectures/index.html) . 我們強烈建議用戶使用下面指定的最低 PostgreSQL 版本，因為這些是用于開發和測試的版本. | GitLab 版本 | 最低 PostgreSQL 版本 | | --- | --- | | 10.0 | 9.6 | | 12.10 | 11 | | 13.0 | 11 | 您還必須確保將`pg_trgm`擴展加載到每個 GitLab 數據庫中. [可以](https://s0www0postgresql0org.icopy.site/docs/11/sql-createextension.html)使用 PostgreSQL 超級用戶[啟用](https://s0www0postgresql0org.icopy.site/docs/11/sql-createextension.html)此擴展. 在某些系統上，您可能需要安裝一個附加軟件包（例如`postgresql-contrib` ），此擴展才可以使用. **注意：** [在 GitLab 13.0 中已刪除了](https://about.gitlab.com/releases/2020/05/22/gitlab-13-0-released/#postgresql-11-is-now-the-minimum-required-version-to-install-gitlab)對[PostgreSQL 9.6 和 10 的](https://about.gitlab.com/releases/2020/05/22/gitlab-13-0-released/#postgresql-11-is-now-the-minimum-required-version-to-install-gitlab)支持，因此 GitLab 可以從 PostgreSQL 11 的改進（例如分區）中受益. 有關過渡到 PostgreSQL 12 的時間表，請參閱[相關的 epic](https://gitlab.com/groups/gitlab-org/-/epics/2184) . #### Additional requirements for GitLab Geo[](#additional-requirements-for-gitlab-geo "Permalink") 如果您使用的是[GitLab Geo](../administration/geo/replication/index.html) ： * 我們強烈建議您在積極開發和測試的情況下運行由 Omnibus 管理的實例. 我們的目標是與大多數外部數據庫（不由 Omnibus 管理）兼容（例如， [AWS Relational Database Service（RDS）](https://aws.amazon.com/rds/) ），但我們不保證兼容性. * 您還必須確保將`postgres_fdw`擴展加載到每個 GitLab 數據庫中. [可以](https://s0www0postgresql0org.icopy.site/docs/11/sql-createextension.html)使用 PostgreSQL 超級用戶[啟用](https://s0www0postgresql0org.icopy.site/docs/11/sql-createextension.html)此擴展. ## Puma settings[](#puma-settings "Permalink") 建議的 Puma 設置取決于運行它的基礎結構. Omnibus GitLab 默認為建議的 Puma 設置. 無論安裝方法如何，都可以調整 Puma 設置. 如果您使用的是 Omnibus GitLab，請參閱[Puma 設置](https://docs.gitlab.com/omnibus/settings/puma.html)以獲取有關更改 Puma 設置的說明. 如果您使用的是 GitLab Helm 圖表，請參閱[Webservice 圖表](https://docs.gitlab.com/charts/charts/gitlab/webservice/index.html) . ### Puma workers[](#puma-workers "Permalink") 推薦的工人人數是根據以下最高者計算得出的： * `2` * CPU 核心數-1 例如，一個具有 4 個核心的節點應配置 3 個 Puma Worker. 如果可以提供足夠的 CPU 和內存容量，則可以增加 Puma worker 的數量. 數量更多的 Puma 工作人員通常將有助于減少應用程序的響應時間并提高處理并行請求的能力. 您必須執行測試以驗證基礎架構的最佳設置. ### Puma threads[](#puma-threads "Permalink") 推薦的線程數取決于幾個因素，包括總內存和[傳統 Rugged 代碼的使用](../development/gitaly.html#legacy-rugged-code) . * 如果操作系統最多具有 2 GB 的內存，則建議的線程數為`1` . 較高的值將導致過多的交換，并降低性能. * If legacy Rugged code is in use, the recommended number of threads is `1`. * 在所有其他情況下，建議的線程數為`4` . 由于[Ruby MRI 多線程的](https://en.wikipedia.org/wiki/Global_interpreter_lock)工作方式，我們不建議設置更高的值. ## Unicorn Workers[](#unicorn-workers "Permalink") 對于大多數情況，我們建議使用：（CPU 內核* 1.5）+ 1 = Unicorn worker. 例如，一個具有 4 個核心的節點將有 7 個 Unicorn worker. 對于所有 2GB 以上的計算機，我們建議至少三名 Unicorn 工人. 如果您有一臺 1GB 的計算機，我們建議僅配置兩個 Unicorn worker，以防止過度交換. 只要您有足夠的可用 CPU 和內存容量，就可以增加 Unicorn worker 的數量，這通常將有助于減少應用程序的響應時間并提高處理并行請求的能力. 要在擁有 Omnibus 軟件包（默認為上述建議）時更改 Unicorn worker，請參閱[Omnibus GitLab 文檔中的 Unicorn 設置](https://docs.gitlab.com/omnibus/settings/unicorn.html) . ## Redis and Sidekiq[](#redis-and-sidekiq "Permalink") Redis 存儲所有用戶會話和后臺任務隊列. Redis 的存儲要求極低，每個用戶大約 25kB. Sidekiq 使用多線程進程來處理后臺作業. 此過程從整個 Rails 堆棧（200MB +）開始，但是由于內存泄漏，它可能隨著時間的推移而增長. 在非常活躍的服務器（10,000 個活躍用戶）上，Sidekiq 進程可以使用 1GB +的內存. ## Prometheus and its exporters[](#prometheus-and-its-exporters "Permalink") 從 Omnibus GitLab 9.0 起，默認啟用[Prometheus](https://s0prometheus0io.icopy.site)及其相關出口商，以實現對 GitLab 的輕松和深度監控. 使用默認設置，這些進程將消耗大約 200MB 的內存. 如果您想禁用 Prometheus 及其出口商或閱讀有關它的更多信息，請查閱[Prometheus 文檔](../administration/monitoring/prometheus/index.html) . ## GitLab Runner[](#gitlab-runner "Permalink") 強烈建議不要在打算安裝 GitLab 的同一臺計算機上安裝 GitLab Runner. 根據您決定配置 GitLab Runner 的方式以及用于在 CI 環境中運行應用程序的工具的不同，GitLab Runner 會消耗大量可用內存. 如果您決定在同一臺計算機上運行 GitLab Runner 和 GitLab Rails 應用程序，則上面提供的內存消耗計算將無效. 由于[安全原因](https://docs.gitlab.com/runner/security/) ，將所有內容都安裝在一臺機器上也不安全，尤其是當您計劃將 Shell executor 與 GitLab Runner 一起使用時. 如果您打算使用 CI 功能，我們建議為每個 GitLab Runner 使用單獨的機器. GitLab Runner 服務器要求取決于： * 您在 GitLab Runner 上配置的[執行程序](https://docs.gitlab.com/runner/executors/)的類型. * 運行構建作業所需的資源. * 作業并發設置. 由于作業的性質因每個用例而異，因此您將需要通過調整作業并發來進行實驗以獲得最佳設置. 作為參考，對 GitLab.com 的[自動縮放共享](../user/gitlab_com/index.html#shared-runners)運行器進行了配置，以便**單個作業**將在**單個實例中**運行，并具有： * 1vCPU. * 3.75GB 的 RAM. ## Supported web browsers[](#supported-web-browsers "Permalink") **警告：**在 GitLab 13.0（2020 年 5 月）中，我們刪除了對 Internet Explorer 11 的官方支持.在 GitLab 13.4 發行版（2020 年 9 月）中，我們將刪除了所有支持 Internet Explorer 11 的代碼.您可以提供[有關此問題的](https://gitlab.com/gitlab-org/gitlab/-/issues/197987)反饋[，](https://gitlab.com/gitlab-org/gitlab/-/issues/197987)也可以通過通常的支持渠道. GitLab supports the following web browsers: * [Mozilla Firefox](https://www.mozilla.org/en-US/firefox/new/) * [Google Chrome](https://www.google.com/chrome/) * [Chromium](https://www.chromium.org/getting-involved/dev-channel) * [Apple Safari](https://www.apple.com/safari/) * [Microsoft Edge](https://www.microsoft.com/en-us/edge) 對于列出的 Web 瀏覽器，GitLab 支持： * 當前和以前的主要瀏覽器版本（Internet Explorer 除外）. * 受支持的主要版本的當前次要版本. **注意：**我們不支持在瀏覽器中禁用 JavaScript 的情況下運行 GitLab，并且將來也沒有支持該計劃的計劃，因為我們具有諸如 Issue Boards 之類的功能，這些功能廣泛需要 JavaScript.