如需了解版本信息，请参阅 Distributed Cloud Connected 版本说明。

创建和管理集群

本页面介绍如何创建和管理 Google Distributed Cloud 已连接集群资源。

如需详细了解 Distributed Cloud Connected 集群，请参阅 Distributed Cloud Connected 的工作原理。

Distributed Cloud 连接服务器和 Distributed Cloud 连接服务器的多机架部署（其中基本机架聚合了一个或多个独立机架的资源）仅支持本地控制平面集群。您无法在这些部署类型上创建 Cloud 控制平面集群。

创建集群

如需创建 Distributed Cloud 已连接集群，请完成本部分中的步骤。创建集群是在 Distributed Cloud Connected 上部署工作负载所需的多个步骤之一。

如需创建具有本地控制平面的集群，以便在暂时与 Google Cloud断开连接时运行工作负载，请先阅读可续航模式。

如需完成此任务，您必须在 Google Cloud 项目中拥有 Edge Container Admin 角色 (roles/edgecontainer.admin)。

控制台

在 Google Cloud 控制台中，前往集群页面。

转到集群
点击创建集群。
在创建集群页面上，点击本地标签页。
在 Distributed Cloud Edge 选项旁边，点击配置。
在集群基本信息页面上，提供以下信息：
- 名称：用于标识此集群的唯一名称。此名称必须符合 RFC 1213 标准，并且只能包含小写字母数字字符和连字符 (-)。它必须以字母数字字符开头和结尾。
- 位置：您要在其中创建此集群的 Google Cloud 区域。
- 每个节点的默认 Pod 数上限：要在相应集群中每个节点上执行的 Kubernetes Pod 的所需上限数量。
- 标签：点击 添加标签，即可为此集群添加一个或多个标签。
在左侧导航栏中，点击网络。
在网络页面上，提供以下信息：
- 集群默认 Pod 地址范围：在此集群上运行的 Kubernetes Pod 所需的 IPv4 CIDR 块。
- 服务地址范围：在此集群上运行的 Kubernetes 服务的所需 IPv4 CIDR 地址块。
如需了解详情，请参阅分布式云 Pod 和服务网络地址分配。
在左侧导航栏中，点击授权。
在授权页面上，提供目标 Google 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添加节点池，然后在节点池详情页面上提供以下信息：
  - 节点池名称：用于标识此节点池的唯一名称。
  - 节点池标签：点击 添加标签，为相应节点池添加一个或多个标签。
  - 工作器节点偏好设置：选择要分配给此节点池的分布式云连接节点。
