バージョン情報については、Distributed Cloud 接続のリリースノートをご覧ください。

クラスタの作成と管理

このページでは、Google Distributed Cloud 接続クラスタリソースを作成して管理する方法について説明します。Distributed Cloud 接続クラスタの詳細については、Distributed Cloud 接続の仕組みをご覧ください。

前提条件

Distributed Cloud 接続クラスタを作成する前に、ターゲット Google Cloud プロジェクトで必要な API を有効にする必要があります。これを行うには、 Google Cloud プロジェクトで次のいずれかのロールが必要です。

オーナー（roles/owner）
編集者（roles/editor）
Service Usage 管理者（roles/serviceusage.serviceUsageAdmin）

これらのロールの詳細については、基本ロールをご覧ください。ロールの付与については、単一のロールを付与するをご覧ください。

Distributed Cloud 接続クラスタを作成するには、次の API を有効にします。

anthos.googleapis.com
anthosaudit.googleapis.com
anthosgke.googleapis.com
cloudresourcemanager.googleapis.com
connectgateway.googleapis.com
container.googleapis.com
edgecontainer.googleapis.com
gkeconnect.googleapis.com
gkehub.googleapis.com
gkeonprem.googleapis.com
iam.googleapis.com
kubernetesmetadata.googleapis.com
logging.googleapis.com
monitoring.googleapis.com
opsconfigmonitoring.googleapis.com
serviceusage.googleapis.com
stackdriver.googleapis.com
storage.googleapis.com
sts.googleapis.com

API の有効化については、サービスの有効化をご覧ください。

Distributed Cloud 接続クラスタを作成する場合は、次のルールが適用されます。

Distributed Cloud 接続クラスタは、独自の Google Cloud プロジェクトに作成する必要があります。Distributed Cloud 接続クラスタは、Distributed Cloud 接続クラスタ以外のクラスタを含め、他のタイプのクラスタと同じ Google Cloud プロジェクトに共存できません。Distributed Cloud 接続クラスタを同じ Google Cloud プロジェクト内の他のタイプのクラスタと混在させると、データが失われる可能性があります。
Distributed Cloud 接続クラスタ間でノードを再割り当てすると、そのノードは完全に消去され、デフォルトの構成にリセットされます。
デフォルトでは、ローカルコントロールプレーンワークロードは、Distributed Cloud によって自動的に選択された 3 つのノードにまたがる 3 つのレプリカを使用して、高可用性モードで実行されます。これは、クラスタ内のノードが 3 つ未満の場合、またはローカルコントロールプレーンワークロードを実行するために 1 つのノードを使用するようにクラスタを明示的に構成した場合を除き、当てはまります。--control-plane-machine-filter フラグを使用して、高可用性モードの 3 つのノードを指定することもできます。他のノードの組み合わせはサポートされていません。
ローカルコントロールプレーンワークロードを実行するノードは、アプリケーションワークロードも実行します。
ローカルコントロールプレーンエンドポイントの IP アドレスは、ローカルネットワークでアクセスできます。ローカルネットワークのセキュリティ構成で、これらの IP アドレスへの外部アクセスが禁止されていることを確認する必要があります。

クラスタの作成

Distributed Cloud 接続クラスタを作成するには、このセクションの手順を完了します。クラスタの作成は、Distributed Cloud Connected にワークロードをデプロイするために必要な複数の手順の 1 つです。

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

コンソール

Google Cloud コンソールで、Kubernetes の [クラスタ] ページに移動します。

