このドキュメントでは、Google Distributed Cloud（GDC）エアギャップ環境の複数のゾーンにまたがってリソースを管理する方法について説明します。GDC コンソール、gdcloud CLI、API、Terraform など、どのサーフェスでも、ゾーンリソースの場合は指定されたゾーンで、グローバル プロビジョニングがサポートされているリソースの場合はグローバルで、リソースを適切に管理するメカニズムが用意されています。マルチゾーン環境では、高可用性を実現するためにゾーンリソースとグローバル リソースを管理する必要があります。
このドキュメントは、次のユーザーを対象としています。
- 障害復旧ワークフローの開発を担当する IT 管理者などのプラットフォーム管理者。
- GDC 環境でアプリケーションの開発と保守を担当するアプリケーション デベロッパーなどのアプリケーション オペレーター。
詳細については、 GDC エアギャップ環境のドキュメントの対象読者をご覧ください。
始める前に
ゾーン間でリソースを管理する前に、優先するサーフェスに基づいて次の前提条件を満たす必要があります。
- Distributed Cloud CLI を使用するには、 gdcloud CLI をインストールします。
- ゾーン API とグローバル API のカスタム リソースをデプロイするには、
kubectlコンポーネントをインストールします。 - Terraform を使用するには、 Terraform Kubernetes プロバイダを構成します。
グローバル コンテキストに切り替える
すべてのゾーンにまたがるリソース、またはグローバル プロビジョニングがサポートされているリソースを管理するには、グローバル コンテキストに切り替えます。
コンソール
グローバル コンテキストは、次の構文に従ってグローバル URL に移動することで設定されます。
https://console.ORG_NAME.SUFFIX
グローバル URL に移動すると、ゾーン全体のリソースをグローバルに表示できます。
gdcloud
グローバル URL は、gdcloud CLI のデフォルト構成を初期化するときに organization_console_url パラメータで設定されます
。
ゾーン コンテキストを明示的に
設定していない限り、グローバル コンテキストが想定されます。
グローバル URL に戻すには、次の操作を行います。
デフォルトの組織コンソール URL をグローバル URL に設定します。
gdcloud config set core/organization_console_url GLOBAL_URLグローバル コンテキストにログインします。
gdcloud auth login --login-config-cert=CA_CERTCA_CERTは、システムの信頼できる証明書ストアにインストールされている認証局（CA）証明書に置き換えます。詳細については、 ウェブ TLS 証明書の構成をご覧ください。
API
グローバル KRM API カスタム リソースを管理またはプロビジョニングする場合は、kubectl コマンドでグローバル管理 API サーバーの kubeconfig ファイルを明示的に定義する必要があります。次に例を示します。
kubectl apply -f resource.yaml --kubeconfig GLOBAL_API_SERVER
kubectl コンテキストをグローバル API サーバーに設定すると、API 呼び出しのグローバル コンテキストを自動的に設定できます。詳細については、 グローバル API サーバーのリソースをご覧ください。
Terraform
Terraform モジュールでグローバル管理 API サーバーを明示的に定義して初期化する必要があります。
モジュール内の Terraform ファイル（
main.tfファイルなど）で、グローバル管理 API サーバーの kubeconfig ファイルを定義します。provider "kubernetes" { config_path = "GLOBAL_API_SERVER" }グローバル API サーバーの kubeconfig ファイルの取得方法については、 グローバル API サーバーのリソースをご覧ください。
Terraform モジュールに新しいグローバル コンテキストを適用します。
terraform apply
以降の Terraform アクションはすべてグローバル コンテキストで呼び出されます。
ゾーン コンテキストに切り替える
特定のゾーンでホストされているリソースを管理するには、ゾーン コンテキストに切り替えます。
コンソール
ゾーン コンテキストは、次の構文に従ってゾーン URL に移動することで設定されます。
https://console.ORG_NAME.ZONE.SUFFIX
ゾーン URL に移動すると、単一のゾーン内でホストされているリソースを表示できます。
多くのリソースページには、ゾーン スコープ ピッカーも用意されています。これにより、GDC コンソール ページ内からゾーン コンテキストを切り替えることができます。
提供されているメカニズムからゾーン コンテキストを選択して、ゾーンリソースを表示および管理します。
gdcloud
gdcloud CLI を使用すると、グローバル コンテキストがデフォルトで構成されるため、ゾーンリソースを操作するには、ゾーン コンテキストを明示的に設定する必要があります。この操作は、優先するワークフローに応じて、次の 3 つの方法のいずれかで行うことができます。
- デフォルトのゾーン構成を設定する: 主にゾーン コンテキストで作業する場合におすすめします 。
- ゾーン URL 構成を設定する: グローバル コンテキストとゾーン コンテキストを頻繁に 切り替える場合におすすめします。
--zoneフラグを適用する: gdcloud CLI 構成を更新せずにゾーン コンテキストを直接適用できる柔軟性が必要な場合におすすめします。
次の手順で、いずれかの方法を適用します。
gdcloud CLI インスタンスのゾーン構成を設定します。
gdcloud config set core/zone ZONE_NAMEZONE_NAMEは、コンテキストに設定するゾーンの名前に置き換えます。詳細については、 環境内のゾーンを一覧表示するをご覧ください。
デフォルトの組織コンソール URL をゾーン URL に設定します。
gdcloud config set core/organization_console_url ZONAL_URLゾーンにログインします。
gdcloud auth login --login-config-cert=CA_CERTCA_CERTは、システムの信頼できる証明書ストアにインストールされている認証局（CA） 証明書に置き換えます。詳細については、ウェブ TLS 証明書の構成をご覧ください。
--zoneフラグを指定して gdcloud CLI コマンドを実行します。次に例を示します。gdcloud auth print-identity-token --zone=ZONE_NAME--zoneフラグは、サポートされている任意のコマンドに設定できます。特定のコマンドで--zoneフラグが提供されているかどうかを確認するには、gdcloud CLI リファレンス ドキュメントをご覧ください。--zoneフラグは、グローバル コンテキストまたはゾーン コンテキストから使用できます。
API
ゾーン KRM API カスタム リソースを管理またはプロビジョニングする場合は、kubectl コマンドでゾーン管理 API サーバーの kubeconfig ファイルを明示的に定義する必要があります。次に例を示します。
kubectl apply -f resource.yaml --kubeconfig ZONAL_API_SERVER
kubectl コンテキストをゾーンの管理 API サーバーに設定すると、API 呼び出しのゾーン コンテキストを自動的に設定できます。詳細については、 ゾーン管理 API サーバーのリソースをご覧ください。
Terraform
Terraform モジュールでゾーン管理 API サーバーを明示的に定義して初期化する必要があります。
モジュール内の Terraform ファイル（
main.tfファイルなど）で、ゾーン管理 API サーバーの kubeconfig ファイルを定義します。provider "kubernetes" { config_path = "ZONAL_API_SERVER" }ゾーン管理 API サーバーの kubeconfig ファイルの取得方法については、 ゾーン管理 API サーバーのリソースをご覧ください。
Terraform モジュールに新しいグローバル コンテキストを適用します。
terraform apply
以降の Terraform アクションはすべて、構成したゾーンのコンテキストで呼び出されます。
環境内のゾーンを一覧表示する
複数のゾーンにまたがってゾーンリソースを管理するには、環境内の使用可能なすべてのゾーンを把握する必要があります。
環境内のすべてのゾーンを一覧表示します。
gdcloud zones list出力は次のようになります。
METADATA.NAME us-east1-a us-east1-b us-east1-c
次のステップ
- GDC 環境で使用可能な グローバル API サーバーとゾーン API サーバー について学習する。
- 高可用性ガイドを確認して、アプリケーションがローカル ゾーンの障害に強いことを確認する。
- gdcloud CLI リファレンス ページで、使用可能な gdcloud CLI コマンドの完全なリストを確認する。
- Terraform を構成するには、 Terraform の概要をご覧ください。