Geoをセットアップする
- プラン: Premium、Ultimate
- 提供形態: GitLab Self-Managed
前提要件
独立して動作するGitLabサイトが2つ以上必要です:
1つのGitLabサイトが、Geoのプライマリサイトとして機能します。これを設定するには、GitLabリファレンスアーキテクチャドキュメントを使用してください。各Geoサイトに異なるリファレンスアーキテクチャのサイズを使用できます。すでに使用中のGitLabインスタンスがある場合は、プライマリサイトとして使用できます。
2番目のGitLabサイトは、Geoのセカンダリサイトとして機能します。これを設定するには、GitLabリファレンスアーキテクチャドキュメントを使用してください。サインインしてテストすることをお勧めします。ただし、all of the data on the secondary are lost（セカンダリ）上のすべてのデータは、プライマリサイトからのレプリケーションのプロセスの一部として失われることに注意してください。
Geoは複数のセカンダリをサポートしています。同じ手順に従って、必要に応じて変更を加えることができます。
プライマリサイトがGeoのロックを解除するには、GitLab PremiumまたはUltimateプランのサブスクリプションが必要です。すべてのサイトに必要なライセンスは1つだけです。
すべてのサイトがGeoの実行要件を満たしていることを確認します。たとえば、サイトは同じGitLabバージョンを使用する必要があり、サイトは特定のポートを介して相互に通信できる必要があります。
プライマリサイトとセカンダリサイトのストレージ設定が一致することを確認します。プライマリGeoサイトがオブジェクトストレージを使用している場合、セカンダリGeoサイトもそれを使用する必要があります。詳細については、オブジェクトストレージでのGeoを参照してください。
プライマリサイトとセカンダリサイトの間でクロックが同期されていることを確認します。Geoが正しく機能するためには、同期されたクロックが必要です。たとえば、プライマリサイトとセカンダリサイト間のクロックドリフトが1分を超えると、レプリケーションが失敗します。
Linuxパッケージを使用してGitLabをインストールする場合
Linuxパッケージを使用してGitLabをインストールした場合（強く推奨）、Geoをセットアップするプロセスは、シングルノードのGeoサイトまたはマルチノードのGeoサイトをセットアップする必要があるかどうかによって異なります。
シングルノードGeoサイト
両方のGeoサイトが1Kリファレンスアーキテクチャに基づいている場合は、2つのシングルノードサイトのGeoのセットアップに従ってください。
外部PostgreSQLサービス（たとえば、Amazon Relational Database Service）を使用している場合は、（外部PostgreSQLサービスを使用した）2つのシングルノードサイトのGeoのセットアップに従ってください。
GitLabのデプロイによっては、LDAP、オブジェクトストレージ、およびコンテナレジストリの追加設定が必要になる場合があります。
マルチノードGeoサイト
サイトの1つ以上が40 RPS / 2,000ユーザーリファレンスアーキテクチャ以上を使用している場合は、マルチノードのGeoの設定を参照してください。
GitLabのデプロイによっては、LDAP、オブジェクトストレージ、およびコンテナレジストリの追加設定が必要になる場合があります。
参照用の一般的な手順
- 選択したPostgreSQLインスタンスに基づいてデータベースレプリケーションをセットアップします（
primary (read-write) <-> secondary (read-only)トポロジ）: - プライマリサイトとプライマリサイトを設定するには、セカンダリ。
- Geoサイトの使用ガイドに従ってください。
GitLabのデプロイによっては、LDAP、オブジェクトストレージ、およびコンテナレジストリの追加設定が必要になる場合があります。
追加の設定
GitLabの使用方法によっては、次の設定が必要になる場合があります:
- プライマリサイトがオブジェクトストレージを使用している場合は、セカンダリサイトのセカンダリ。
- LDAPを使用する場合は、セカンダリサイトのセカンダリ。詳細については、GeoでのLDAPを参照してください。
- コンテナレジストリを使用する場合は、プライマリサイトとプライマリでセカンダリ。
すべてのGeoサイトに単一の統一URLを使用するには、統合URLを設定する必要があります。
GitLabチャートの使用
GitLab Geoを使用してGitLabチャートを設定します。
Geoとセルフコンパイルインストール
自己コンパイルされたGitLabインスタンスを使用する場合、Geoはサポートされていません。
インストール後の作業に関するドキュメント
セカンダリサイトにGitLabをインストールして初期設定を実行した後、インストール後の情報については次のドキュメントを参照してください。