极狐 GitLab

升级 Linux 软件包实例

Tier: 基础版，专业版，旗舰版

Offering: 私有化部署

升级 Linux 软件包实例的说明取决于您的极狐GitLab 实例是单节点还是多节点。要升级多节点 Linux 软件包极狐GitLab 实例，请参阅：

要升级单节点 Linux 软件包极狐GitLab 实例，请按照本页面的信息操作。

先决条件#

在升级单节点 Linux 软件包极狐GitLab 实例之前：

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

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

尽管如此，您仍应自行维护一份完整且最新的备份。

升级单节点 Linux 软件包实例#

要升级单节点 Linux 软件包实例：

  1. 考虑在升级期间开启维护模式。
  2. 暂停正在运行的 CI/CD 流水线和作业。
  3. 将极狐GitLab Runner 升级到与目标极狐GitLab 版本相同的版本。
  4. 使用 Linux 软件包升级极狐GitLab。

升级之后：

  1. 取消暂停正在运行的 CI/CD 流水线和作业。
  2. 如果已启用，关闭维护模式。
  3. 运行升级健康检查。

使用 Linux 软件包升级#

要升级在单节点上运行的极狐GitLab，或升级属于多节点极狐GitLab 实例的某个节点，可通过以下任一方式升级：

使用官方软件仓库升级（推荐）#

所有极狐GitLab 软件包都会发布到极狐GitLab 软件包服务器。

软件仓库描述
gitlab-jh极狐GitLab 软件包。
gitlab/nightly-builds每夜构建。
gitlab/nightly-fips-builds符合 FIPS 的每夜构建。
gitlab/gitlab-fips符合 FIPS 的构建。

默认情况下，Linux 发行版软件包管理器会安装软件包的最新可用版本。如果您的升级路径需要多个停靠点，则无法直接升级到极狐GitLab 的最新主要版本。如果您的升级路径包含多个版本，则每次升级都必须指定具体的极狐GitLab 软件包版本。

如果您的升级路径没有中间步骤，则可以直接升级到最新版本。

shell
# GitLab (specific version)
sudo apt update && sudo apt install gitlab-jh=<version>-jh.0

# GitLab (latest version)
sudo apt update && sudo apt install gitlab-jh

从官方软件仓库预下载软件包#

为了减少升级期间的安装时间，或测试软件包是否可访问，您可以从官方软件仓库下载软件包，稍后再安装：

shell
# GitLab
sudo apt-get install --download-only gitlab-jh=<version>-jh.0
sudo apt-get install /var/cache/apt/archives/gitlab-jh_<version>-jh.0_amd64.deb

使用下载的软件包升级#

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

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

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

  2. 通过搜索您要安装的版本来筛选列表。例如，18.4.1。同一版本可能存在多个软件包， 每个受支持的发行版和架构各一个。由于某些文件 与多个发行版相关，因此文件名旁边会有一个标签，指示其所属的发行版。

  3. 找到您希望安装的软件包版本，然后从列表中选择文件名。

  4. 在右上角，选择下载。

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

shell
   dpkg -i <package_name>
shell
   rpm -Uvh <package_name>
shell
   dnf install <package_name>
shell
   zypper install <package_name>