如需创建分布式 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：创建集群的 Google Cloud 区域，以及为集群预配 Kubernetes 控制平面的区域。
FLEET_PROJECT_ID：集群注册到的舰队宿主项目的 ID。如果省略此标志，则 Distributed Cloud Connected Cluster 项目将用作舰队宿主项目。
CLUSTER_IPV4_CIDR_BLOCK：在此集群上运行的 Kubernetes Pod 的所需 IPv4 CIDR 地址块。
SERVICE_IPV4_CIDR_BLOCK：在此集群上运行的 Kubernetes 服务的所需 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
```
只有在您已将 Distributed Cloud Connected 与 Cloud Key Management Service 集成（如为本地存储启用对客户管理的加密密钥 (CMEK) 的支持中所述）时，此标志才适用。

如果您要创建具有本地控制平面的集群，除了替换上述变量之外，还要替换以下变量：

CONTROL_PLANE_LOCATION：指示 Distributed Cloud 在本地部署相应集群的控制平面工作负载。该值是目标 Distributed Cloud connected 可用区的名称。
CONTROL_PLANE_NODE_COUNT（可选）：指定运行本地控制平面工作负载的节点数量。有效值为 3（表示高可用性）和 1（表示标准操作）。如果省略，则默认为 3。
CONTROL_PLANE_NODE_FILTER（可选）：指定运行本地控制平面工作负载的节点的正则表达式格式列表。如果省略，Distributed Cloud 会自动随机选择节点。
CONTROL_PLANE_NODE_SHARING：（可选）指定应用工作负载是否可以在运行本地控制平面工作负载的节点上运行。有效值为 DISALLOWED 和 ALLOWED。如果省略，则默认为 DISALLOWED。
IPV4_DATA_PLANE_ADDRESSES：指定以英文逗号分隔的 IPv4 地址、地址范围或子网列表，用于在集群以可维护性模式运行时，为在分布式云负载均衡器后运行的服务设置入站流量。
SOFTWARE_VERSION：指定您希望此集群运行的 Distributed Cloud Connected 软件版本，格式为 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 connected 集群的 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 服务的所需 IPv4 CIDR 地址块。
MAX_PODS_PER_NODE：要在相应集群中的每个节点上执行的 Kubernetes Pod 的所需上限数量。
RELEASE_CHANNEL：（可选）：指定您希望此集群运行的 Distributed Cloud Connected 软件版本的发布渠道。有效值为 REGULAR（启用自动集群升级）和 NONE（停用自动集群升级）。如果省略，则默认为 REGULAR。
CONTROL_PLANE_KMS_KEY（可选）：要用于此集群的控制平面节点的 Cloud KMS 密钥的完整路径。例如：
```
/projects/myProject/locations/us-west1-a/keyRings/myKeyRing/cryptoKeys/myGDCE-Key
```
只有在您已将 Distributed Cloud Connected 与 Cloud Key Management Service 集成（如为本地存储启用对客户管理的加密密钥 (CMEK) 的支持中所述）的情况下，此参数才适用。

如果您要创建具有本地控制平面的集群，除了替换上述变量之外，还要替换以下变量：

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：指定一个以英文逗号分隔的 IPv4 地址、地址范围或子网列表，用于在本地控制平面集群上运行的分布式云负载均衡器后面的服务的入站流量。不适用于云控制平面集群。
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 Container Viewer 角色 (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 Connected 集群的 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 connected 集群的信息，请完成本部分中的步骤。

如需完成此任务，您必须在 Google Cloud 项目中拥有 Edge Container Viewer 角色 (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 Connected 可用区的 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 Connected Cluster 的 Google Cloud 区域。
CLUSTER_ID：目标集群的名称。

获取集群的可用软件版本

如需了解您的 Distributed Cloud Connected 可用区中可用于创建集群的 Distributed Cloud Connected 软件版本，请完成本部分中的步骤。

如需完成此任务，您必须在 Google Cloud 项目中拥有 Edge Container Viewer 角色 (roles/edgecontainer.viewer)。

gcloud

使用 gcloud edge-cloud container get-server-config 命令：

gcloud edge-cloud container get-server-config --location=REGION

将 REGION 替换为创建 Distributed Cloud Connected 区域的 Google Cloud 区域。

API

向 projects.locations.serverConfig 方法发出 GET 请求：

GET /v1/projects/PROJECT_ID/locations/REGION/serverConfig

替换以下内容：

PROJECT_ID：目标 Google Cloud 项目的 ID。
REGION：创建目标 Distributed Cloud Connected Cluster 的 Google Cloud 区域。

升级本地控制平面集群的软件版本

如需升级 Distributed Cloud Connected 本地控制平面集群的软件版本，请完成本部分中的步骤。此功能不适用于 Cloud 控制平面集群。

根据部署类型，Distributed Cloud Connected 软件的升级方式如下：

对于每个可用区使用一个机架的 Distributed Cloud 连接服务器部署和 Distributed Cloud 连接机架部署，一个可用区中的节点会一次升级并重启一个。
对于每个可用区使用多个机架的分布式云连接机架部署，可用区中的所有节点会同时升级。

如需完成此任务，您必须在 Google Cloud 项目中拥有 Edge Container Admin 角色 (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：目标分布式云集群已创建的 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 Connected Cluster 的 Google Cloud 区域。
CLUSTER_ID：目标集群的名称。
REQUEST_ID：用于标识相应请求的唯一程序化 ID。
UPGRADE_SCHEDULE：指定何时触发软件升级。唯一有效的值是 IMMEDIATELY。
SOFTWARE_VERSION：指定您希望此集群运行的 Distributed Cloud Connected 软件版本，格式为 1.X.Y，其中 X 是次要版本，Y 是补丁版本，例如 1.5.1。如需获取可用于创建集群的软件版本（包括服务器默认版本），请参阅获取集群的可用软件版本。

软件升级通常需要大约 2 小时，具体取决于集群节点池中的节点数量。该命令会返回一项操作，以便您跟踪软件升级的进度。在软件升级进行期间，集群的状态会设置为 Reconciling，并在升级完成后返回到 Running。如果集群状态为 Error，则表示软件升级失败。在这种情况下，请重新运行升级流程。如需了解如何检查集群的状态，请参阅获取有关集群的信息。

获取集群的凭据

如需获取 Distributed Cloud Connected Cluster 的凭据，请完成本部分中的步骤。

如需完成此任务，您必须在 Google Cloud 项目中拥有 Edge Container Viewer 角色 (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 Connected Cluster 的 Google Cloud 区域。

API

向 projects.locations.clusters 方法发出 GET 请求：

GET /v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID

替换以下内容：

PROJECT_ID：目标 Google Cloud 项目的 ID。
REGION：创建目标分布式 Cloud 可用区的 Google Cloud 区域。
CLUSTER_ID：目标集群的名称。

为集群配置维护窗口

本部分介绍如何为 Distributed Cloud 连接集群指定维护窗口和清除维护窗口。

为集群指定维护窗口

如需为 Distributed Cloud connected 集群指定维护窗口，请完成本部分中的步骤。如需详细了解集群维护，请参阅了解软件更新和维护期。

对于日期和时间格式，请使用 RFC 5545。

如需完成此任务，您必须在 Google Cloud 项目中拥有 Edge Container Admin 角色 (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 connected 集群的 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 参数，Google 会为您选择星期几。
- 如果您将 FREQ 设置为每天，维护期将每天在指定的时间段内进行。

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 connected 集群的 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 参数，Google 会为您选择星期几。
- 如果您将 FREQ 设置为每天，维护期将每天在指定的时间段内进行。

如需了解详情，请参阅资源：集群。

清除集群的维护窗口

如需清除 Distributed Cloud Connected 集群的维护窗口，请完成本部分中的步骤。如需详细了解集群维护，请参阅了解软件更新和维护期。

如需完成此任务，您必须在 Google Cloud 项目中拥有 Edge Container Admin 角色 (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 connected 集群的 Google Cloud 区域。
CLUSTER_ID：目标集群的名称。
UPDATE_MASK：在此请求中要更新的完全限定字段名称的逗号分隔列表，采用 FieldMask 格式。
REQUEST_ID：用于标识相应请求的唯一程序化 ID。
USERNAME：目标 Google Cloud 项目中有权修改集群资源的用户账号的名称。

如需了解详情，请参阅资源：集群。

删除集群

如需删除 Distributed Cloud 连接集群，请完成本部分中的步骤。在删除集群之前，您必须先执行以下操作：

如需完成此任务，您必须在 Google Cloud 项目中拥有 Edge Container Admin 角色 (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 Connected Cluster 的 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 Connected Cluster 的 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

后续步骤

创建和管理集群