正式なドキュメントは英語版であり、この日本語訳はAI支援翻訳により作成された参考用のものです。日本語訳の一部の内容は人間によるレビューがまだ行われていないため、翻訳のタイミングにより英語版との間に差異が生じることがあります。最新かつ正確な情報については、英語版をご参照ください。

Geo用語集

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

これらの変更を反映するために、Geoドキュメント、ユーザーインターフェース、およびコマンドを更新しています。まだこれらの定義に準拠していないページもあります。

これらは、Geoのすべての側面を説明するために定義された用語です。明確に定義された用語を使用することで、効率的にコミュニケーションを図り、混乱を避けることができます。このページの言語は、ユビキタスであること、そして可能な限りシンプルであることを目指しています。

主な用語

用語の正しい使い方を示すために、図と記述例を示します。

用語定義スコープ推奨されない同義語
Node個々のサーバーは、特定のロールを持つか、全体としてGitLabを実行します(たとえば、Railsアプリケーションノード)。クラウド環境では、これは特定のマシンタイプである可能性があります。GitLabインスタンス、サーバー
サイト単一のGitLabアプリケーションを実行するノードの1つまたはコレクション。サイトは、シングルノードまたはマルチノードにすることができます。GitLabデプロイ、インストールインスタンス
シングルノードサイト1つのノードだけを使用するGitLabの特定設定。GitLabシングルサーバー、シングルインスタンス
マルチノードサイト複数のノードを使用するGitLabの特定設定。GitLabマルチサーバー、マルチインスタンス、高可用性
1つのプライマリサイト。少なくとも1つのセカンダリサイトによってデータがレプリケーションされているGitLabサイト。プライマリサイトは1つしか存在できません。Geo固有Geoデプロイ、プライマリノード
セカンダリサイトプライマリサイトのデータをレプリケーションするように設定されているGitLabサイト。1つまたは複数のセカンダリサイトを設定できます。Geo固有Geoデプロイ、セカンダリノード
Geoデプロイ1つまたは複数のセカンダリサイトによってレプリケーションされるプライマリサイトが1つだけである、2つ以上のGitLabサイトの集合。Geo固有
リファレンスアーキテクチャ:複数のノードと複数のサイトを含む可能性のある、1秒あたりのリクエスト数またはユーザー数に基づくGitLabの指定された設定GitLab
プロモートサイトのロールをセカンダリからプライマリに変更すること。Geo固有
デモートサイトのロールをプライマリからセカンダリに変更すること。Geo固有
フェイルオーバープライマリサイトからセカンダリサイトにユーザーを移行するプロセス全体。これにはセカンダリのプロモートが含まれますが、他の部分も含まれます。たとえば、メンテナンスのスケジュール。Geo固有
レプリケーション「同期」とも呼ばれます。プライマリサイト上のリソースと一致するようにセカンダリサイト上のリソースを更新する一方向プロセス。Geo固有
レプリケーションスロットデータベースとの永続的な接続ポイントを保証し、スタンバイサーバーでまだ必要なWALセグメントを追跡するPostgreSQLレプリケーション機能。サイトのgeo_node_nameに一致するようにレプリケーションスロットに名前を付けると役立つ場合がありますが、必須ではありません。PostgreSQL
検証プライマリサイトに存在するデータとセカンダリサイトにレプリケーションされたデータを比較するプロセス。レプリケートされたデータの整合性を確保するために使用されます。Geo固有
統合URLすべてのGeoサイトに使用される単一の外部URL。リクエストをプライマリGeoサイトまたはセカンダリGeoサイトにルーティングできます。Geo固有
GeoプロキシセカンダリGeoサイトが、セカンダリGeoサイトでローカルに処理できる特定の操作を除き、操作をプライマリサイトに透過的に転送するメカニズム。Geo固有
BlobさまざまなGitLabコンポーネントをカバーするためにレプリケーションできるGeo関連のデータ型。Geo固有ファイル

レプリケーター用語