クラスタに移動
[作成] をクリックします。
[クラスタを作成] ページで、[オンプレミス] タブをクリックします。
[Distributed Cloud Edge] オプションの横にある [構成] をクリックします。
[クラスタの基本] ページで、次の情報を入力します。
- 名前: このクラスタを識別する一意の名前。この名前は RFC 1213 に準拠し、小文字の英数字とハイフン（-）のみで構成する必要があります。先頭と末尾は英数字にする必要があります。
- ロケーション: このクラスタを作成する Google Cloud リージョン。
- ノードあたりのデフォルトの最大 Pod 数: このクラスタ内の各ノードで実行する Kubernetes Pod の最大数。
- ラベル: [ラベルを追加] をクリックして、このクラスタに 1 つ以上のラベルを追加できます。
左側のナビゲーションで [コントロールプレーン] をクリックします。
[コントロールプレーン] ページで、次の情報を入力します。
- コントロールプレーンのロケーションとして [ローカル] を選択します。
- ターゲットの Distributed Cloud 接続プロジェクトを選択します。
- 移行先の Distributed Cloud コネクテッドゾーンを選択します。
- 必要に応じて、フィルタ条件を指定して、クラスタに追加する特定の Distributed Cloud マシンを選択します。
- 高可用性クラスタにするかどうかを指定します。
- ワークロードの共有デプロイを許可するかどうかを指定します。これにより、ワークロードはクラスタのコントロールプレーンを実行しているノードで実行できます。
左側のナビゲーションで [ネットワーキング] をクリックします。
[ネットワーキング] ページで、次の情報を入力します。
- クラスタのデフォルト Pod のアドレス範囲: このクラスタで実行される Kubernetes Pod の目的の IPv4 CIDR ブロック。
- Service アドレス範囲: このクラスタで実行される Kubernetes Service の目的の IPv4 CIDR ブロック。
詳細については、Distributed Cloud Pod とサービスのネットワークアドレスの割り振りをご覧ください。
左側のナビゲーションで [Authorization] をクリックします。
[承認] ページで、クラスタリソースの変更を承認するターゲット Google Cloud プロジェクト内のユーザーアカウントの名前を指定します。
次のいずれかの方法で、ノードプールをクラスタに割り当てます。
- 既存のノードプールをこのクラスタに割り当てるには、左側のナビゲーションの [ノードプール] セクションで既存のノードプールを選択し、[ノードプールの詳細] ページのノードプール構成が正しいことを確認します。
- このクラスタに割り当てる新しいノードプールを作成するには、add_box[ノードプールを追加] をクリックし、[ノードプールの詳細] ページで次の情報を入力します。
  - ノードプール名: このノードプールを識別する一意の名前。
  - ノードプールのラベル: [ラベルを追加] をクリックして、このノードプールに 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-node-storage-schema CONTROL_PLANE_STORAGE_SCHEMA \
    --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-address-pools=IPV4_DATA_PLANE_ADDRESSES \
    --version SOFTWARE_VERSION \
    --offline-reboot-ttl REBOOT_TIMEOUT \
    --default-container-runtime RUNTIME_CLASS \
    --enable-google-group-authentication GROUP_AUTHENTICATION

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

CLUSTER_ID: このクラスタを識別する一意の名前。この名前は RFC 1213 に準拠し、小文字の英数字とハイフン（-）のみで構成する必要があります。先頭と末尾は英数字にする必要があります。
PROJECT_ID: ターゲット Google Cloud プロジェクトの ID。
REGION: クラスタが作成される 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 の最大数。省略された場合、デフォルトの 110 になります。この数は、Pod の CIDR ブロックのサイズによって制限されることがあります。
RELEASE_CHANNEL:（省略可）: このクラスタで実行する Distributed Cloud ソフトウェアのバージョンのリリースチャネルを指定します。有効な値は、REGULAR（クラスタの自動アップグレードを有効にする）と NONE（クラスタの自動アップグレードを無効にする）です。省略された場合、デフォルトの REGULAR になります。
CONTROL_PLANE_STORAGE_SCHEMA（省略可）: このクラスタのコントロールプレーンノードのローカルストレージスキーマを指定します。詳細については、ローカルストレージスキーマを構成するをご覧ください。
CONTROL_PLANE_KMS_KEY（省略可）: このクラスタのコントロールプレーンノードで使用する Cloud KMS 鍵の完全パス。次に例を示します。
```
/projects/myProject/locations/us-west1-a/keyRings/myKeyRing/cryptoKeys/myGDCE-Key
```
このフラグは、ローカルストレージの顧客管理の暗号鍵（CMEK）のサポートを有効にするで説明されているように、Cloud Key Management Service と統合された Distributed Cloud Connected を使用している場合にのみ適用されます。
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 アドレス、アドレス範囲、サブネットワークを指定します。カンマ区切りのリスト、または YAML 形式または JSON 形式の構成ファイルを受け入れます。詳細については、ロードバランシングをご覧ください。
SOFTWARE_VERSION: このクラスタで実行する Distributed Cloud 接続ソフトウェアのバージョンを 1.X.Y 形式で指定します。ここで、X はマイナーバージョン、Y はパッチバージョンです（例: 1.5.1）。省略すると、サーバーのデフォルトのソフトウェアバージョン（通常は Distributed Cloud Connected の最新バージョン）がデフォルトになります。サーバーのデフォルトバージョンなど、クラスタ作成に使用できるソフトウェアバージョンを取得するには、クラスタで使用可能なソフトウェアバージョンを取得するをご覧ください。クラスタソフトウェアバージョンを指定するには、RELEASE_CHANNEL フラグを NONE に設定する必要があります。
REBOOT_TIMEOUT: クラスタが存続モードで実行されている間に、再起動後にクラスタノードがクラスタに再参加できる時間枠を秒単位で指定します。省略すると、デフォルトで 0 になり、 Google Cloud への接続が再確立されるまで、再起動されたノードがクラスタに再参加できなくなります。最小タイムアウト値は 1800（30 分）です。この値には ISO 8601 形式（1dT1h2m3s など）を使用することもできます。

