使用 Linux 包安装 GitLab

Linux 包已经非常成熟且可扩展，并在 GitLab.com 上使用。如果您需要额外的 灵活性和弹性，我们建议按照 参考架构文档 中的描述部署 GitLab。

Linux 包安装更快，升级更简单，并且包含其他安装方法中未见的 增强可靠性的功能。通过单个包（也称为 Omnibus GitLab）安装， 该包捆绑了运行 GitLab 所需的所有不同服务和工具。请参阅 安装要求 了解最低硬件要求。

我们的软件包仓库中提供了适用于以下系统的 Linux 包：

• GitLab Enterprise Edition
• GitLab Community Edition

请检查您的主机操作系统是否支持所需的 GitLab 版本。

支持的平台

GitLab 官方支持操作系统的长期支持（LTS）版本。某些操作系统， 如 Ubuntu，在 LTS 和非 LTS 版本之间有明确的区分。然而，也有其他操作系统， 例如 openSUSE，并不遵循 LTS 概念。

我们通常会为某个操作系统版本提供支持，直到其供应商停止支持为止， 这里的支持定义为标准或维护支持，而不是扩展、延长或高级支持。 但是，在以下情况下，我们可能会比操作系统供应商更早停止支持：

• 业务考虑因素：包括但不限于客户采用率低、维护成本不成比例或战略产品方向变更。
• 技术限制：当第三方依赖项、安全要求或底层技术变更使持续支持变得不切实际或不可能时。
• 供应商行为：当操作系统供应商的变更从根本上影响我们软件的功能，或必需组件变得不可用时。

我们通常会在停止支持任何操作系统版本之前至少 6 个月发出弃用通知，尽最大努力。 在技术限制、供应商行为或其他外部因素要求我们提供较短通知期的情况下， 我们会尽快传达任何支持变更。

脚注：

1. 在 ARM 上运行 GitLab存在已知问题。

非官方、不受支持的安装方法

以下安装方法由更广泛的 GitLab 社区按原样提供，不受 GitLab 支持：

• Debian 原生包（由 Pirate Praveen 提供）
• FreeBSD 包（由 Torsten Zühlsdorff 提供）
• Arch Linux 包（由 Arch Linux 社区提供）
• Puppet 模块（由 Vox Pupuli 提供）
• Ansible playbook（由 Jeff Geerling 提供）
• GitLab 虚拟机（KVM）（由 OpenNebula 提供）
• Cloudron 上的 GitLab（通过 Cloudron 应用库）

终止支持版本

GitLab 仅在操作系统的生命周期结束（EOL）日期之前为其提供 Linux 包。 EOL 日期之后，GitLab 将停止发布官方包。

然而，有时即使操作系统已经 EOL，我们也不会弃用它， 因为我们无法为更新版本提供包。 最常见的原因是我们的包仓库提供商 PackageCloud 不支持更新版本， 因此我们无法将包上传到其中。

已弃用的操作系统列表及其最终的 GitLab 发布版本如下：

Raspberry Pi OS（32位 - Raspbian）

GitLab 在 17.11 版本中停止了对 Raspberry Pi OS（32位 - Raspbian）的支持， 这是该 32 位平台可用的最后一个版本。从 GitLab 18.0 开始， 您应该迁移到 Raspberry Pi OS（64位）并使用 Debian arm64 包。

有关在 32 位操作系统上备份数据并将其恢复到 64 位操作系统的信息， 请参阅升级 PostgreSQL 操作系统。

卸载 Linux 包

要卸载 Linux 包，您可以选择保留数据（仓库、数据库、配置）或删除所有数据：

1. 可选。在卸载包之前，删除 Linux 包创建的所有用户和组：

   sudo gitlab-ctl stop && sudo gitlab-ctl remove-accounts

   如果您在删除账户或组时遇到问题，请手动运行 userdel 或 groupdel 来删除它们。 您可能还需要手动从 /home/ 中删除剩余的用户主目录。

2. 选择是保留数据还是删除所有数据：

   • 要保留数据（仓库、数据库、配置），请停止 GitLab 并 移除其监督进程：

     sudo systemctl stop gitlab-runsvdir
     sudo systemctl disable gitlab-runsvdir
     sudo rm /usr/lib/systemd/system/gitlab-runsvdir.service
     sudo systemctl daemon-reload
     sudo systemctl reset-failed
     sudo gitlab-ctl uninstall

   • 要删除所有数据：

     sudo gitlab-ctl cleanse && sudo rm -r /opt/gitlab

3. 卸载包（如果您安装的是 GitLab FOSS，请替换为 gitlab-ce）：

   apt

   # Debian/Ubuntu
   sudo apt remove gitlab-ee

   dnf

   # AlmaLinux/RHEL/Oracle Linux/Amazon Linux 2023
   sudo dnf remove gitlab-ee

   zypper

   # OpenSUSE Leap/SLES
   sudo zypper remove gitlab-ee

   yum

   # Amazon Linux 2
   sudo yum remove gitlab-ee