毎度、ググっても出てこない小ネタを取り扱っております。
本記事は個人的な見解であり、筆者の所属するいかなる団体にも関係ございません。
0. はじめに
いつも書いているGitLabのPostgresqlのバージョンアップを実施したという話になります。
■2019年12月10日
OmnibusインストールされたGitLabのPostgreSQLを9.6.14から10.9にアップグレードした話 - Qiita
https://qiita.com/ynott/items/653236f1a5c2ab8cf69f
■2020年05月03日
OmnibusインストールされたGitLab 12.10のPostgreSQLを10.12から11.7にアップグレードした話 - Qiita
https://qiita.com/ynott/items/3b076ef52ad0cd7f9220
■2023年05月28日
OmnibusインストールされたGitLab 13.5.3のPostgreSQLを12.4にアップグレードした話 #PostgreSQL - Qiita
https://qiita.com/ynott/items/73e5f1856637fd218d35
■GitLabで利用できるPostgreSQLの最小バージョン
16.7でのフレッシュインストールが14.9になったのでアップグレードします。
1. GitLab 16.7 で PostgreSQL 14.9にアップグレード
1-1. アップグレードする方法を確認する
データベースアップグレードの方法は、以下にあります。
Database settings | GitLab
https://docs.gitlab.com/omnibus/settings/database.html#upgrade-packaged-postgresql-server
gitlab-ctl pg-upgrade を実行すれば基本的にいいのですが、事前にチェックしておく項目がいくつかあります。
- 最新のGitLabにバージョンアップする
- sudo gitlab-ctl reconfigureがちゃんと通る事を確認する
- ディスク容量が空いている事を確認する
現在のバージョンは以下の通りです。
1-2. sudo gitlab-ctl reconfigure を実行する
反映されていない設定が存在しないか､reconfigureします｡
sudo gitlab-ctl reconfigure
実行結果
$ sudo gitlab-ctl reconfigure
[2023-12-29T12:58:12+09:00] INFO: Started Cinc Zero at chefzero://localhost:1 with repository at /opt/gitlab/embedded (One version per cookbook)
Cinc Client, version 17.10.0
Patents: https://www.chef.io/patents
Infra Phase starting
[2023-12-29T12:58:12+09:00] INFO: *** Cinc Client 17.10.0 ***
<<<中略>>>
[2023-12-29T12:58:33+09:00] INFO: Report handlers complete
Infra Phase complete, 12/719 resources updated in 20 seconds
[2023-12-29T12:58:33+09:00] WARN: This release of Cinc Client became end of life (EOL) on May 1st 2023. Please update to a supported release to receive new features, bug fixes, and security updates.
gitlab Reconfigured!
1-3. 空き容量を確認する
user@gitlab:~$ sudo du -sh /var/opt/gitlab/postgresql/data
657M /var/opt/gitlab/postgresql/data
user@gitlab:~$ df -h
Filesystem Size Used Avail Use% Mounted on
/dev/sde 250G 55G 196G 22% /var/opt/gitlab
1-4. sudo gitlab-ctl pg-upgrade を実行する
以下のコマンドでアップグレードします。
バージョンを指定しなくても問題ないはず。
sudo gitlab-ctl pg-upgrade
sudo gitlab-ctl pg-upgrade コマンドを打って、PostgeSQLのバージョンアップ開始されるまでに30秒猶予が与えられます。なんか止まったとか焦らないようにしましょう。
心の準備ができてない場合は、ctrl+cでキャンセルできます。
アップグレードが開始されるのを30秒正座して待ちましょう。
以下のように出れば成功です！！
user@gitlab:~$ sudo gitlab-ctl pg-upgrade
<<<中略>>>
==== Upgrade has completed ====
Please verify everything is working and run the following if so
sudo rm -rf /var/opt/gitlab/postgresql/data.13
sudo rm -f /var/opt/gitlab/postgresql-version.old
古いファイルは消しましょう。と思って/var/opt/gitlab/postgresql/を見たら、Postgresql 12の時のバックアップが残っていました...。
安全が確認できたら削除する事にします...。
1-5. 確認する
以前は、sudo gitlab-ctl restartしないとバージョンが切り替わりませんでしたが、今回は何もしなくてもリロードするだけで反映されました。
1-6. 古いファイルを削除する
サーバーを管理していていつも緊張するのがファイルの削除です。
さすがに不要なバージョン12の方を先に削除します。
sudo rm -rf /var/opt/gitlab/postgresql/data.12
バージョンファイルも削除していいでしょう。
sudo rm -f /var/opt/gitlab/postgresql-version.old
/var/opt/gitlab/postgresql/data.13はそのうち削除する事にします。
2. まとめ
バージョン12にしたときほどのスピードアップは体感では感じられませませんでしたが、バージョンに追従しておくのは重要です。