注意: 再起動タイムアウトウィンドウを指定すると、指定した時間内にストレージキーを無効にしたり削除したりしても、オフラインになったノードが再起動してクラスタに再参加する可能性があります。このリスクは、タイムアウトウィンドウの長さとともに高まります。
RUNTIME_CLASS: このクラスタ内のワークロードのデフォルトのランタイムクラスを指定します。有効な値は runc と gvisor です。省略した場合、デフォルトは runc です。Pod ランタイムクラスを構成するで説明されているように、Pod 構成でランタイムクラスを指定することでオーバーライドできます。これはプレビューレベルの機能です。

gvisor ランタイムクラスを指定すると、Pod は gVisor に基づく Open Container Initiative（OCI）セキュアランタイムに切り替わります。gVisor は、ワークロードとそのホスト間の強力な分離を導入するサンドボックスソリューションです。これはプレビューレベルのランタイムクラスです。
GROUP_AUTHENTICATION: 個別のアカウントではなく Google グループで認証してクラスタにアクセスできるかどうかを指定します。有効な値は true と false です。省略された場合、デフォルトの false になります。

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"
    }
  },
  "externalLoadBalancerIpAddressPools": [
    "IPV4_DATA_PLANE_ADDRESSES"
  ],
  "targetVersion": "SOFTWARE_VERSION",
  "offlineRebootTtl": "REBOOT_TIMEOUT",
  "defaultContainerRuntime": "RUNTIME_CLASS",
  "enableGoogleGroupAuthentication": "GROUP_AUTHENTICATION",
}

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

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 の最大数。省略した場合、デフォルトは 110 です。この数は、Pod の CIDR ブロックのサイズによっても制限されます。
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）のサポートを有効にするで説明されているように、Cloud Key Management Service と統合された Distributed Cloud Connected を使用している場合にのみ適用されます。
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 アドレス、アドレス範囲、サブネットワークを指定します。カンマ区切りのリスト、または YAML 形式または JSON 形式のペイロードを受け入れます。詳細については、ロードバランシングをご覧ください。
SOFTWARE_VERSION: このクラスタで実行する Distributed Cloud ソフトウェアバージョンを 1.X.Y 形式で指定します。ここで、X はマイナーバージョン、Y はパッチバージョンです（例: 1.5.1）。省略すると、サーバーのデフォルトのソフトウェアバージョン（通常は Distributed Cloud Connected の最新バージョン）がデフォルトになります。サーバーのデフォルトバージョンなど、クラスタ作成に使用できるソフトウェアバージョンを取得するには、クラスタで使用可能なソフトウェアバージョンを取得するをご覧ください。クラスタソフトウェアのバージョンを指定するには、RELEASE_CHANNEL フィールドを NONE に設定する必要があります。
REBOOT_TIMEOUT: クラスタが存続モードで実行されている間に、再起動後にクラスタノードがクラスタに再参加できる時間枠を秒単位で指定します。省略した場合、デフォルトは 0 になります。この場合、 Google Cloud への接続が再確立されるまで、再起動されたノードはクラスタに再参加できません。

注意: 再起動タイムアウトウィンドウを指定すると、指定した時間内にストレージキーを無効にしたり削除したりしても、オフラインになったノードが再起動してクラスタに再参加する可能性があります。
RUNTIME_CLASS: このクラスタ内のワークロードのデフォルトのランタイムクラスを指定します。有効な値は runc と gvisor です。省略した場合、デフォルトは runc です。Pod ランタイムクラスを構成するで説明されているように、Pod 構成でランタイムクラスを指定することでオーバーライドできます。これはプレビューレベルの機能です。

