GitLab Community Edition 14.3.3を最新バージョンへアップデート
目次
概要
Raspberry Pi 4 Model B 8GBへインストール済みのGitLab Community Edition 14.3.3を 2021/12/2時点で最新バージョンの14.5.1へアップデートします。 公式ドキュメントに沿ったやり方（と言っても一般的なパッケージ更新手順と同じですが）で実施します。 アップデートは単にソフトウェアを最新化するだけではなく、アップデートの過程で データベースのバックアップ、リストアなども自動で行ってくれますので、 アップデートコマンドだけ実行すれば新バージョンに合わせてデータの移行も完了します。 今回は同じメジャーバージョン14の範囲でのアップデートでした。
(2023-10-02追記)
この記事を書いてから約2年後、GitLabのバージョンアップ(v14→v16)を伴うアップグレードをやろうとしたところ、
途中でエラーになって全然アップグレードに成功しない、GitLab自体にもアクセスできなくなる問題に遭遇してしまったので、
対処方法を簡単に追記しておきます。
GitLabのアップグレード（バージョンアップ、リビジョンアップ）は何も考えずに一気に最新版へ更新しようとすると失敗するケースがあります。 例えばバージョン10.3からバージョン12.7へ一気にアップグレードしようとすることはできませんと公式ドキュメントにも書いてあります。 私も14.5.1から16.4.1へアップグレードしようとしたところエラーになってできませんでした。 エラーメッセージを見ると、先にバージョン○○へアップグレードしてくださいといった内容が表示されていました。 GitLabの公式ドキュメントを見ると、明確にアップグレードパスが決まっているようで、目的のバージョンにアップグレードするまでに 途中で別のバージョンへアップグレードする必要があることがわかりました。 私の場合、約2年間もアップグレードをサボっていたので、最新版にするまでに長い道のりになってしまいました。。。 参考までに私のアップグレードパスは以下のとおりで、最新版にするまでに途中に7回中間のアップグレードを挟んで、計8回アップグレードコマンドを実行しました。 マシンがラズパイ4でCPUパワーもI/Oも弱いので、約半日仕事でした。
＜アップグレードパス＞
14.5.1 > 14.9.5 > 14.10.5 > 15.0.5 > 15.4.6 > 15.11.13 > 16.1.5 > 16.3.5 > 16.4.1
でもそのおかげで、完全にすんなり・・・とまではいきませんでしたが、ほぼスムーズにアップグレードできました（後述）。
構成
サーバ構成
OS
AlmaLinux release 8.4 (Electric Cheetah) aarch64
インストール済み主要パッケージ
- gitlab-ce-14.5.1-ce.0.el8.aarch64.rpm
- postfix-3.5.8-1.el8.aarch64.rpm
アップグレードパス
(2023-10-02追記)
GitLabのアップグレードパスを確認する方法を載せておきます。
アップグレードパスは、目的のバージョンへアップグレードする途中に明示的に指定してインストールする一連のバージョンのことを指します。
GitLabのアップグレードパスは以下のページで確認することができます。
■GitLab > Docs > Install > Upgrade GitLab > Upgrade paths https://docs.gitlab.com/ee/update/index.html#upgrade-paths
■Upgrade Path tool
https://gitlab-com.gitlab.io/support/toolbox/upgrade-path/
上記Upgrade Path toolのページにアクセスして、「Current(現在のバージョン)」「Target(ターゲットバージョン)」「Edition(エディション)」「Distro(ディストリビューション)」を入力して[GO!]ボタンをクリックします。 私の場合は以下の通り入力しました。
- Current => 14.5.1
- Target => 16.4.1
- Edition => Community
- Distro => CentOS ※実際にはAlmaLinuxを利用していますが同じRed Hat系なのでこれを選択
アップグレードパスの表示結果は以下の通りでした。
この表示された順に従って、上から順番にバージョンを指定してインストール（アップグレード）を実行しました。 唯一引っかかったのが15.4.6 > 15.11.13のアップグレードのところで、標準出力にRedisのランタイムエラーが出力された結果 「Running reconfigure: NOT OK」と出力されていたので、手動で「gitlab-ctl reconfigure」を実行したのと、 「Checking if a newer PostgreSQL version is available and attempting automatic upgrade to it: NOT OK」と出力されていたので、 手動で「gitlab-ctl pg-upgrade -V 13」を実行しました。 なお、インストールされているPostgreSQLのバージョンは「gitlab-psql --version」で確認でき、手動アップグレード前は12.14と表示されていましたが、 手動アップグレード後は13.11と表示されました。 これでそれ以降のアップグレードは問題なく進みました。
以降の手順はバージョン指定せずにリポジトリで管理されている最新版へアップグレードしようとする場合の手順ですが、 アップグレードパスを見て一発で最新版へアップグレードできない場合は、バージョン指定でインストールしてください。 あとアップグレードとアップデートであまり言葉を使い分けていないので、同じ意味と受け取ってください。 追記した内容は公式ドキュメントに合わせてアップグレードと記載しています。
手順
GitLabのアップデート
インストール済みパッケージのバージョン確認
アップデート前に現在のGitLabのバージョンを確認します。 以下の例では14.3.3のバージョンとなっています。
# rpm -qa | grep gitlab-ce gitlab-ce-14.3.3-ce.0.el8.aarch64
YUMリポジトリの登録（未実施の場合のみ）
GitLabのアップデートは公式のYUMリポジトリから最新バージョンのパッケージをダウンロードしてインストールします。 もしYUMリポジトリを登録していない、もしくは削除してしまっている場合は登録する必要があります。 GitLabのYUMリポジトリを登録するためのシェルスクリプトが公開されているので、curlコマンドでダウンロードして実行します。
# curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.rpm.sh | bash
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 6928 100 6928 0 0 16301 0 --:--:-- --:--:-- --:--:-- 16301
Detected operating system as almalinux/8.
Checking for curl...
Detected curl...
Downloading repository file: https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/config_file.repo?os=almalinux&dist=8&source=script
done.
Installing yum-utils...
gitlab_gitlab-ce-source 461 B/s | 862 B 00:01
Package yum-utils-4.0.21-3.el8.noarch is already installed.
Dependencies resolved.
Nothing to do.
Complete!
Generating yum cache for gitlab_gitlab-ce...
Generating yum cache for gitlab_gitlab-ce-source...
The repository is setup! You can now install packages.
GitLabのアップデート
GitLabを公式のYUMリポジトリからdnf(yum)コマンドでインストールしている場合は、 アップデート方法もdnf(yum)コマンドを実行するだけです。 dnf(yum)でアップデートすると、単にパッケージを最新化するだけでなく、 GitLabの停止や起動、DBに登録されているプロジェクト情報などのバックアップやリストアなども自動でやってくれます。 なのでアップデートコマンドを実行するだけでデータはそのまま使える形で維持されます。 今回はあくまでアップデートなのですが、公式ドキュメントではdnf(yum)のコマンドが update ではなく install と書かれていたので、 そのとおり実行しましたが特に問題ありませんでした。
# dnf -y install gitlab-ce
Last metadata expiration check: 0:00:23 ago on Thu 02 Dec 2021 06:39:18 AM JST.
Package gitlab-ce-14.3.3-ce.0.el8.aarch64 is already installed.
Dependencies resolved.
========================================================================================================================
Package Architecture Version Repository Size
========================================================================================================================
Upgrading:
gitlab-ce aarch64 14.5.1-ce.0.el8 gitlab_gitlab-ce 908 M
Transaction Summary
========================================================================================================================
Upgrade 1 Package
Total download size: 908 M
Downloading Packages:
gitlab-ce-14.5.1-ce.0.el8.aarch64.rpm 11 MB/s | 908 MB 01:24
------------------------------------------------------------------------------------------------------------------------
Total 11 MB/s | 908 MB 01:25
Running transaction check
Transaction check succeeded.
Running transaction test
Transaction test succeeded.
Running transaction
Preparing : 1/1
Running scriptlet: gitlab-ce-14.5.1-ce.0.el8.aarch64 1/2
gitlab preinstall: Checking for unmigrated data on legacy storage
gitlab preinstall: Automatically backing up only the GitLab SQL database (excluding everything else!)
2021-12-02 06:45:28 +0900 -- Dumping database ...
Dumping PostgreSQL database gitlabhq_production ... [DONE]
2021-12-02 06:45:49 +0900 -- done
2021-12-02 06:45:49 +0900 -- Dumping repositories ...
2021-12-02 06:45:49 +0900 -- [SKIPPED]
2021-12-02 06:45:49 +0900 -- Dumping uploads ...
2021-12-02 06:45:49 +0900 -- [SKIPPED]
2021-12-02 06:45:49 +0900 -- Dumping builds ...
2021-12-02 06:45:49 +0900 -- [SKIPPED]
2021-12-02 06:45:49 +0900 -- Dumping artifacts ...
2021-12-02 06:45:49 +0900 -- [SKIPPED]
2021-12-02 06:45:49 +0900 -- Dumping pages ...
2021-12-02 06:45:49 +0900 -- [SKIPPED]
2021-12-02 06:45:49 +0900 -- Dumping lfs objects ...
2021-12-02 06:45:49 +0900 -- [SKIPPED]
2021-12-02 06:45:49 +0900 -- Dumping container registry images ...
2021-12-02 06:45:49 +0900 -- [DISABLED]
Creating backup archive: 1638395149_2021_12_02_14.3.3_gitlab_backup.tar ... done
Uploading backup archive to remote storage ... skipped
Deleting tmp directories ... done
done
Deleting old backups ... skipping
Warning: Your gitlab.rb and gitlab-secrets.json files contain sensitive data
and are not included in this backup. You will need these files to restore a backup.
Please back them up manually.
Backup task is done.
gitlab preinstall: Automatically backing up /etc/gitlab
Could not find '/etc/gitlab/config_backup' directory. Creating.
Running configuration backup
Creating configuration backup archive: gitlab_config_1638395158_2021_12_02.tar
/etc/gitlab/
/etc/gitlab/gitlab.rb.bk20211017
/etc/gitlab/gitlab-secrets.json
/etc/gitlab/initial_root_password
/etc/gitlab/trusted-certs/
/etc/gitlab/gitlab.rb.bk20211017a
/etc/gitlab/gitlab.rb
Configuration backup archive complete: /etc/gitlab/config_backup/gitlab_config_1638395158_2021_12_02.tar
Keeping all older configuration backups
Upgrading : gitlab-ce-14.5.1-ce.0.el8.aarch64 1/2
Running scriptlet: gitlab-ce-14.5.1-ce.0.el8.aarch64 1/2
Cleanup : gitlab-ce-14.3.3-ce.0.el8.aarch64 2/2
Running scriptlet: gitlab-ce-14.3.3-ce.0.el8.aarch64 2/2
Running scriptlet: gitlab-ce-14.5.1-ce.0.el8.aarch64 2/2
Checking PostgreSQL executables:Starting Chef Infra Client, version 15.17.4
resolving cookbooks for run list: ["gitlab::config", "postgresql::bin"]
Synchronizing Cookbooks:
- postgresql (0.1.0)
- gitlab (0.0.1)
- logrotate (0.1.0)
- package (0.1.0)
- redis (0.1.0)
- registry (0.1.0)
- monitoring (0.1.0)
- mattermost (0.1.0)
- gitaly (0.1.0)
- consul (0.1.0)
- letsencrypt (0.1.0)
- nginx (0.1.0)
- praefect (0.1.0)
- gitlab-pages (0.1.0)
- runit (5.1.3)
- crond (0.1.0)
- gitlab-kas (0.1.0)
- acme (4.1.3)
Installing Cookbook Gems:
Compiling Cookbooks...
Converging 4 resources
Recipe: postgresql::bin
* ruby_block[check_postgresql_version] action run (skipped due to not_if)
* ruby_block[check_postgresql_version_is_deprecated] action run (skipped due to not_if)
* ruby_block[Link postgresql bin files to the correct version] action run (skipped due to only_if)
* template[/opt/gitlab/etc/gitlab-psql-rc] action create (up to date)
Running handlers:
Running handlers complete
Chef Infra Client finished, 0/4 resources updated in 23 seconds
Checking PostgreSQL executables: OK
Checking for an omnibus managed postgresql: OKlable and attempting automatic upgrade to it:
Checking if postgresql['version'] is set: OK
Checking if we already upgraded: OK
The latest version 12.7 is already running, nothing to do
Checking if a newer PostgreSQL version is available and attempting automatic upgrade to it: OK
Shutting down all GitLab services except those needed for migrations
ok: down: alertmanager: 0s, normally up
ok: down: gitlab-exporter: 0s, normally up
ok: down: gitlab-workhorse: 0s, normally up
ok: down: grafana: 1s, normally up
ok: down: logrotate: 0s, normally up
ok: down: nginx: 0s, normally up
ok: down: node-exporter: 0s, normally up
ok: down: postgres-exporter: 1s, normally up
timeout: run: prometheus: (pid 187087) 34s, want down, got TERM
ok: down: puma: 0s, normally up
ok: down: redis-exporter: 1s, normally up
ok: down: sidekiq: 1s, normally up
Ensuring the required services are running
ok: run: postgresql: (pid 1219) 107805s
ok: run: redis: (pid 1222) 107805s
ok: run: gitaly: (pid 1220) 107805s
run: postgresql: (pid 1219) 107805s; run: log: (pid 1218) 107805s
run: redis: (pid 1222) 107805s; run: log: (pid 1221) 107805s
run: gitaly: (pid 1220) 107805s; run: log: (pid 1210) 107805s
Ensuring Prometheus is updated:Already running Prometheus version 2.
Ensuring Prometheus is updated: OK
Reconfigure GitLab to apply migrations
Starting Chef Infra Client, version 15.17.4
resolving cookbooks for run list: ["gitlab"]
Synchronizing Cookbooks:
- gitlab (0.0.1)
- package (0.1.0)
- logrotate (0.1.0)
- postgresql (0.1.0)
- registry (0.1.0)
- mattermost (0.1.0)
- monitoring (0.1.0)
- gitaly (0.1.0)
- redis (0.1.0)
- gitlab-pages (0.1.0)
- gitlab-kas (0.1.0)
- nginx (0.1.0)
- letsencrypt (0.1.0)
- consul (0.1.0)
- runit (5.1.3)
- praefect (0.1.0)
- crond (0.1.0)
- acme (4.1.3)
Installing Cookbook Gems:
Compiling Cookbooks...
（ ========== 中略 ========== ）
Notes:
Found old initial root password file at /etc/gitlab/initial_root_password and deleted it.
gitlab Reconfigured!
Restarting previously running GitLab services
ok: run: alertmanager: (pid 187713) 0s
ok: run: gitaly: (pid 1220) 108084s
ok: run: gitlab-exporter: (pid 187716) 1s
ok: run: gitlab-workhorse: (pid 187691) 2s
ok: run: grafana: (pid 187723) 0s
ok: run: logrotate: (pid 187727) 1s
ok: run: nginx: (pid 187733) 0s
ok: run: node-exporter: (pid 187736) 1s
ok: run: postgres-exporter: (pid 187705) 4s
ok: run: postgresql: (pid 1219) 108087s
ok: run: prometheus: (pid 187744) 0s
ok: run: puma: (pid 187749) 0s
ok: run: redis: (pid 1222) 108087s
ok: run: redis-exporter: (pid 187757) 0s
ok: run: sidekiq: (pid 187761) 0s
_______ __ __ __
/ ____(_) /_/ / ____ _/ /_
/ / __/ / __/ / / __ `/ __ \
/ /_/ / / /_/ /___/ /_/ / /_/ /
\____/_/\__/_____/\__,_/_.___/
Upgrade complete! If your GitLab server is misbehaving try running
sudo gitlab-ctl restart
before anything else.
If you need to roll back to the previous version you can use the database
backup made during the upgrade (scroll up for the filename).
Running scriptlet: gitlab-ce-14.3.3-ce.0.el8.aarch64 2/2
Verifying : gitlab-ce-14.5.1-ce.0.el8.aarch64 1/2
Verifying : gitlab-ce-14.3.3-ce.0.el8.aarch64 2/2
Upgraded:
gitlab-ce-14.5.1-ce.0.el8.aarch64
Complete!
アップデート後のバージョン確認
アップデート後にパッケージのバージョンが14.3.3から14.5.1に上がっていることを確認します。
# rpm -qa | grep gitlab-ce gitlab-ce-14.5.1-ce.0.el8.aarch64
アップデート後のGitLabのステータス確認
アップデート後に念の為GitLabの構成機能がすべて起動していることを確認します。
# gitlab-ctl status run: alertmanager: (pid 187713) 358s; run: log: (pid 1245) 108442s run: gitaly: (pid 187800) 333s; run: log: (pid 1210) 108442s run: gitlab-exporter: (pid 187716) 358s; run: log: (pid 1232) 108442s run: gitlab-workhorse: (pid 187691) 359s; run: log: (pid 1230) 108442s run: grafana: (pid 187723) 357s; run: log: (pid 1248) 108442s run: logrotate: (pid 187727) 357s; run: log: (pid 1217) 108442s run: nginx: (pid 187733) 356s; run: log: (pid 1237) 108442s run: node-exporter: (pid 187736) 356s; run: log: (pid 1231) 108442s run: postgres-exporter: (pid 187705) 359s; run: log: (pid 1243) 108442s run: postgresql: (pid 1219) 108442s; run: log: (pid 1218) 108442s run: prometheus: (pid 188192) 41s; run: log: (pid 1240) 108442s run: puma: (pid 187749) 355s; run: log: (pid 1212) 108442s run: redis: (pid 1222) 108442s; run: log: (pid 1221) 108442s run: redis-exporter: (pid 187757) 354s; run: log: (pid 1247) 108442s run: sidekiq: (pid 187761) 354s; run: log: (pid 1235) 108442s