升级 Linux 软件包安装的实例

升级 Linux 软件包实例到极狐GitLab 的最新版本需要多个步骤,其中许多步骤是 Linux 软件包安装所特有的。

宕机

  • 对于单节点实例,当升级在进行时,用户是无法使用的。用户的 web 浏览器会展示一个 部署中 信息或一个 502 错误。
  • 对于多节点实例,查看如何执行零宕机升级
  • 升级到多节点实例还可以执行宕机升级

跳过自动数据库备份

极狐GitLab 数据库会在新版本安装之前进行备份。您可以通过在 /etc/gitlab/skip-auto-backup 中创建空文件来跳过自动数据库备份:

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

不过,您应该维护完整的最新备份

升级 Linux 软件包实例

要升级 Linux 软件包实例:

  1. 在主要的极狐GitLab 主要文档中完成初始化步骤
  2. 如果您从非软件包安装升级到使用软件包安装的实例,请遵循在从非软件包安装升级到软件包安装文档中的指南
  3. 通过遵循以下内容来继续升级。

需要的服务

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

使用官方仓库(推荐)

所有的极狐GitLab 软件包都会被发布到极狐GitLab 软件包服务器。当然最快速的方式就是使用官方安装页面上提供的安装指南。

升级到最新版本

如果您升级到月度发布的版本(比如,每个月),您可以使用符合您 Linux 发行版的软件包管理器来升级到最新版本。

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

# Ubuntu/Debian
sudo apt update && sudo apt install gitlab-jh

# RHEL/CentOS 7 and Amazon Linux 2
sudo yum install gitlab-jh

# RHEL/Almalinux 8/9 and Amazon Linux 2023
sudo dnf install gitlab-jh

升级到特定版本

Linux package managers default to installing the latest available version of a package for installation and upgrades. Upgrading directly to the latest major version can be problematic for older GitLab versions that require a multi-stage upgrade path. An upgrade path can span multiple versions, so you must specify the specific GitLab package with each upgrade.

To specify the intended GitLab version number in your package manager’s install or upgrade command:

  1. Identify the version number of the installed package:

    # Ubuntu/Debian
    sudo apt-cache madison gitlab-jh
    
    # RHEL/CentOS 7 and Amazon Linux 2
    yum --showduplicates list gitlab-jh
    
    # RHEL/Almalinux 8/9 and Amazon Linux 2023
    dnf --showduplicates list gitlab-jh
    
  2. Install the specific gitlab-ee package by using one of the following commands and replacing <version> with the next supported version you would like to install (make sure to review the upgrade path to confirm the version you’re installing is part of a supported path):

    # Ubuntu/Debian
    sudo apt install gitlab-ee=<version>-ee.0
    
    # RHEL/CentOS 7 and Amazon Linux 2
    sudo yum install gitlab-ee-<version>-ee.0.el7
    
    # RHEL/Almalinux 8/9
    sudo dnf install gitlab-ee-<version>-ee.0.el8
    
    # Amazon Linux 2023
    sudo dnf install gitlab-ee-<version>-ee.0.amazon2023
    
    # OpenSUSE Leap 15.5
    sudo zypper install gitlab-ee=<version>-ee.sles15
    
    # SUSE Enterprise Server 12.2/12.5
    sudo zypper install gitlab-ee=<version>-ee.0.sles12
    

使用下载的软件包安装

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

要下载并安装或升级极狐GitLab:

  1. 前往软件包的官方仓库
  2. 通过搜索您想要安装的版本号进行过滤。比如,16.8.1。针对单个版本可能会存在多个软件包,每个受支持的发行版和架构都有一个软件包。文件名边上是与发行版有关的标签。
  3. 找到您想要安装的软件包版本,并从列表中选择文件名。
  4. 直接下载版本。
  5. 下载软件包后,使用如下命令进行安装,并使用您下载的软件包名称替换 <package_name>

    # Debian/Ubuntu
    dpkg -i <package_name>
    
    # RHEL/CentOS 7 and Amazon Linux 2
    rpm -Uvh <package_name>
    
    # RHEL/Almalinux 8/9 and Amazon Linux 2023
    dnf install <package_name>
    

升级生产文档(可选)

If you installed the product documentation, see how to upgrade to a later version. 如果您安装了生产文档,查看如何升级到最新版本

故障排查

更多详情可查看故障排查