アップグレードパスを計画する
- プラン: Free、Premium、Ultimate
- 提供形態: GitLab Self-Managed
アップグレードパスには、現在のGitLabのバージョンから、アップグレード先のGitLabのバージョンに移行するための手順が含まれます。アップグレードパスを決定するには:
- 必要なアップグレードパスストップを含めて、現在のバージョンがアップグレードパスのどこにあるかを確認します。
- GitLabアップグレードノートを参照してください。
明示的に指定されていない場合でも、GitLabを、最初のパッチリリースではなく、major.minorリリースの利用可能な最新パッチリリースにアップグレードしてください。たとえば、16.8.0の代わりに16.8.7を指定します。
一部のmajor``minorバージョンは、アップグレードプロセスに関連するイシューの修正があるため、一部またはすべての環境で必要な停止点です。
必須アップグレードストップ
アップグレードパスには、必須アップグレードストップが含まれます。これは、GitLabのバージョンのことであり、このバージョンにアップグレードしてから、より新しいバージョンにアップグレードする必要があります。アップグレードパスを進むときは、次のようにします:
- 現在のバージョン以降の必須アップグレードストップにアップグレードします。
- アップグレードのバックグラウンド移行が完了するまで待ちます。
- 次の必須アップグレードストップにアップグレードします。
インスタンス管理者に予測可能なアップグレードスケジュールを提供するために、GitLab 17.5アップグレードパスストップは、x.2.z、x.5.z、x.8.z、x.11.zのバージョンで発生します。
特定のマイナーバージョンで利用可能なパッチリリースを確認するには、GitLabパッケージレジストリでマイナーバージョンを検索します。
GitLab Helmチャートインスタンスをアップグレードする場合は、GitLab Helmチャートマッピングのリストを参照してください。
必須のGitLab 18アップグレード停止
必要なアップグレード停止は、18.2、18.5、18.8、および18.11のバージョンで発生します。
より新しいバージョンにアップグレードする前に、これらのGitLab 18のバージョンにアップグレードする必要があります。アップグレードするバージョンごとに、GitLab 18のアップグレードノートを参照してください。アップグレードノートにバージョンがない場合、注意すべきそのバージョンに固有のものは何もありません。
パッチリリースはGitLabパッケージリポジトリにあります。たとえば、最新のGitLab 18.2 Enterprise Editionバージョンを検索するには、https://packages.gitlab.com/app/gitlab/gitlab-ee/search?q=18.2にアクセスしてください。
必須のGitLab 17アップグレード停止
より新しいバージョンにアップグレードする前に、これらのGitLab 17のバージョンにアップグレードする必要があります。
| 必須バージョン | 備考 |
|---|---|
| 17.11.7 | 最新のGitLab 17.11パッチリリースにアップグレードします。GitLab 17.11.0のアップグレードノートを参照してください。 |
| 17.8.7 | 最新のGitLab 17.8パッチリリースにアップグレードします。GitLab 17.8.0のアップグレードノートを参照してください。 |
| 17.5.5 | 最新のGitLab 17.5パッチリリースにアップグレードします。GitLab 17.5.0のアップグレードノートを参照してください。 |
| 17.3.7 | 最新のGitLab 17.3リリースにアップグレードします。GitLab 17.3.0のアップグレードノートを参照してください。 |
| 17.1.8 | 大規模なci_pipeline_messagesテーブルがあるインスタンスにのみ必要です。GitLab 17.1.0のアップグレードノートを参照してください。 |
必須のGitLab 16アップグレード停止
より新しいバージョンにアップグレードする前に、これらのGitLab 16のバージョンにアップグレードする必要があります。
| 必須バージョン | 備考 |
|---|---|
| 16.11.10 | GitLab 16.11.0のアップグレードノートを参照してください。 |
| 16.7.10 | GitLab 16.8.0のアップグレードノートおよびそれ以降のGitLab 16.7バージョンを参照してください。 |
| 16.3.9 | GitLab 16.3.0のアップグレードノートおよびそれ以降のGitLab 16.3バージョンを参照してください。 |
| 16.2.11 | 大規模なパイプライン変数履歴を持つGitLabインスタンスにのみ必要です。GitLab 16.2.0のアップグレードノートを参照してください。 |
| 16.1.8 | パッケージレジストリにNPMパッケージがあるGitLabインスタンスにのみ必要です。GitLab 16.1.0のアップグレードノートを参照してください。 |
| 16.0.10 | 多数のユーザーまたは大規模なパイプライン変数履歴を持つGitLabインスタンスにのみ必要です。GitLab 16.0.0のアップグレードノートおよびそれ以降のGitLab 16.0バージョンを参照してください。 |
必須のGitLab 15アップグレード停止
より新しいバージョンにアップグレードする前に、これらのGitLab 15のバージョンにアップグレードする必要があります。
| 必須バージョン | 備考 |
|---|---|
| 15.11.13 | GitLab 15.11.0のアップグレードノートおよびそれ以降のGitLab 15.11バージョンを参照してください。 |
| 15.4.6 | GitLab 15.4.0のアップグレードノートおよびそれ以降のGitLab 15.4バージョンを参照してください。 |
| 15.1.6 | 複数のWebノードを持つGitLabインスタンスにのみ必要です。GitLab 15.1.0のアップグレードノートを参照してください。 |
| 15.0.5 | GitLab 15.0のアップグレードノートを参照してください。 |
アップグレードパスツール
現在のGitLabバージョンとアップグレード先のGitLabバージョンに基づいて、必要なアップグレードストップをすばやく計算するには、アップグレードパスツールを参照してください。このツールは、GitLabサポートチームによってメンテナンスされています。
フィードバックを共有し、ツールの改善に協力するには、upgrade-pathプロジェクトでイシューまたはマージリクエストを作成してください。
以前のGitLabバージョン
以前のGitLabバージョンへのアップグレードについては、ドキュメントアーカイブを参照してください。アーカイブ内のドキュメントのバージョンには、さらに以前のバージョンのGitLabに関するバージョン固有の情報が含まれています。