グローバル API サーバーとゾーン API サーバー

Google Distributed Cloud（GDC）エアギャップは、マルチゾーン ユニバースとして動作します。つまり、異なる API サーバーにデプロイされるゾーンリソースとグローバル リソースがあり、これらはシステムによって個別に管理されます。API サーバーは、強力な整合性のあるストレージ バックエンドを使用して API リソースの作成、管理、削除を行うための単一のエンドポイントを提供します。

Management API サーバー

管理 API サーバーには次の 2 つのタイプがあります。

  • グローバル API サーバー
  • ゾーン API サーバー

ユニバースには常に 1 つのグローバル API サーバーのみが存在します。同様に、運用するゾーンごとにゾーン API サーバーがあります。単一ゾーン環境で運用している場合でも、単一ゾーン用のグローバル API サーバーとゾーン API サーバーが 1 つずつ存在します。

ゾーンリソースは、ゾーン API サーバーにデプロイされ、単一のゾーン内で独立して動作します。ゾーンが停止すると、そのゾーンのリソースの一部またはすべてに影響する可能性があります。グローバル リソースはグローバル API サーバーにデプロイされ、複数のゾーンにわたって冗長性をもって動作し、フォールト トレランスを実現します。

ユニバースは、すべてのゾーンにまたがるグローバル API サーバーと、各ゾーン専用のゾーン API サーバーを管理します。

高可用性を実現するためにリソースを適切にデプロイするには、このアーキテクチャを理解する必要があります。一部のリソースはグローバルにデプロイすることも、単一のゾーンで独立して動作することもできますが、グローバルまたはゾーンのみのリソースもあります。詳細については、リソース タイプの該当するドキュメントをご覧ください。

GDC コンソール、gdcloud CLI、API、Terraform の各サーフェスには、指定された管理 API サーバーにリソースを適切にデプロイするメカニズムが用意されています。

GDC コンソール

GDC コンソールには、多くのページにゾーン スコープ ピッカーが表示されます。

ゾーンを選択すると、その特定のゾーンにあるリソースが表示されます。

ゾーン スコープ ピッカーを使用すると、リソース管理タスクの特定のゾーンをターゲットにできます。

リソースが単一のゾーンまたは複数のゾーンにまたがる場合は、ゾーン内デプロイまたはグローバル デプロイの選択に応じて、そのリソースを作成して管理できます。

GDC コンソールでは、ゾーンを動的に選択し、そのロケーションで使用可能なすべての GDC リソースとサービスの包括的なビューを表示できます。

選択したゾーンまたはグローバル コンテキストは、グローバル URL またはゾーン URL に移動することでレンダリングされます。URL は、特定のゾーンまたはグローバル コンテキストでホストされている API サーバーに対応しています。たとえば、グローバル コンテキストを選択すると、グローバル URL に移動します。

https://console.ORG_NAME.SUFFIX

同様に、コンソールで特定のゾーンを選択すると、ゾーン URL に移動します。

https://console.ORG_NAME.ZONE.SUFFIX

gdcloud CLI

gdcloud CLI には、ゾーン API またはグローバル API を操作して、リソースとそのデプロイを管理する方法が用意されています。

  • CLI を使用してゾーン コンソールまたはグローバル コンソールの URL にログインする
  • 特定のゾーン アクションにゾーン CLI フラグを使用する

グローバル URL は、gdcloud CLI を初期化するときにデフォルトで構成されるものです。gdcloud 構成を更新して、ゾーン URL を設定し、それらにログインしてゾーン固有のタスクを完了できます。

同様に、gdcloud CLI には、コマンド グループ全体で多くのリソース管理タスクに設定できる --zone フラグが用意されています。グローバル URL 構成にログインすると、グローバル リソースに対する CLI アクションは、スコープ内のすべてのゾーンに適用されます。

ゾーン サービスとグローバル サービスで gdcloud CLI を使用する方法については、ゾーン間のリソースを管理するをご覧ください。

API と Terraform

KRM API（および Terraform）を使用して、ゾーンまたはグローバル API サーバーをターゲットとし、そこにホストされているリソースを操作できます。GDC には、kubectl を使用して API サーバー コンテキストを設定する方法が用意されています。これにより、適切な API サーバーの kubeconfig ファイルを構成できます。コンテキストを設定すると、ゾーンでホストされているカスタム リソースを適用して操作できます。グローバルにデプロイされている場合は、複数のゾーンにわたって適用して操作できます。

kubectl を使用して API サーバー コンテキストを切り替える方法については、ログインをご覧ください。

次のステップ