gvisor ランタイムクラスを指定すると、Pod は gVisor に基づく Open Container Initiative（OCI）セキュアランタイムに切り替わります。gVisor は、ワークロードとそのホスト間の強力な分離を導入するサンドボックスソリューションです。これはプレビューレベルのランタイムクラスです。
GROUP_AUTHENTICATION: 個別のアカウントではなく Google グループで認証してクラスタにアクセスできるかどうかを指定します。有効な値は true と false です。省略された場合、デフォルトの false になります。

リージョン内のクラスタを一覧表示する

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 接続クラスタのソフトウェアバージョンをアップグレードするには、このセクションの手順を完了します。

ソフトウェアアップグレードステージのサイズを指定する

このセクションの手順を行う前に、ソフトウェアアップデートの段階的リリースをご覧ください。

ソフトウェアアップグレードで同時にダウンできるノードの数を指定するには、次のコマンドを使用します。

 gcloud edge-cloud container clusters update CLUSTER_ID \
    --project=PROJECT_ID \
    --location=REGION \
    --max-unavailable-worker-nodes=MAX_UNAVAILABLE_NODES

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

CLUSTER_ID: 対象とするクラスタの名前。
PROJECT_ID: ターゲット Google Cloud プロジェクトの ID。
REGION: ターゲットの Distributed Cloud コネクテッドクラスタが作成された Google Cloud リージョン。
MAX_UNAVAILABLE_NODES: ソフトウェアアップグレードで同時にダウンできるワーカーノードの最大数を指定します。

この値をデフォルトにリセットするには、次のコマンドを使用します。

 gcloud edge-cloud container clusters update CLUSTER_ID \
    --project=PROJECT_ID \
    --location=REGION \
    --clear-max-unavailable-worker-nodes

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

CLUSTER_ID: 対象とするクラスタの名前。
PROJECT_ID: ターゲット Google Cloud プロジェクトの ID。
REGION: ターゲットの Distributed Cloud コネクテッドクラスタが作成された Google Cloud リージョン。

クラスタを新しいバージョンの Distributed Cloud Connected ソフトウェアにアップグレードする

このタスクを完了するには、 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.admin）が必要です。

gcloud

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

gcloud edge-cloud container clusters update CLUSTER_ID \
    --project=PROJECT_ID \
    --location=REGION \
    --cluster-ipv4-cidr=CLUSTER_IPV4_CIDR_BLOCK \
    --services-ipv4-cidr=SERVICES_IPV4_CIDR_BLOCK \
    --default-max-pods-per-node=MAX_PODS_PER_NODE \
    --release-channel=RELEASE_CHANNEL \
    --control-plane-kms-key=CONTROL_PLANE_KMS_KEY \
    --offline-reboot-ttl=REBOOT_TIMEOUT \
    --max-unavailable-worker-nodes=MAX_UNAVAILABLE_NODES \
    --default-container-runtime RUNTIME_CLASS \
    --enable-google-group-authentication GROUP_AUTHENTICATION

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

CLUSTER_ID: 対象とするクラスタの名前。
PROJECT_ID: ターゲット Google Cloud プロジェクトの ID。
REGION: ターゲットの Distributed Cloud 接続クラスタが作成される 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）のサポートを有効にするで説明されているように、Cloud Key Management Service と統合された Distributed Cloud Connected を使用している場合にのみ適用されます。
REBOOT_TIMEOUT: クラスタが存続モードで実行されている間に、再起動後にクラスタノードがクラスタに再参加できる時間枠を秒単位で指定します。省略した場合、デフォルトは 0 になります。この場合、 Google Cloud への接続が再確立されるまで、再起動されたノードはクラスタに再参加できません。

注意: 再起動タイムアウトウィンドウを指定すると、指定した時間内にストレージキーを無効にしたり削除したりしても、オフラインになったノードが再起動してクラスタに再参加する可能性があります。
MAX_UNAVAILABLE_NODES（省略可）: ソフトウェアアップグレードで同時にダウンできるワーカーノードの最大数を指定します。省略した場合、デフォルトは X です。これはプレビューレベルの機能です。
RUNTIME_CLASS: このクラスタ内のワークロードのデフォルトのランタイムクラスを指定します。有効な値は runc と gvisor です。省略した場合、デフォルトは runc です。Pod ランタイムクラスを構成するで説明されているように、Pod 構成でランタイムクラスを指定することでオーバーライドできます。Pod レベルまたはクラスタレベルでランタイムクラスを変更した場合は、変更を有効にするために影響を受ける Pod を再起動する必要があります。

