• データタイプ
  • Gitリポジトリ
  • ブロブ
  • データベース
• 複製・検証の制限

Geoデータ型のサポート

Geoデータ型は、関連情報を格納するために1つ以上のGitLab機能で必要とされるデータの特定のクラスです。

これらの機能によって生成されたデータをGeoで再現するために、私たちはいくつかの戦略を使ってアクセス、転送、検証を行っています。

データタイプ

現在、私たちは3つの異なるデータタイプを区別しています：

• Gitリポジトリ
• ブロブ
• データベース

レプリケートする各機能やコンポーネント、対応するデータタイプ、レプリケーション、検証方法については、以下のリストをご覧ください：

• (1): RedisレプリケーションはRedisセンチネルとHAの一部として使用できます。 Geoノード間では使用されません。
• (2): オブジェクト ストレージのレプリケーションは、Geo またはオブジェクト ストレージ プロバイダ/アプライアンスのネイティブ レプリケーション機能によって実行できます。

Gitリポジトリ

GitLabインスタンスは1つ以上のリポジトリシャードを持つことができます。 各シャードにはGitalyインスタンスがあり、ローカルに保存されたGitリポジトリへのアクセスとオペレーションを担当します。 シングルディスク、複数のディスクを（RAIDアレイのように）単一のマウントポイントとしてマウントしたマシン、あるいはLVMを使って実行することができます。

特別なファイルシステムを必要とせず、NFSまたはマウントされたストレージアプライアンスで動作します（リモートファイルシステムを使用する場合、パフォーマンスに制限がある場合があります）。

通信はGitaly独自のgRPC APIを介して行われます。 同期には3つの方法があります：

• あるGeoノードから別のGeoノードへの通常のGit clone/fetchを使用します（特別な認証が必要です）。
• リポジトリスナップショットの使用（最初の方法が失敗した場合、またはリポジトリが破損した場合）。
• 管理者UIからの手動トリガー（上記の両方の組み合わせ）。

各プロジェクトは最大3つの異なるリポジトリを持つことができます：

• プロジェクトのリポジトリで、ソースコードが保存されています。
• wikiリポジトリ、wikiコンテンツが保存される場所。
• 設計リポジトリ。設計アーティファクトがインデックス化されています（アセットは実際にはLFSにあります）。

これらはすべて同じシャード内に存在し、Wikiとデザインリポジトリの場合は-wiki と-design のサフィックスを持つ同じベース名を共有します。

ブロブ

GitLabはファイルやイシューの添付ファイルやLFSオブジェクトのようなブロブをどちらかに保存します：

• 特定の場所のファイルシステム。
• オブジェクト・ストレージ・ソリューションオブジェクト・ストレージ・ソリューションには、次のようなものがあります：
  • Amazon S3 Google Cloud Storageのようなクラウドベース。
  • (MinIOのように)あなたによってホストされます。
  • Object Storage互換のAPIを公開するストレージ・アプライアンス。

Object Storageの代わりにファイルシステムストアを使用する場合、複数のサーバーを使用してGitLabを実行するには、ネットワークマウントされたファイルシステムを使用する必要があります。

複製と検証に関して

• 内部APIリクエストを使ってファイルやブロブを転送します。
• オブジェクト・ストレージでは、以下のことが可能です：
  • クラウドプロバイダのレプリケーション機能を使用します。
  • GitLabに複製してもらいましょう。

データベース

PostgreSQLは、イシューの内容やコメント、権限や認証情報のような、Webインターフェイスでユーザーが作成したコンテンツのための単一の真実のポイントです。

PostgreSQLは、HTMLレンダリングされたMarkdown、キャッシュされたマージリクエストの差分（これはオブジェクトストレージにオフロードされるように設定することもできます）のような、ある程度のレベルのキャッシュデータを保持することもできます。

PostgreSQL独自のレプリケーション機能を使用して、プライマリノードから セカンダリノードへデータを複製します。

私たちはRedisをキャッシュストアとして、またバックグラウンドジョブシステム用の永続的なデータを保持するために使用しています。 どちらの用途でも同じGeoノード専用のデータがあるため、ノード間でデータを複製することはありません。

Elasticsearch はオプションのデータベースで、ソースコードレベルと、イシュー/マージリクエストやディスカッションのユーザー生成コンテンツの両方で、改善されたグローバル検索のような高度な検索機能を有効にすることができます。 現在、Geo ではサポートされていません。

複製・検証の制限

次の表は、GitLabの機能とセカンダリノードでのレプリケーションと検証のステータスの一覧です。

これらのエピック／イシューに欠けている項目を実装するための進捗状況を把握することができます：

• 複製されないデータ型
• 複製されたすべてのデータの検証

• (1):インテグリティ・チェック・タスク（Integrity Check Rake Task）を両ノードに適用し、両ノードの出力を比較することで、手動でインテグリティを検証できます。
• (2): GitLabのバージョン11.11.xと12.0.xには、新しいLFSオブジェクトのレプリケーションを妨げるバグがあります。
• (3): Object Storage を使用している場合、サポートされていれば、Object Storage プロバイダーがレプリケーションを実行できます。 Geowith Object Storageを参照してください。