Linuxパッケージインスタンスをアップグレードする
- プラン: Free、Premium、Ultimate
- 提供形態: GitLab Self-Managed
Linuxパッケージインスタンスをアップグレードする手順は、単一ノードのGitLabインスタンスか、マルチノードのGitLabインスタンスかによって異なります。マルチノードのLinuxパッケージGitLabインスタンスをアップグレードするには、以下を参照してください:
単一ノードのLinuxパッケージGitLabインスタンスをアップグレードするには、このページの情報を参照してください。
製品ドキュメントをホストしている場合は、以降のバージョンにアップグレードすることもできます。
前提要件
単一ノードのLinuxパッケージGitLabインスタンスをアップグレードする前に:
- 必要な情報を読み取り、必要な手順を実行する必要があります。
- 必要に応じて、サポートされているオペレーティングシステムにアップグレードします。
- オペレーティングシステムのアップグレードの際に
glibcのバージョンが変更された場合は、インデックスの破損を避けるために、PostgreSQLのオペレーティングシステムのアップグレードに従う必要があります。 - PostgreSQL、Redis、およびGitalyが実行されていることを確認します。
GitLabデータベースは、新しいGitLabバージョンをインストールする前にバックアップされます。次の場所に空のファイルを作成すると、このデータベースの自動バックアップをスキップできます（/etc/gitlab/skip-auto-backup）:
sudo touch /etc/gitlab/skip-auto-backupただし、ご自身で最新の完全なバックアップを保持しておく必要があります。
単一ノードのLinuxパッケージインスタンスをアップグレードします
単一ノードのLinuxパッケージインスタンスをアップグレードするには:
- アップグレード中にメンテナンスモードをオンにすることを検討してください。
- 実行中のCI/CDパイプラインとジョブを一時停止します。
- GitLabのバージョンと同じバージョンにGitLab Runnerをアップグレードします。
- LinuxパッケージでGitLabをアップグレードする。
アップグレード後:
- 実行中のCI/CDパイプラインとジョブの一時停止を解除します。
- 有効になっている場合は、メンテナンスモードをオフにします。
- アップグレードヘルスチェックを実行します。
Linuxパッケージでアップグレードする
単一ノードで実行されているGitLabをアップグレードするか、マルチノードのGitLabインスタンスの一部であるノードをアップグレードするには、次のいずれかの方法でアップグレードします:
公式リポジトリでアップグレードする（推奨）
すべてのGitLabパッケージは、GitLabパッケージサーバーに公開されています。
| リポジトリ | 説明 |
|---|---|
gitlab/gitlab-ce | Community Edition機能のみを含む簡素化されたパッケージ。 |
gitlab/gitlab-ee | すべてのCommunity Edition機能に加えて、Enterprise Edition機能を含む完全なGitLabパッケージ。 |
gitlab/nightly-builds | 毎日夜間に作成されるビルド。 |
gitlab/nightly-fips-builds | 毎晩FIPS準拠ビルド。 |
gitlab/gitlab-fips | FIPS準拠ビルド。 |
デフォルトでは、Linuxディストリビューションパッケージマネージャーは、利用可能な最新バージョンのパッケージをインストールします。アップグレードで複数の停止が必要な場合、GitLabの最新メジャーバージョンに直接アップグレードすることはできません。アップグレードに複数のバージョンが含まれている場合は、アップグレードごとに特定のGitLabパッケージバージョンを指定する必要があります。
アップグレードに中間ステップがない場合は、最新バージョンに直接アップグレードできます。
# GitLab Enterprise Edition (specific version)
sudo apt update && sudo apt install gitlab-ee=<version>-ee.0
# GitLab Community Edition (specific version)
sudo apt update && sudo apt install gitlab-ce=<version>-ce.0
# GitLab Enterprise Edition (latest version)
sudo apt update && sudo apt install gitlab-ee
# GitLab Community Edition (latest version)
sudo apt update && sudo apt install gitlab-ce# GitLab Enterprise Edition (specific version)
sudo yum install gitlab-ee-<version>-ee.0.amazon2
# GitLab Community Edition (specific version)
sudo yum install gitlab-ce-<version>-ce.0.amazon2
# GitLab Enterprise Edition (latest version)
sudo yum install gitlab-ee
# GitLab Community Edition (latest version)
sudo yum install gitlab-ce# GitLab Enterprise Edition (specific version)
sudo dnf install gitlab-ee-<version>-ee.0.el9
# GitLab Enterprise Edition (specific version)
sudo dnf install gitlab-ee-<version>-ee.0.el8
# GitLab Community Edition (specific version)
sudo dnf install gitlab-ce-<version>-ce.0.el9
# GitLab Community Edition (specific version)
sudo dnf install gitlab-ce-<version>-ce.0.el8
# GitLab Enterprise Edition (latest version)
sudo dnf install gitlab-ee
# GitLab Community Edition (latest version)
sudo dnf install gitlab-ce# GitLab Enterprise Edition (specific version)
sudo dnf install gitlab-ee-<version>-ee.0.amazon2023
# GitLab Community Edition (specific version)
sudo dnf install gitlab-ce-<version>-ce.0.amazon2023
# GitLab Enterprise Edition (latest version)
sudo dnf install gitlab-ee
# GitLab Community Edition (latest version)
sudo dnf install gitlab-ce# GitLab Enterprise Edition (specific version)
sudo zypper install gitlab-ee=<version>-ee.sles15
# GitLab Community Edition (specific version)
sudo zypper install gitlab-ce=<version>-ce.sles15
# GitLab Enterprise Edition (latest version)
sudo zypper install gitlab-ee
# GitLab Community Edition (latest version)
sudo zypper install gitlab-ce# GitLab Enterprise Edition (specific version)
sudo zypper install gitlab-ee=<version>-ee.0.sles12
# GitLab Community Edition (specific version)
sudo zypper install gitlab-ce=<version>-ce.0.sles12
# GitLab Enterprise Edition (latest version)
sudo zypper install gitlab-ee
# GitLab Community Edition (latest version)
sudo zypper install gitlab-ceダウンロードしたパッケージでアップグレードする
公式リポジトリを使用したくない場合は、パッケージをダウンロードして手動でインストールできます。この方法は、GitLabを初めてインストールするか、アップグレードする場合に使用できます。
GitLabをダウンロードしてインストールまたはアップグレードするには、次の手順に従います:
お使いのパッケージの公式リポジトリに移動します。
インストールするバージョンを検索して、リストをフィルタリングします。たとえば、
18.4.1です。単一バージョンに対して複数のパッケージ（サポートされているディストリビューションとアーキテクチャにそれぞれ1つ）が存在する場合があります。一部のファイルは複数のLinuxディストリビューションに関連するため、ファイル名の横にLinuxディストリビューションを示すラベルがあります。インストールするバージョンのパッケージを探し、リストからファイル名を選択します。
右上隅で、ダウンロードを選択します。
パッケージのダウンロード後、次のいずれかのコマンドを使用して、
<package_name>を、ダウンロードしたパッケージ名に置き換えてインストールします:dpkg -i <package_name>rpm -Uvh <package_name>dnf install <package_name>zypper install <package_name>