gvisor ランタイムクラスを指定すると、Pod は gVisor に基づく Open Container Initiative（OCI）セキュアランタイムに切り替わります。gVisor は、ワークロードとそのホスト間の強力な分離を導入するサンドボックスソリューションです。
GROUP_AUTHENTICATION: 個別のアカウントではなく Google グループで認証してクラスタにアクセスできるかどうかを指定します。有効な値は true と false です。省略された場合、デフォルトの false になります。

API

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

PATCH /v1/projects/PROJECT_ID/locations/REGION/clusters/?updateMask=UPDATE_MASK&requestId=REQUEST_ID
{
 "labels": { LABELS,
  },
  "networking": {
   "ClusterIpv4CidrBlocks": CLUSTER_IPV4_CIDR_BLOCK,
   "servicesIpv4CidrBlocks": SERVICE_IPV4_CIDR_BLOCK,
   },
  "authorization": {
    "adminUsers": {
       "username": USERNAME
    }
  },
  "defaultMaxPodsPerNode": MAX_PODS_PER_NODE,
  "releaseChannel": RELEASE_CHANNEL,
  "controlPlaneEncryption": {
   "kmsKey": CONTROL_PLANE_KMS_KEY,
  },
  "offlineRebootTtl": "REBOOT_TIMEOUT",
  "defaultContainerRuntime": "RUNTIME_CLASS",
  "enableGoogleGroupAuthentication": "GROUP_AUTHENTICATION",
  }

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

PROJECT_ID: ターゲット Google Cloud プロジェクトの ID。
REGION: ターゲットの Distributed Cloud 接続クラスタが作成される Google Cloud リージョン。
CLUSTER_ID: 対象とするクラスタの名前。
UPDATE_MASK: このリクエストで更新する完全修飾フィールド名のカンマ区切りリスト（FieldMask 形式）。
REQUEST_ID: このリクエストを識別する一意のプログラム ID。
CLUSTER_IPV4_CIDR_BLOCK: このクラスタで実行される Kubernetes Pod の IPv4 CIDR ブロック。
SERVICE_IPV4_CIDR_BLOCK: このクラスタで実行される Kubernetes Service の IPv4 CIDR ブロック。
USERNAME: クラスタリソースの変更を承認されたターゲット Google Cloud プロジェクト内のユーザーアカウントの名前。
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）のサポートを有効にするで説明されているように、Cloud Key Management Service と統合された Distributed Cloud Connected を使用している場合にのみ適用されます。
REBOOT_TIMEOUT:（v1alpha1 が必要）クラスタが存続モードで実行されている間に、クラスタノードが再起動後にクラスタに再参加できる時間枠を秒単位で指定します。省略した場合、デフォルトは 0 になります。この場合、 Google Cloud への接続が再確立されるまで、再起動されたノードはクラスタに再参加できません。これはプレビューレベルの機能です。

注意: 再起動タイムアウトウィンドウを指定すると、指定した時間内にストレージキーを無効にしたり削除したりしても、オフラインになったノードが再起動してクラスタに再参加する可能性があります。
RUNTIME_CLASS: このクラスタ内のワークロードのデフォルトのランタイムクラスを指定します。有効な値は runc と gvisor です。省略した場合、デフォルトは runc です。Pod ランタイムクラスを構成するで説明されているように、Pod 構成でランタイムクラスを指定することでオーバーライドできます。Pod レベルまたはクラスタレベルでランタイムクラスを変更した場合は、変更を有効にするために影響を受ける Pod を再起動する必要があります。

gvisor ランタイムクラスを指定すると、Pod は gVisor に基づく Open Container Initiative（OCI）セキュアランタイムに切り替わります。gVisor は、ワークロードとそのホスト間の強力な分離を導入するサンドボックスソリューションです。
GROUP_AUTHENTICATION: 個別のアカウントではなく Google グループで認証してクラスタにアクセスできるかどうかを指定します。有効な値は true と false です。省略された場合、デフォルトの false になります。

クラスタの認証情報を取得する

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 \
    --offline-credential

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

CLUSTER_ID: 対象とするクラスタの名前。
PROJECT_ID: ターゲット Google Cloud プロジェクトの ID。
REGION: ターゲットの Distributed Cloud 接続クラスタが作成される Google Cloud リージョン。

クラスタのオフライン認証情報を生成するには、--offline-credential フラグを指定します。

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: 対象とするクラスタの名前。

