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

クラスタの作成と管理

このページでは、Google Distributed Cloud 接続クラスタリソースを作成して管理する方法について説明します。

Distributed Cloud 接続クラスタの詳細については、Distributed Cloud 接続の仕組みをご覧ください。

Distributed Cloud 接続サーバーと Distributed Cloud 接続のマルチラックデプロイ（ベースラックが 1 つ以上のスタンドアロンラックのリソースを集約する）は、ローカルコントロールプレーンクラスタのみをサポートします。これらのデプロイタイプでは、Cloud コントロールプレーンクラスタを作成できません。

クラスタの作成

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

Google Cloudから一時的に切断された状態でワークロードを実行できるローカルコントロールプレーンを含むクラスタを作成するには、まずサバイバビリティモードをお読みください。

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

コンソール

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

[クラスタ] に移動
[クラスタを作成] をクリックします。
[クラスタを作成] ページで、[オンプレミス] タブをクリックします。
[Distributed Cloud Edge] オプションの横にある [構成] をクリックします。
[クラスタの基本] ページで、次の情報を入力します。
- 名前: このクラスタを識別する一意の名前。この名前は RFC 1213 に準拠し、小文字の英数字とハイフン（-）のみで構成する必要があります。先頭と末尾は英数字にする必要があります。
- ロケーション: このクラスタを作成する Google Cloud リージョン。
- ノードあたりのデフォルトの最大 Pod 数: このクラスタ内の各ノードで実行する Kubernetes Pod の最大数。
- ラベル: [ラベルを追加] をクリックして、このクラスタに 1 つ以上のラベルを追加できます。
左側のナビゲーションで [ネットワーキング] をクリックします。
[ネットワーキング] ページで、次の情報を入力します。
- クラスタのデフォルト Pod のアドレス範囲: このクラスタで実行される Kubernetes Pod の目的の IPv4 CIDR ブロック。
- Service アドレス範囲: このクラスタで実行される Kubernetes Service の目的の IPv4 CIDR ブロック。
詳細については、Distributed Cloud Pod とサービスのネットワークアドレスの割り振りをご覧ください。
左側のナビゲーションで [Authorization] をクリックします。
[承認] ページで、クラスタリソースの変更を承認するターゲット Google Cloud プロジェクト内のユーザーアカウントの名前を指定します。
左側のナビゲーションで、[メンテナンスポリシー] をクリックします。

警告: Distributed Cloud 接続クラスタには、デフォルトのメンテナンスの時間枠がありません。つまり、ソフトウェアアップデートによって重要なワークロードがダウンする可能性があります。高可用性を確保するには、Distributed 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 に設定すると、メンテナンスの時間枠は指定された時間帯に毎日発生します。
次のいずれかの方法で、ノードプールをクラスタに割り当てます。
- 既存のノードプールをこのクラスタに割り当てるには、左側のナビゲーションの [ノードプール] セクションで既存のノードプールを選択し、[ノードプールの詳細] ページのノードプール構成が正しいことを確認します。
- このクラスタに割り当てる新しいノードプールを作成するには、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-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 \
    --offline-reboot-ttl REBOOT_TIMEOUT

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

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）のサポートを有効にするで説明されているように、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 アドレス、アドレス範囲、サブネットワークのカンマ区切りリストを指定します。
SOFTWARE_VERSION: このクラスタで実行する Distributed Cloud 接続ソフトウェアのバージョンを 1.X.Y 形式で指定します。ここで、X はマイナーバージョン、Y はパッチバージョンです（例: 1.5.1）。省略すると、サーバーのデフォルトのソフトウェアバージョン（通常は Distributed Cloud Connected の最新バージョン）がデフォルトになります。サーバーのデフォルトバージョンなど、クラスタ作成に使用できるソフトウェアバージョンを取得するには、クラスタで使用可能なソフトウェアバージョンを取得するをご覧ください。クラスタソフトウェアバージョンを指定するには、RELEASE_CHANNEL フラグを NONE に設定する必要があります。
REBOOT_TIMEOUT:（gcloud alpha が必要）クラスタが存続モードで実行されている間に、クラスタノードが再起動後にクラスタに再参加できる時間枠を秒単位で指定します。省略した場合、デフォルトは 0 になります。この場合、 Google 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",
  "offlineRebootTtl": "REBOOT_TIMEOUT",
}

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

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

デプロイタイプに応じて、Distributed Cloud コネクテッドソフトウェアは次のようにアップグレードされます。

ゾーンごとに 1 つのラックを使用する Distributed Cloud 接続サーバーのデプロイと Distributed Cloud 接続ラックのデプロイの場合、ゾーン内のノードは一度に 1 つずつアップグレードされて再起動されます。
ゾーンごとに複数のラックを使用する Distributed 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。

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

クラスタの作成

コンソール

gcloud

API

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

コンソール

gcloud

API

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

コンソール

gcloud

API

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

gcloud

API

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

gcloud

API

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

gcloud

API

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

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

コンソール

gcloud

API

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

gcloud

API

クラスタの削除

gcloud

API

次のステップ

クラスタの作成と管理

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

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