Geoは、プライマリサイトとセカンダリサイトの間で、個々のGitLabコンポーネントのデータをレプリケートするためにレプリケーターを使用します。これらのコンポーネントの個々のデータ型をどのように処理および検証する必要があるかを定義します。たとえば、GitLabコンテナレジストリのデータは、CIジョブアーティファクトとは異なる方法で処理する必要があります。一部のコンポーネントには、複数のレプリケーターがある場合があり、名前も異なる可能性があります。そのため、次の表では、レプリケーターの名前と、それらが属するGitLabコンポーネントについて説明します。

同じレプリケーター名は、管理者エリアのGeoセクション、またはGeo関連のコンソールコマンドを使用する場合にも表示されます。

Geoレプリケーター名GitLabコンポーネント名
CIセキュアファイルCIセキュアファイル
コンテナリポジトリコンテナレジストリ
依存プロキシblob。依存プロキシイメージ
依存プロキシmanifest。依存プロキシイメージ
設計管理リポジトリプロジェクト設計リポジトリ
グループウィキリポジトリグループウィキリポジトリ
CIジョブアーティファクトCIジョブアーティファクト
LFSオブジェクトLFSオブジェクト
マージリクエストの差分外部マージリクエストの差分
パッケージファイルパッケージレジストリ
ページデプロイPages
パイプラインアーティファクトパイプラインアーティファクト
プロジェクトリポジトリプロジェクトリポジトリ
プロジェクトウィキリポジトリプロジェクトウィキリポジトリ
スニペットリポジトリ個人スニペットとプロジェクトスニペット
TerraformステートバージョンバージョニングされたTerraformステート
アップロードユーザーアップロード

シングルノードサイト

%%{init: { "fontFamily": "GitLab Sans" }}%%
graph TD
    accTitle: Single-node site architecture
    accDescr: A site with one node running GitLab.

   subgraph S-Site[Single-node site]
    Node_3[GitLab node]
  end

マルチノードサイト

%%{init: { "fontFamily": "GitLab Sans" }}%%
graph TD
    accTitle: Multi-node site architecture
    accDescr: A site with multiple nodes running different GitLab components.

   subgraph MN-Site[Multi-node site]
    Node_1[Application node]
    Node_2[Database node]
    Node_3[Gitaly node]
  end

Geoデプロイ - シングルノードサイト

このGeoデプロイには、シングルノードプライマリサイト、シングルノードセカンダリサイトがあります:

%%{init: { "fontFamily": "GitLab Sans" }}%%
graph TD
    accTitle: Geo deployment with single-node sites
    accDescr: A single-node primary site replicating to a single-node secondary site.

   subgraph Geo deployment
   subgraph Primary[Primary site, single-node]
    Node_1[GitLab node]
  end
  subgraph Secondary1[Secondary site 1, single-node]
    Node_2[GitLab node]
   end
   end

Geoデプロイ - マルチノードサイト

このGeoデプロイには、マルチノードプライマリサイト、マルチノードセカンダリサイトがあります:

%%{init: { "fontFamily": "GitLab Sans" }}%%
graph TD
    accTitle: Geo deployment with multi-node sites
    accDescr: A multi-node primary site replicating to a multi-node secondary site.

   subgraph Geo deployment
   subgraph Primary[Primary site, multi-node]
    Node_1[Application node]
    Node_2[Database node]
  end
  subgraph Secondary1[Secondary site 1, multi-node]
    Node_5[Application node]
    Node_6[Database node]
   end
   end

Geoデプロイ - 混合サイト

このGeoデプロイには、マルチノードプライマリサイト、マルチノードセカンダリサイト、および別のシングルノードセカンダリサイトがあります:

%%{init: { "fontFamily": "GitLab Sans" }}%%
graph TD
    accTitle: Geo deployment with mixed site types
    accDescr: A multi-node primary site replicating to both multi-node and single-node secondary sites.

   subgraph Geo deployment
   subgraph Primary[Primary site, multi-node]
    Node_1[Application node]
    Node_2[Database node]
    Node_3[Gitaly node]
  end
  subgraph Secondary1[Secondary site 1, multi-node]
    Node_5[Application node]
    Node_6[Database node]
   end
  subgraph Secondary2[Secondary site 2, single-node]
    Node_7[Single GitLab node]
   end
   end