Connect ゲートウェイを介してクラスタの認証情報を取得する

Connect Gateway は、kubectl CLI ツールを使用してクラスタにアクセスするためのプロキシとして機能します。Connect ゲートウェイを介してクラスタ認証情報をリクエストする各ユーザーアカウントには、Connect ゲートウェイのドキュメントのユーザーに IAM ロールを付与するで説明されている権限が必要です。

Connect ゲートウェイを介して認証情報をリクエストする前に、次のコマンドを使用して gke-gcloud-auth-plugin プラグインをインストールする必要があります。

 gcloud components install gke-gcloud-auth-plugin

Connect Gateway を介してクラスタ認証情報を取得するには、次のコマンドを使用します。

 gcloud container hub memberships get-credentials CLUSTER_ID --project=PROJECT_ID

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

CLUSTER_ID: 対象とするクラスタの名前。
PROJECT_ID: ターゲット Google Cloud プロジェクトの ID。

クラスタのメンテナンスの時間枠を構成する

このセクションでは、Distributed Cloud 接続クラスタの次のタイプのメンテナンスウィンドウを指定してクリアする方法について説明します。

メンテナンスの時間枠。Google が Distributed Cloud 接続クラスタでメンテナンスとソフトウェアアップグレードを実行できる時間枠を指定します。
メンテナンスの除外の時間枠。Google が 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 接続クラスタのメンテナンス除外期間を指定するには、このセクションの手順を完了します。クラスタのメンテナンスの詳細については、ソフトウェアの更新とメンテナンスの時間枠についてをご覧ください。

日付と時刻の形式には、RFC 3339 を使用します。

このタスクを完了するには、 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 \
    --add-maintenance-exclusion-name=EXCLUSION_NAME \
    --add-maintenance-exclusion-start=EXCLUSION_START \
    --add-maintenance-exclusion-end=EXCLUSION_END

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

CLUSTER_ID: 対象とするクラスタの名前。
PROJECT_ID: ターゲット Google Cloud プロジェクトの ID。
REGION: ターゲットの Distributed Cloud コネクテッドクラスタが作成される Google Cloud リージョン。
EXCLUSION_NAME: このメンテナンス除外ウィンドウのわかりやすい名前。
EXCLUSION_START: メンテナンスの時間枠の開始時刻（YYYY-MM-DDTHH:MM:SSZ 形式）。
EXCLUSION_END: メンテナンスの時間枠の終了時刻（YYYY-MM-DDTHH:MM:SSZ 形式）。

クラスタのメンテナンス除外の時間枠をクリアする

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 \
    --remove-maintenance-exclusion-window=MAINTENANCE_EXCLUSION_WINDOW

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

CLUSTER_ID: 対象とするクラスタの名前。
PROJECT_ID: ターゲット Google Cloud プロジェクトの ID。
REGION: ターゲット Distributed Cloud クラスタが作成される Google Cloud リージョン。
MAINTENANCE_EXCLUSION_WINDOW: クリアするメンテナンス除外ウィンドウの名前。

クラスタの削除

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。

クラスタの作成と管理 コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

前提条件

おすすめのトピック

クラスタの作成

コンソール

gcloud

API

リージョン内のクラスタを一覧表示する

コンソール

gcloud

API

クラスタに関する情報を取得する

コンソール

gcloud

API

クラスタで使用可能なソフトウェア バージョンを取得する

gcloud

API

クラスタのソフトウェア バージョンをアップグレードする

ソフトウェア アップグレード ステージのサイズを指定する

クラスタを新しいバージョンの Distributed Cloud Connected ソフトウェアにアップグレードする

gcloud

API

クラスタを変更する

gcloud

API

クラスタの認証情報を取得する

gcloud

API

Connect ゲートウェイを介してクラスタの認証情報を取得する

クラスタのメンテナンスの時間枠を構成する

クラスタのメンテナンスの時間枠を指定する

コンソール

gcloud

API

クラスタのメンテナンスの時間枠を消去する

gcloud

API

クラスタのメンテナンス除外時間枠を指定する

gcloud

クラスタのメンテナンス除外の時間枠をクリアする

gcloud

クラスタの削除

gcloud

API

次のステップ

クラスタの作成と管理

クラスタで使用可能なソフトウェアバージョンを取得する

クラスタのソフトウェアバージョンをアップグレードする

ソフトウェアアップグレードステージのサイズを指定する