このページでは、Google Distributed Cloud クラスタ リソースを作成して管理する方法について説明します。
Distributed Cloud クラスタの詳細については、Distributed Cloud の仕組みをご覧ください。
Distributed Cloud 1.5.x のローカル コントロール プレーン クラスタ
Google が Distributed Cloud デプロイをバージョン 1.5.0 以降に更新した後、Distributed Cloud バージョン 1.4.0 で作成したすべてのローカル コントロール プレーン クラスタを手動で削除して再作成する必要があります。そうしないと、予期しない動作やデータ損失が発生する可能性があります。クラウド コントロール プレーンを使用するように構成されたクラスタは、Google が Distributed Cloud デプロイをバージョン 1.5.0 以降に更新した後も正常に動作し続けます。
クラスタの作成
Distributed Cloud クラスタを作成するには、このセクションの手順を完了します。クラスタの作成は、Distributed Cloud にワークロードをデプロイするために必要な複数の手順の 1 つです。
Google Cloudから一時的に切断された状態でワークロードを実行できるローカル コントロール プレーンを含むクラスタを作成するには、まずサバイバビリティ モードをお読みください。
このタスクを完了するには、 Google Cloud プロジェクトに対する Edge コンテナ管理者ロール（roles/edgecontainer.admin）が必要です。
Distributed Cloud ソフトウェア バージョン 1.5.0 を実行するローカル コントロール プレーン クラスタを作成するには、Google Cloud SDK をバージョン 450.0.0 以降にアップグレードする必要があります。そうしないと、このようなクラスタの作成は失敗します。
コンソール
Google Cloud コンソールで、[クラスタ] ページに移動します。
[クラスタを作成] をクリックします。
[クラスタを作成] ページで、[オンプレミス] タブをクリックします。
[Distributed Cloud Edge] オプションの横にある [構成] をクリックします。
[クラスタの基本] ページで、次の情報を入力します。
- 名前: このクラスタを識別する一意の名前。この名前は RFC 1213 に準拠し、小文字の英数字とハイフン（
-）のみで構成する必要があります。先頭と末尾は英数字にする必要があります。 - ロケーション: このクラスタを作成する Google Cloud リージョン。
- ノードあたりのデフォルトの最大 Pod 数: このクラスタ内の各ノードで実行する Kubernetes Pod の最大数。
- ラベル: [ラベルを追加] をクリックして、このクラスタに 1 つ以上のラベルを追加できます。
- 名前: このクラスタを識別する一意の名前。この名前は RFC 1213 に準拠し、小文字の英数字とハイフン（
左側のナビゲーションで [ネットワーキング] をクリックします。
[ネットワーキング] ページで、次の情報を入力します。
- クラスタのデフォルト Pod のアドレス範囲: このクラスタで実行される Kubernetes Pod の目的の IPv4 CIDR ブロック。
- Service アドレス範囲: このクラスタで実行される Kubernetes Service の目的の IPv4 CIDR ブロック。
詳細については、Distributed Cloud Pod とサービスのネットワーク アドレスの割り振りをご覧ください。
左側のナビゲーションで [Authorization] をクリックします。
[承認] ページで、クラスタ リソースの変更を承認するターゲット Google Cloud プロジェクト内のユーザー アカウントの名前を指定します。
左側のナビゲーションで、[メンテナンス ポリシー] をクリックします。
[メンテナンス ポリシー] ページで、次の情報を入力します。
- メンテナンスの時間枠を有効化: このチェックボックスをオンにして、クラスタのメンテナンスの時間枠を構成します。Distributed Cloud ソフトウェア アップデートによる予期しないダウンタイムを防ぐため、作成する Distributed Cloud クラスタごとにメンテナンス ウィンドウを常に構成することを強くおすすめします。詳細については、ソフトウェア アップデートとメンテナンスの時間枠についてをご覧ください。
- 開始時間: このクラスタのメンテナンス時間枠を開始する希望の日時。
- 終了時間: このクラスタのメンテナンス ウィンドウが終了する日時。
- RRule:
FREQ=WEEKLY|DAILY;BYDAY=MO,TU,WE,TH,FR,SA,SU形式のメンテナンス時間枠の頻度。FREQは、DAILYまたはWEEKLYのいずれかになります。BYDAY:FREQがWEEKLYに設定されている場合にメンテナンスが実施される曜日のカンマ区切りリスト。BYDAYパラメータを省略すると、Google が曜日を自動的に選択します。FREQをDAILYに設定すると、メンテナンスの時間枠は指定された時間帯に毎日発生します。
次のいずれかの方法で、ノードプールをクラスタに割り当てます。
- 既存のノードプールをこのクラスタに割り当てるには、左側のナビゲーションの [ノードプール] セクションで既存のノードプールを選択し、[ノードプールの詳細] ページのノードプール構成が正しいことを確認します。
- このクラスタに割り当てる新しいノードプールを作成するには、[ノードプールを追加] をクリックし、[ノードプールの詳細] ページで次の情報を入力します。
- ノードプール名: このノードプールを識別する一意の名前。
- ノードプールのラベル: [ラベルを追加] をクリックして、このノードプールに 1 つ以上のラベルを追加します。
- ワーカーノードの設定: このノードプールに割り当てる Distributed Cloud ノードを選択します。
Distributed Cloud クラスタを作成するには、[作成] をクリックします。
gcloud
gcloud edge-cloud container clusters create コマンドを使用します。
gcloud edge-cloud container clusters create CLUSTER_ID \
--project=PROJECT_ID \
--location=REGION \
--fleet-project=FLEET_PROJECT_ID \
--cluster-ipv4-cidr=CLUSTER_IPV4_CIDR_BLOCK \
--services-ipv4-cidr=SERVICE_IPV4_CIDR_BLOCK \
--default-max-pods-per-node=MAX_PODS_PER_NODE \
--release-channel RELEASE_CHANNEL \
--control-plane-kms-key=CONTROL_PLANE_KMS_KEY \
--control-plane-node-location=CONTROL_PLANE_LOCATION \
--control-plane-node-count=CONTROL_PLANE_NODE_COUNT \
--control-plane-machine-filter=CONTROL_PLANE_NODE_FILTER \
--control-plane-shared-deployment-policy=CONTROL_PLANE_NODE_SHARING \
--external-lb-ipv4-address-pools=IPV4_DATA_PLANE_ADDRESSES \
--version SOFTWARE_VERSION
次のように置き換えます。
CLUSTER_ID: このクラスタを識別する一意の名前。この名前は RFC 1213 に準拠し、小文字の英数字とハイフン（-）のみで構成する必要があります。先頭と末尾は英数字にする必要があります。PROJECT_ID: ターゲット Google Cloud プロジェクトの ID。REGION: クラスタが作成され、クラスタの Kubernetes コントロール プレーンがプロビジョニングされる Google Cloud リージョン。FLEET_PROJECT_ID: クラスタが登録されているフリート ホスト プロジェクトの ID。このフラグを省略すると、Distributed Cloud クラスタ プロジェクトがフリート ホスト プロジェクトとして使用されます。CLUSTER_IPV4_CIDR_BLOCK: このクラスタで実行される Kubernetes Pod の IPv4 CIDR ブロック。SERVICE_IPV4_CIDR_BLOCK: このクラスタで実行される Kubernetes Service の IPv4 CIDR ブロック。MAX_PODS_PER_NODE（省略可）: このクラスタ内の各ノードで実行する Kubernetes Pod の最大数。RELEASE_CHANNEL:（省略可）: このクラスタで実行する Distributed Cloud ソフトウェアのバージョンのリリース チャネルを指定します。有効な値は、REGULAR（クラスタの自動アップグレードを有効にする）とNONE（クラスタの自動アップグレードを無効にする）です。省略された場合、デフォルトのREGULARになります。CONTROL_PLANE_KMS_KEY（省略可）: このクラスタのコントロール プレーン ノードで使用する Cloud KMS 鍵の完全パス。次に例を示します。/projects/myProject/locations/us-west1-a/keyRings/myKeyRing/cryptoKeys/myGDCE-Key
このフラグは、ローカル ストレージの顧客管理の暗号鍵（CMEK）のサポートを有効にするで説明されているように、Distributed Cloud を Cloud Key Management Service と統合している場合にのみ適用されます。
ローカル コントロール プレーンを使用してクラスタを作成する場合は、上記の変数を置き換えるだけでなく、次の変数も置き換えます。
CONTROL_PLANE_LOCATION: このクラスタのコントロール プレーン ワークロードをローカルにデプロイするように Distributed Cloud に指示します。値は、ターゲットの Distributed Cloud ゾーンの名前です。CONTROL_PLANE_NODE_COUNT（省略可）: ローカル コントロール プレーン ワークロードを実行するノードの数を指定します。有効な値は、高可用性の場合は3、標準オペレーションの場合は1です。省略された場合、デフォルトの3になります。CONTROL_PLANE_NODE_FILTER（省略可）: ローカル コントロール プレーン ワークロードを実行するノードの正規表現形式のリストを指定します。省略すると、Distributed Cloud はノードをランダムに自動的に選択します。CONTROL_PLANE_NODE_SHARING:（省略可）ローカル コントロール プレーン ワークロードを実行するノードでアプリケーション ワークロードを実行できるかどうかを指定します。有効な値はDISALLOWEDとALLOWEDです。省略した場合、デフォルトのDISALLOWEDになります。IPV4_DATA_PLANE_ADDRESSES: クラスタが存続モードで実行されている場合に、Distributed Cloud ロードバランサの背後で実行される Service の上り（内向き）トラフィックの IPv4 アドレス、アドレス範囲、サブネットワークのカンマ区切りリストを指定します。SOFTWARE_VERSION: このクラスタで実行する Distributed Cloud ソフトウェア バージョンを1.X.Y形式で指定します。ここで、Xはマイナー バージョン、Yはパッチ バージョンです（例:1.5.0）。省略すると、サーバーのデフォルトのソフトウェア バージョン（通常は Distributed Cloud の最新バージョン）がデフォルトで使用されます。サーバーのデフォルト バージョンなど、クラスタ作成に使用できるソフトウェア バージョンを取得するには、クラスタで使用可能なソフトウェア バージョンを取得するをご覧ください。
API
projects.locations.clusters メソッドに POST リクエストを送信します。
POST /v1/projects/PROJECT_ID/locations/REGION/clusters?clusterId=CLUSTER_ID&requestId=REQUEST_ID&fleetId=FLEET_PROJECT_ID
{
"labels": { LABELS,
},
"authorization": {
"adminUsers": {
"username": "USERNAME"
}
},
"fleet": {
"project": "FLEET_PROJECT_ID"
},
"networking": {
"clusterIpv4CidrBlocks": CLUSTER_IPV4_CIDR_BLOCK,
"servicesIpv4CidrBlocks": SERVICE_IPV4_CIDR_BLOCK,
},
"defaultMaxPodsPerNode": MAX_PODS_PER_NODE,
"releaseChannel": "RELEASE_CHANNEL",
"controlPlaneEncryption": {
"kmsKey": CONTROL_PLANE_KMS_KEY,
},
"controlPlane": {
"local": {
"nodeLocation": "CONTROL_PLANE_LOCATION",
"nodeCount": CONTROL_PLANE_NODE_COUNT,
"machineFilter": "CONTROL_PLANE_NODE_FILTER",
"sharedDeploymentPolicy": "CONTROL_PLANE_NODE_SHARING"
}
},
"externalLoadBalancerIpv4AddressPools": [
"IPV4_DATA_PLANE_ADDRESSES"
],
"targetVersion": "SOFTWARE_VERSION",
}
次のように置き換えます。
PROJECT_ID: ターゲット Google Cloud プロジェクトの ID。REGION: ターゲット Distributed Cloud クラスタが作成される Google Cloud リージョン。CLUSTER_ID: このクラスタを識別する一意の名前。この名前は RFC 1213 に準拠し、小文字の英数字とハイフン（-）のみで構成する必要があります。先頭と末尾は英数字にする必要があります。REQUEST_ID: このリクエストを識別する一意のプログラム ID。FLEET_PROJECT_ID: クラスタが登録されているフリート ホスト プロジェクトの ID。これは、別のプロジェクトにすることも、このクラスタが属する Distributed Cloud プロジェクト（PROJECT_ID）にすることもできます。フリート登録は必須です。LABELS: このクラスタ リソースに適用するラベルのリスト。USERNAME: クラスタ リソースの変更を承認されたターゲット Google Cloud プロジェクト内のユーザー アカウントの名前。CLUSTER_IPV4_CIDR_BLOCK: このクラスタで実行される Kubernetes Pod の IPv4 CIDR ブロック。SERVICE_IPV4_CIDR_BLOCK: このクラスタで実行される Kubernetes Service の IPv4 CIDR ブロック。MAX_PODS_PER_NODE: このクラスタの各ノードで実行する Kubernetes Pod の最大数。RELEASE_CHANNEL: このクラスタで実行する Distributed Cloud ソフトウェアのバージョンのリリース チャネルを指定します。有効な値はREGULARとNONEです。省略された場合、デフォルトのREGULARになります。CONTROL_PLANE_KMS_KEY（省略可）: このクラスタのコントロール プレーン ノードで使用する Cloud KMS 鍵の完全パス。次に例を示します。/projects/myProject/locations/us-west1-a/keyRings/myKeyRing/cryptoKeys/myGDCE-Key
このパラメータは、ローカル ストレージの顧客管理の暗号鍵（CMEK）のサポートを有効にするで説明されているように、Distributed Cloud を Cloud Key Management Service と統合している場合にのみ適用されます。
ローカル コントロール プレーンを使用してクラスタを作成する場合は、上記の変数を置き換えるだけでなく、次の変数も置き換えます。
CONTROL_PLANE_LOCATION: このクラスタのコントロール プレーン ワークロードをローカルにデプロイするように Distributed Cloud に指示します。値は、ターゲットの Distributed Cloud ゾーンの名前です。CONTROL_PLANE_NODE_COUNT: ローカル コントロール プレーン ワークロードを実行するノードの数を指定します。有効な値は、高可用性の場合は3、標準オペレーションの場合は1です。CONTROL_PLANE_NODE_FILTER（省略可）: ローカル コントロール プレーン ワークロードを実行するノードの正規表現形式のリストを指定します。省略すると、Distributed Cloud はノードをランダムに自動的に選択します。CONTROL_PLANE_NODE_SHARING: ローカル コントロール プレーン ワークロードを実行するノードでアプリケーション ワークロードを実行できるかどうかを指定します。有効な値はDISALLOWEDとALLOWEDです。省略された場合、デフォルトのDISALLOWEDになります。IPV4_DATA_PLANE_ADDRESSES: ローカル コントロール プレーン クラスタの Distributed Cloud ロードバランサの背後で実行される Service の上り（内向き）トラフィックの IPv4 アドレス、アドレス範囲、サブネットワークのカンマ区切りリストを指定します。Cloud コントロール プレーン クラスタには適用されません。SOFTWARE_VERSION: このクラスタで実行する Distributed Cloud ソフトウェア バージョンを1.X.Y形式で指定します。ここで、Xはマイナー バージョン、Yはパッチ バージョンです（例:1.5.0）。省略すると、サーバーのデフォルトのソフトウェア バージョン（通常は Distributed Cloud の最新バージョン）がデフォルトで使用されます。サーバーのデフォルト バージョンなど、クラスタ作成に使用できるソフトウェア バージョンを取得するには、クラスタで使用可能なソフトウェア バージョンを取得するをご覧ください。
リージョン内のクラスタを一覧表示する
Google Cloud リージョンにプロビジョニングされた Distributed Cloud クラスタを一覧表示するには、このセクションの手順を行います。
このタスクを完了するには、 Google Cloud プロジェクトに対する Edge コンテナ閲覧者ロール（roles/edgecontainer.viewer）が必要です。
コンソール
Google Cloud コンソールで、[クラスタ] ページに移動します。
クラスタのリストを確認します。
gcloud
gcloud edge-cloud container clusters list コマンドを使用します。
gcloud edge-cloud container clusters list \
--project=PROJECT_ID \
--location=REGION
次のように置き換えます。
PROJECT_ID: ターゲット Google Cloud プロジェクトの ID。REGION: Distributed Cloud クラスタを作成した Google Cloud リージョン。
API
projects.locations.clusters.list メソッドに GET リクエストを送信します。
GET /v1/projects/PROJECT_ID/locations/REGION/clusters?clusterId=CLUSTER_ID&filter=FILTER&pageSize=PAGE_SIZE&orderBy=SORT_BY&pageToken=PAGE_TOKEN
次のように置き換えます。
PROJECT_ID: ターゲット Google Cloud プロジェクトの ID。REGION: ターゲットの Distributed Cloud クラスタが作成される Google Cloud リージョン。CLUSTER_ID: 対象とするクラスタの名前。FILTER: 返される結果を特定の値に制限する式。PAGE_SIZE: ページごとに返す結果の数SORT_BY: 返される結果の並べ替えの基準とするフィールド名のカンマ区切りリストデフォルトの並べ替え順は昇順です。降順で並べ替えるには、目的のフィールドに~という接頭辞を付けます。PAGE_TOKEN: レスポンスのnextPageTokenフィールドで、最後のリスト リクエストのレスポンスで受け取ったトークン。このトークンを送信して、結果のページを受け取ります。
クラスタに関する情報を取得する
Distributed Cloud クラスタに関する情報を取得するには、このセクションの手順を行います。
このタスクを完了するには、 Google Cloud プロジェクトに対する Edge コンテナ閲覧者ロール（roles/edgecontainer.viewer）が必要です。
コンソール
Google Cloud コンソールで、[クラスタ] ページに移動します。
目的のクラスタを選択します。
クラスタに関する詳細情報を含む折りたたみパネルが右側のペインに表示されます。
gcloud
gcloud edge-cloud container clusters describe コマンドを使用します。
gcloud edge-cloud container clusters describe CLUSTER_ID \
--project=PROJECT_ID \
--location=REGION
次のように置き換えます。
CLUSTER_ID: 対象とするクラスタの名前。PROJECT_ID: ターゲット Google Cloud プロジェクトの ID。REGION: Distributed Cloud ゾーンを作成した Google Cloud リージョン。
API
projects.locations.clusters.get メソッドに GET リクエストを送信します。
GET /v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID
次のように置き換えます。
PROJECT_ID: ターゲット Google Cloud プロジェクトの ID。REGION: ターゲットの Distributed Cloud クラスタが作成される Google Cloud リージョン。CLUSTER_ID: 対象とするクラスタの名前。
クラスタで使用可能なソフトウェア バージョンを取得する
Distributed Cloud ゾーンでクラスタの作成に使用できる Distributed Cloud ソフトウェアのバージョンを確認するには、このセクションの手順を完了します。
このタスクを完了するには、 Google Cloud プロジェクトに対する Edge コンテナ閲覧者ロール（roles/edgecontainer.viewer）が必要です。
gcloud
gcloud edge-cloud container get-server-config コマンドを使用します。
gcloud edge-cloud container get-server-config --location=REGION
REGION: は、Distributed Cloud ゾーンを作成した Google Cloud リージョンに置き換えます。
API
projects.locations.serverConfig メソッドに GET リクエストを送信します。
GET /v1/projects/PROJECT_ID/locations/REGION/serverConfig
次のように置き換えます。
PROJECT_ID: ターゲット Google Cloud プロジェクトの ID。REGION: ターゲットの Distributed Cloud クラスタが作成される Google Cloud リージョン。
ローカル コントロール プレーン クラスタのソフトウェア バージョンをアップグレードする
Distributed Cloud ローカル コントロール プレーン クラスタのソフトウェア バージョンをアップグレードするには、このセクションの手順を完了します。この機能は、Cloud コントロール プレーン クラスタでは使用できません。
このタスクを完了するには、 Google Cloud プロジェクトに対する Edge コンテナ管理者ロール（roles/edgecontainer.admin）が必要です。
gcloud
gcloud edge-cloud container clusters upgrade コマンドを使用します。
gcloud edge-cloud container clusters upgrade CLUSTER_ID \ --location=REGION \ --project=PROJECT_ID \ --schedule=UPGRADE_SCHEDULE \ --version=SOFTWARE_VERSION
次のように置き換えます。
CLUSTER_ID: 対象とするクラスタの名前。REGION: ターゲットの Distributed Cloud クラスタが作成された Google Cloud リージョン。PROJECT_ID: ターゲット Google Cloud プロジェクトの ID。UPGRADE_SCHEDULE: ソフトウェア アップグレードをトリガーするタイミングを指定します。有効な値はIMMEDIATELYのみです。SOFTWARE_VERSION: このクラスタで実行する Distributed Cloud ソフトウェア バージョンを1.X.Y形式で指定します。ここで、Xはマイナー バージョン、Yはパッチ バージョンです（例:1.5.1）。サーバーのデフォルト バージョンなど、クラスタ作成に使用可能なソフトウェア バージョンを取得するには、クラスタで使用可能なソフトウェア バージョンを取得するをご覧ください。
API
projects.locations.clusters.upgrade メソッドに POST リクエストを送信します。
POST /v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID:upgrade?requestId=REQUEST_ID
{
"name": "projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID",
"targetVersion": "SOFTWARE_VERSION",
"schedule": "UPGRADE_SCHEDULE",
}
次のように置き換えます。
PROJECT_ID: ターゲット Google Cloud プロジェクトの ID。REGION: ターゲットの Distributed Cloud クラスタが作成される Google Cloud リージョン。CLUSTER_ID: 対象とするクラスタの名前。REQUEST_ID: このリクエストを識別する一意のプログラム ID。UPGRADE_SCHEDULE: ソフトウェア アップグレードをトリガーするタイミングを指定します。有効な値はIMMEDIATELYのみです。SOFTWARE_VERSION: このクラスタで実行する Distributed Cloud ソフトウェア バージョンを1.X.Y形式で指定します。ここで、Xはマイナー バージョン、Yはパッチ バージョンです（例:1.5.1）。サーバーのデフォルト バージョンなど、クラスタ作成に使用可能なソフトウェア バージョンを取得するには、クラスタで使用可能なソフトウェア バージョンを取得するをご覧ください。
通常、ソフトウェア アップグレードには、クラスタのノードプールに属する各ノードあたり約 2 時間かかります。このコマンドは、ソフトウェア アップグレードの進行状況を追跡できるオペレーションを返します。ソフトウェアのアップグレードが進行中の間、クラスタのステータスは Reconciling に設定され、アップグレードが完了すると Running に戻ります。クラスタのステータスが Error の場合、ソフトウェアのアップグレードが失敗したことを示します。このような場合は、アップグレード プロセスを再度実行します。クラスタのステータスを確認する方法については、クラスタに関する情報を取得するをご覧ください。
クラスタの認証情報を取得する
Distributed Cloud クラスタの認証情報を取得するには、このセクションの手順を行います。
このタスクを完了するには、 Google Cloud プロジェクトに対する Edge コンテナ閲覧者ロール（roles/edgecontainer.viewer）が必要です。
gcloud
gcloud edge-cloud container clusters get-credentials コマンドを使用します。
gcloud edge-cloud container clusters get-credentials CLUSTER_ID \
--project=PROJECT_ID \
--location=REGION
次のように置き換えます。
CLUSTER_ID: 対象とするクラスタの名前。PROJECT_ID: ターゲット Google Cloud プロジェクトの ID。REGION: ターゲットの Distributed Cloud クラスタが作成される Google Cloud リージョン。
API
projects.locations.clusters メソッドに GET リクエストを送信します。
GET /v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID
次のように置き換えます。
PROJECT_ID: ターゲット Google Cloud プロジェクトの ID。REGION: ターゲットの Distributed Cloud ゾーンが作成される Google Cloud リージョン。CLUSTER_ID: 対象とするクラスタの名前。
クラスタのメンテナンスの時間枠を構成する
このセクションでは、Distributed Cloud クラスタのメンテナンスの時間枠を指定してクリアする方法について説明します。
クラスタのメンテナンスの時間枠を指定する
Distributed Cloud クラスタのメンテナンスの時間枠を指定するには、このセクションの手順を行います。クラスタのメンテナンスの詳細については、ソフトウェアの更新とメンテナンスの時間枠についてをご覧ください。
日付と時刻の形式には、RFC 5545 を使用します。
このタスクを完了するには、 Google Cloud プロジェクトに対する Edge コンテナ管理者ロール（roles/edgecontainer.admin）が必要です。
コンソール
Google Cloud コンソールを使用している場合は、クラスタの作成時にのみメンテナンス ウィンドウを指定できます。既存のクラスタでメンテナンス ウィンドウを指定するには、Google Cloud CLI または Distributed Cloud Edge Container API を使用する必要があります。
gcloud
gcloud edge-cloud container clusters update コマンドを使用します。
gcloud edge-cloud container clusters update CLUSTER_ID \
--project=PROJECT_ID \
--location=REGION \
--maintenance-window-start=MAINTENANCE_START \
--maintenance-window-end=MAINTENANCE_END \
--maintenance-window-recurrence=MAINTENANCE_FREQUENCY
次のように置き換えます。
CLUSTER_ID: 対象とするクラスタの名前。PROJECT_ID: ターゲット Google Cloud プロジェクトの ID。REGION: ターゲットの Distributed Cloud クラスタが作成される Google Cloud リージョン。MAINTENANCE_START: メンテナンスの時間枠の開始時刻（YYYY-MM-DDTHH:MM:SSZ形式）。MAINTENANCE_END: メンテナンスの時間枠の終了時刻（YYYY-MM-DDTHH:MM:SSZ形式）。MAINTENANCE_FREQUENCY: メンテナンスの時間枠の頻度（FREQ=WEEKLY|DAILY;BYDAY=MO,TU,WE,TH,FR,SA,SU形式）。BYDAY:FREQがWEEKLYに設定されている場合にメンテナンスが行われる可能性のある曜日のカンマ区切りリスト。BYDAYパラメータを省略すると、曜日が自動的に選択されます。FREQを daily に設定すると、メンテナンスの時間枠は指定された時間帯に毎日発生します。
API
projects.locations.clusters.update メソッドに PATCH リクエストを送信します。
PATCH /v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID?updateMask=maintenancePolicy&requestId=REQUEST_ID
{
"maintenance_policy": {
"window": {
"recurring_window": {
"window": {
"start_time": "MAINTENANCE_START",
"end_time": "MAINTENANCE_END"
},
"recurrence": "MAINTENANCE_FREQUENCY"
}
}
}
}
次のように置き換えます。
PROJECT_ID: ターゲット Google Cloud プロジェクトの ID。REGION: ターゲット Distributed Cloud クラスタが作成される Google Cloud リージョン。CLUSTER_ID: 対象とするクラスタの名前。UPDATE_MASK: このリクエストで更新する完全修飾フィールド名のカンマ区切りリスト（FieldMask 形式）。REQUEST_ID: このリクエストを識別する一意のプログラム ID。CLUSTER_ID: 対象とするクラスタの名前。USERNAME: クラスタ リソースの変更を承認されたターゲット Google Cloud プロジェクト内のユーザー アカウントの名前。MAINTENANCE_START: メンテナンスの時間枠の開始時刻（YYYY-MM-DDTHH:MM:SSZ形式）。MAINTENANCE_END: メンテナンスの時間枠の終了時刻（YYYY-MM-DDTHH:MM:SSZ形式）。MAINTENANCE_FREQUENCY: メンテナンスの時間枠の頻度（FREQ=WEEKLY|DAILY;BYDAY=MO,TU,WE,TH,FR,SA,SU形式）。FREQは、DAILYまたはWEEKLYのいずれかになります。BYDAY:FREQがWEEKLYに設定されている場合にメンテナンスが行われる可能性のある曜日のカンマ区切りリスト。BYDAYパラメータを省略すると、曜日が自動的に選択されます。FREQを daily に設定すると、メンテナンスの時間枠は指定された時間帯に毎日発生します。
詳細については、リソース: クラスタをご覧ください。
クラスタのメンテナンスの時間枠を消去する
Distributed Cloud クラスタのメンテナンス ウィンドウをクリアするには、このセクションの手順を行います。クラスタのメンテナンスの詳細については、ソフトウェアの更新とメンテナンスの時間枠についてをご覧ください。
このタスクを完了するには、 Google Cloud プロジェクトに対する Edge コンテナ管理者ロール（roles/edgecontainer.admin）が必要です。
gcloud
gcloud edge-cloud container clusters update コマンドを使用します。
gcloud edge-cloud container clusters update CLUSTER_ID \
--project=PROJECT_ID \
--location=REGION \
--clear-maintenance-window
次のように置き換えます。
CLUSTER_ID: 対象とするクラスタの名前。PROJECT_ID: ターゲット Google Cloud プロジェクトの ID。REGION: ターゲット Distributed Cloud クラスタが作成される Google Cloud リージョン。
API
projects.locations.clusters.update メソッドに PATCH リクエストを送信します。
PATCH /v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID?updateMask=maintenancePolicy&requestId=REQUEST_ID
{
"maintenance_policy": null
}
次のように置き換えます。
PROJECT_ID: ターゲット Google Cloud プロジェクトの ID。REGION: ターゲット Distributed Cloud クラスタが作成される Google Cloud リージョン。CLUSTER_ID: 対象とするクラスタの名前。UPDATE_MASK: このリクエストで更新する完全修飾フィールド名のカンマ区切りリスト（FieldMask 形式）。REQUEST_ID: このリクエストを識別する一意のプログラム ID。USERNAME: クラスタ リソースの変更を承認されたターゲット Google Cloud プロジェクト内のユーザー アカウントの名前。
詳細については、リソース: クラスタをご覧ください。
クラスタの削除
Distributed Cloud クラスタを削除するには、このセクションの手順を行います。クラスタを削除する前に、次の操作を行う必要があります。
このタスクを完了するには、 Google Cloud プロジェクトに対する Edge コンテナ管理者ロール（roles/edgecontainer.admin）が必要です。
gcloud
gcloud edge-cloud container clusters delete コマンドを使用します。
gcloud edge-cloud container clusters delete CLUSTER_ID \
--project=PROJECT_ID \
--location=REGION
次のように置き換えます。
CLUSTER_ID: 対象とするクラスタの名前。PROJECT_ID: ターゲット Google Cloud プロジェクトの ID。REGION: ターゲットの Distributed Cloud クラスタが作成される Google Cloud リージョン。
API
projects.locations.clusters.delete メソッドに DELETE リクエストを送信します。
DELETE /v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID?requestId=REQUEST_ID
次のように置き換えます。
PROJECT_ID: ターゲット Google Cloud プロジェクトの ID。REGION: ターゲットの Distributed Cloud クラスタが作成される Google Cloud リージョン。CLUSTER_ID: 対象とするクラスタの名前。REQUEST_ID: このリクエストを識別する一意のプログラム ID。
次のステップ
- Distributed Cloud にワークロードをデプロイする
- ゾーンを管理する
- マシンを管理する
- ノードプールを作成して管理する
- VPN 接続を作成して管理する
- 仮想マシンを管理する
- GPU ワークロードを管理する