ゾーンを管理する

このページでは、Distributed Cloud デプロイメントで Google Distributed Cloud ゾーンリソースを管理する方法について説明します。API の構造により、Distributed Cloud ゾーン リソースは Distributed Cloud Edge Container API ではロケーションと呼ばれます。 Google Cloud

Distributed Cloud ゾーンの詳細については、 Distributed Cloud の仕組みをご覧ください。

注: このページの Google Cloud CLI の手順は、 Cloud Shell または bash がインストールされた別の環境を使用していることを前提としています。

ゾーンの一覧表示

プロジェクトの Distributed Cloud ゾーンを一覧表示するには、 Google Cloud プロジェクトで このセクションの手順を完了します。

このタスクを完了するには、 Edge Container 閲覧者のロール （roles/edgecontainer.viewer）が Google Cloud プロジェクトに必要です。

コンソール

1. コンソールで、[**エッジゾーン**] ページに移動します。 Google Cloud

   [エッジゾーン] に移動

2. ゾーンとその詳細の一覧を確認します。

gcloud

gcloud edge-cloud container zones list コマンドを使用します。

gcloud edge-cloud container zones list \
    --project=PROJECT_ID
 

PROJECT_ID は、ターゲット Google Cloud プロジェクトの ID に置き換えます。

API

projects.locations.list メソッドに GET リクエストを送信します。

GET /v1/PROJECT_ID/locations?filter=FILTER&pageSize=PAGE_SIZE&orderBy=SORT_BY&pageToken=PAGE_TOKEN

次のように置き換えます。

• PROJECT_ID: ターゲット Google Cloud プロジェクトの ID
• FILTER: 返される結果を特定の値に制限する式。
• PAGE_SIZE: ページごとに返す結果の数
• SORT_BY: 返される結果の並べ替えの基準とするフィールド名のカンマ区切りリスト デフォルトの並べ替え順は昇順です。降順の場合、目的のフィールドに ~ という接頭辞を付けます。
• PAGE_TOKEN: レスポンスの nextPageToken フィールドで最後のリスト リクエストのレスポンスで受信したトークン。このトークンを送信して、結果のページを受け取ります。

ゾーンのネットワーク構成を初期化する

Distributed Cloud ゾーンのネットワーク構成を初期化するには、このセクションの手順を完了します。

ゾーンのネットワーク構成を初期化する前に、まず Distributed Cloud Edge Network API を有効にする必要があります。

このタスクを完了するには、 Edge Network 管理者のロール （roles/edgenetwork.admin）が Google Cloud プロジェクトに必要です。

次のような場合は、Distributed Cloud ゾーンごとにネットワーク構成を初期化する必要があります。

• オンプレミスに Distributed Cloud ハードウェアをインストールした直後。
• 既存の Distributed Cloud デプロイメントで Distributed Cloud バージョン 1.3.0 にアップグレードしたが、Distributed Cloud Edge Network API の限定公開プレビューに参加していない。

ゾーンのネットワーク構成を初期化すると、default という名前のデフォルト ルーターが作成されます。次に、対応する相互接続のアタッチメントを作成して、Distributed Cloud ハードウェアを注文したときにリクエストしたすべての相互接続とピアリングするように default ルーターが構成されます。これにより、Distributed Cloud デプロイメントにローカル ネットワークへの基本的なアップリンク接続が提供されます。

これは 1 回限りの手順です。以降の実行では、既存の Distributed Cloud ネットワーク設定は変更されません。

gcloud

gcloud edge-cloud networking zones init コマンドを使用します。

gcloud edge-cloud networking zones init ZONE_NAME \
    --project=PROJECT_ID \
    --location=REGION

次のように置き換えます。

• ZONE_NAME: ターゲット Distributed Cloud ゾーンの名前。
• PROJECT_ID: ターゲット Google Cloud プロジェクトの ID
• REGION: ターゲット Distributed Cloud ゾーンが作成される Google Cloud リージョン。

API

projects.locations.zones.initialize メソッドに POST リクエストを送信します。

POST /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME:init

次のように置き換えます。

• PROJECT_ID: ターゲット Google Cloud プロジェクトの ID
• REGION: ターゲット Distributed Cloud ゾーンが作成される Google Cloud リージョン。
• ZONE_NAME: ターゲット Distributed Cloud ゾーンの名前。

ゾーンに関する情報を取得する

Distributed Cloud ゾーンに関する情報を取得するには、このセクションの手順を完了します。

このタスクを完了するには、 Edge Container 閲覧者のロール （roles/edgecontainer.viewer）が Google Cloud プロジェクトに必要です。

コンソール

1. コンソールで、[**エッジゾーン**] ページに移動します。 Google Cloud

   [エッジゾーン] に移動

2. 目的のゾーンをクリックします。

   選択したゾーンに関する詳細情報が Google Cloud コンソールに表示されます。

gcloud

gcloud edge-cloud container zones describe コマンドを使用します。

gcloud edge-cloud container zones describe ZONE_NAME \
    --project=PROJECT_ID

次のように置き換えます。

• ZONE_NAME: ターゲット Distributed Cloud ゾーンの名前。
• PROJECT_ID: ターゲット Google Cloud プロジェクトの ID

API

projects.locations.get メソッドに GET リクエストを送信します。

GET /v1/PROJECT_ID/locations/REGION

次のように置き換えます。

• PROJECT_ID: ターゲット Google Cloud プロジェクトの ID
• REGION: ターゲット Distributed Cloud ゾーンが作成される Google Cloud リージョン。

次のステップ

• Google Distributed Cloud にワークロードをデプロイする
• マシンを管理する
• クラスタを作成して管理する
• ネットワークを作成して管理する
• ノードプールを作成して管理する