Geoサイトのアップグレード

プラン: Premium、Ultimate
提供形態: GitLab Self-Managed

Geoサイトを更新する前に、これらのセクションを注意深くお読みください。バージョン固有のアップグレード手順に従わないと、予期しないダウンタイムが発生する可能性があります。ご不明な点がございましたら、サポートにお問い合わせください。データベースのメジャーバージョンをアップグレードするには、GeoセカンダリへのPostgreSQLレプリケーションの再初期化が必要です。これは、Linuxパッケージと外部で管理されるデータベースの両方に適用されます。これにより、予想以上のダウンタイムが発生する可能性があります。

Geoサイトのアップグレードには、次の手順が必要です:

アップグレード元またはアップグレード先のバージョンに応じた、バージョン固有のアップグレード手順:
すべてのアップグレードに関する一般的なアップグレード手順。

一般的なアップグレード手順

これらの一般的なアップグレード手順では、マルチノード構成でのダウンタイムが必要です。ダウンタイムを回避したい場合は、ゼロダウンタイムアップグレードの使用を検討してください。

新しいGitLabバージョンがリリースされたときにGeoサイトをアップグレードするには、プライマリサイトとすべてのセカンダリサイトをアップグレードします:

オプション。各セカンダリサイトでレプリケーションを一時停止して、セカンダリサイトのディザスターリカバリー（DR）機能を保護します。
プライマリサイトの各ノードにSSHで接続します。
プライマリサイトでGitLabをアップグレード。
プライマリサイトでテストを実行します。特に、DRを保護するために手順1でレプリケーションを一時停止した場合はテストを実行します。アップグレード後のテストの詳細については、アップグレードヘルスチェックの実行を参照してください。
プライマリサイトとセカンダリサイトの両方の/etc/gitlab/gitlab-secrets.jsonファイルのシークレットが同じであることを確認してください。ファイルは、サイトのすべてのノードで同じである必要があります。
セカンダリサイトの各ノードにSSHで接続します。
各セカンダリサイトでGitLabをアップグレード。
手順1でレプリケーションを一時停止した場合は、各セカンダリでレプリケーションを再開してください。次に、各セカンダリサイトでPumaとSidekiqを再起動します。これは、以前にアップグレードされたプライマリサイトからレプリケートされるようになった新しいデータベーススキーマに対して初期化されるようにするためです。
```
sudo gitlab-ctl restart sidekiq
sudo gitlab-ctl restart puma
```
プライマリサイトとセカンダリサイトをテストし、それぞれのバージョンを確認します。

アップグレード後のステータスを確認

これでアップグレードプロセスが完了したので、すべてが正しく動作しているかどうかを確認することをお勧めします:

プライマリサイトとセカンダリサイトのアプリケーションノードでGeo Rakeタスクを実行します。すべてが緑色になっているはずです:
```
sudo gitlab-rake gitlab:geo:check
```
プライマリサイトのGeoダッシュボードでエラーがないか確認します。
プライマリサイトにプッシュコードしてデータレプリケーションをテストし、セカンダリサイトで受信されるかどうかを確認します。

問題が発生した場合は、Geoトラブルシューティングガイドを参照してください。