极狐 GitLab Logo

升级 Linux 软件包实例

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

升级 Linux 软件包实例到极狐GitLab 的更高版本需要几个步骤，许多步骤特定于 Linux 软件包安装。

停机时间#

  • 对于单节点安装，在升级过程中，极狐GitLab 对用户不可用。用户的网络浏览器会显示 Deploy in progress 消息或 502 错误。
  • 对于多节点安装，请参阅如何执行零停机时间升级。
  • 对多节点安装的升级也可以在停机时间内执行。

跳过自动数据库备份#

在安装较新的极狐GitLab 版本之前，极狐GitLab 数据库会被备份。您可以通过在 /etc/gitlab/skip-auto-backup 创建一个空文件来跳过这个自动数据库备份：

shell
sudo touch /etc/gitlab/skip-auto-backup

尽管如此，您应该自行维护一个最新的备份。

升级 Linux 软件包实例#

要升级 Linux 软件包实例：

  1. 在极狐GitLab 升级文档中完成初始步骤。
  2. 如果您是从非软件包安装升级到极狐GitLab 软件包安装，请按照从非软件包安装升级到极狐GitLab 软件包安装 中的步骤进行操作。
  3. 继续按照以下部分进行升级。

所需服务#

您可以在极狐GitLab 实例在线时执行升级。当您执行升级命令时，PostgreSQL、Redis 和 Gitaly 必须正在运行。

使用官方仓库（推荐）#

所有极狐GitLab 软件包都发布在极狐GitLab 软件包服务器上。针对不同 OS 的安装指南，可以查看官网安装指南。

升级到最新版本#

如果您定期升级极狐GitLab（例如，每月一次），您可以使用 Linux 发行版的软件包管理器升级到最新版本。

要升级到最新的极狐GitLab 版本：

shell
1# Ubuntu/Debian
2sudo apt update && sudo apt install gitlab-jh
3
4# RHEL/CentOS 7 和 Amazon Linux 2
5sudo yum install gitlab-jh
6
7# RHEL/Almalinux 8/9 和 Amazon Linux 2023
8sudo dnf install gitlab-jh
9
10# SUSE
11sudo zypper install gitlab-jh

升级到特定版本#

Linux 软件包管理器默认安装和升级时安装软件包的最新可用版本。直接升级到最新的主版本可能会对需要多阶段升级路径的旧极狐GitLab 版本造成问题。升级路径可能跨越多个版本，因此您必须在每次升级时指定特定的极狐GitLab 软件包。

要在软件包管理器的安装或升级命令中指定预期的极狐GitLab 版本号：

  1. 确定已安装软件包的版本号：

    shell
    1# Ubuntu/Debian
2sudo apt-cache madison gitlab-jh
3
4# RHEL/CentOS 7 和 Amazon Linux 2
5yum --showduplicates list gitlab-jh
6
7# RHEL/Almalinux 8/9 和 Amazon Linux 2023
8dnf --showduplicates list gitlab-jh
9
10# SUSE
11zypper search -s gitlab-jh

  2. 使用以下命令之一安装特定的 gitlab-jh 软件包，并将 <version> 替换为您要安装的下一个支持版本（请务必查看升级路径以确认您要安装的版本是支持路径的一部分）：

    shell
    1# Ubuntu/Debian
2sudo apt install gitlab-jh=<version>-ee.0
3
4# RHEL/Almalinux 8/9
5sudo dnf install gitlab-jh-<version>-jh.0.el8
6
7# Amazon Linux 2023
8sudo dnf install gitlab-jh-<version>-jh.0.amazon2023

使用下载的软件包#

如果您不想使用官方仓库，可以下载软件包并手动安装。此方法可以用于首次安装极狐GitLab 或升级它。

要下载和安装或升级极狐GitLab：

  1. 转到您的软件包的官方仓库。

  2. 通过搜索您要安装的版本来过滤列表。例如，14.1.8。单个版本可能存在多个软件包，每个支持的发行版和架构一个。文件名旁边有一个标签指示发行版，因为文件名可能相同。

  3. 找到您要安装的软件包版本，并从列表中选择文件名。

  4. 在右上角选择 下载。

  5. 软件包下载完成后，使用以下命令之一安装它，并将 <package_name> 替换为您下载的软件包名称：

    shell
    1# Debian/Ubuntu
2dpkg -i <package_name>
3
4# RHEL/CentOS 7 和 Amazon Linux 2
5rpm -Uvh <package_name>
6
7# RHEL/Almalinux 8/9 和 Amazon Linux 2023
8dnf install <package_name>
9
10# SUSE
11zypper install <package_name>

对于极狐GitLab 基础版，将 gitlab-jh 替换为 gitlab-ce。

升级产品文档（可选）#

如果您安装了产品文档，请参阅如何升级到更高版本。

故障排除#

有关更多信息，请参阅故障排除。