本文档介绍如何创建标准区域级集群,以在集群升级、自动维护或可用区级服务中断期间提高集群控制平面和工作负载的可用性。
GKE Autopilot 集群始终为区域级集群。
概览
当您创建区域级集群而不是可用区级集群时,集群的控制平面会跨给定区域中的多个可用区复制。对于区域级集群中的节点池,您可以手动指定运行节点池的可用区,也可以使用默认配置,即在控制平面区域的三个可用区中复制每个节点池。所有可用区都必须与集群的控制平面位于同一区域内。
区域级集群会跨多个可用区复制资源,并且需要耗用额外的配额。
如需了解不同的集群可用性类型,请参阅集群配置选项简介。
以下部分中的说明介绍了如何执行以下操作:
创建区域级集群后,您无法再将其转换为可用区级集群。
创建新的区域级集群时,您至少需要指定名称、项目(通常是当前项目)和区域(通常是命令行工具的默认位置),所有其他值都使用默认设置。不过,还有更多可能的配置设置,本指南仅介绍其中一部分,并且其中一些设置在创建集群后无法更改。请确保您了解哪些设置在创建集群后无法更改,并且在创建集群时选择正确的设置,以免不得不重新创建集群。
您可以在集群配置选项简介中查看集群配置选项的概览,并在 gcloud container clusters create 和 Terraform google_container_cluster 参考指南中查看可能的选项的完整列表。
准备工作
在开始之前,请确保您已执行以下任务:
- 启用 Google Kubernetes Engine API。 启用 Google Kubernetes Engine API
- 如需使用 Google Cloud CLI 执行此任务,请安装并初始化 gcloud CLI。如果您之前安装了 gcloud CLI,请通过运行
gcloud components update命令来获取最新版本。较早版本的 gcloud CLI 可能不支持运行本文档中的命令。
- 确保您具有创建集群的正确权限。您至少应是 Kubernetes Engine Cluster Admin。
- 如果您要将新集群注册到舰队,请确保您拥有所需的 API 和权限。
为 GKE 设置 IAM 服务账号
GKE 使用关联到节点的 IAM 服务账号来运行日志记录和监控等系统任务。这些节点服务账号必须至少拥有项目的 Kubernetes Engine Default Node Service Account (roles/container.defaultNodeServiceAccount) 角色。默认情况下,GKE 会将 Compute Engine 默认服务账号(在您的项目中自动创建)用作节点服务账号。
如需向 Compute Engine 默认服务账号授予 roles/container.defaultNodeServiceAccount 角色,请完成以下步骤:
控制台
gcloud
- 找到您的 Google Cloud 项目编号:
gcloud projects describe PROJECT_ID \ --format="value(projectNumber)"
将
PROJECT_ID替换为您的项目 ID。输出类似于以下内容:
12345678901
- 将
roles/container.defaultNodeServiceAccount角色授予 Compute Engine 默认服务账号:gcloud projects add-iam-policy-binding PROJECT_ID \ --member="serviceAccount:PROJECT_NUMBER-compute@" \ --role="roles/container.defaultNodeServiceAccount"
将
PROJECT_NUMBER替换为上一步中的项目编号。
创建具有单可用区节点池的区域级集群
以下说明介绍如何创建区域性集群,其中节点池在区域内的单个可用区中运行。集群的控制平面会复制到指定区域的多个可用区中,但节点位于单个可用区中,不会复制到其他可用区。
您可以使用 gcloud CLI、 Google Cloud 控制台或 Terraform 创建集群。
如果您要使用 Cloud Code for VS Code 开发 GKE 应用,请尝试使用 Cloud Code 创建集群。
gcloud
在执行 gcloud CLI 命令以创建集群之前,请运行以下命令来设置正确的项目:
gcloud config set project PROJECT_ID
# gcloud config set billing/quota_project PROJECT_ID
如需使用 gcloud CLI 创建区域级集群,请使用以下命令之一并替换以下变量:
CLUSTER_NAME:新地区级集群的名称。CONTROL_PLANE_LOCATION:集群控制平面的 Compute Engine 区域。提供一个区域,例如us-east4。COMPUTE_ZONE:节点池的可用区,例如us-east4-a。此可用区必须与集群控制平面位于同一区域。CHANNEL:发布渠道的类型,可以是rapid、regular、stable或None(已弃用)之一。默认情况下,集群会在regular发布渠道中注册。VERSION:您要为集群指定的版本。
我们强烈建议您指定节点可以使用的具有最低权限的 IAM 服务账号,而不是 Compute Engine 默认服务账号。如需了解如何创建具有最低权限的服务账号,请参阅使用最小权限服务账号。
如需在 gcloud CLI 中指定自定义服务账号,请在您的命令中添加以下标志:
--service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.将 SERVICE_ACCOUNT_NAME 替换为具有最低权限的服务账号的名称。
使用特定的发布渠道:
如需使用特定发布渠道创建新集群,请运行以下命令:
gcloud container clusters create CLUSTER_NAME \
--location CONTROL_PLANE_LOCATION \
--node-locations COMPUTE_ZONE \
--release-channel CHANNEL
使用特定版本:
如需使用特定集群版本创建新集群,请运行以下命令:
gcloud container clusters create CLUSTER_NAME \
--location CONTROL_PLANE_LOCATION \
--node-locations COMPUTE_ZONE \
--cluster-version VERSION
示例
以下命令会创建一个在 regular 发布渠道(默认)中注册的区域级集群,其中 us-west1-c 可用区有三个节点(默认):
gcloud container clusters create my-regional-cluster \
--location us-west1 \
--node-locations us-west1-c
示例
以下命令会创建一个在 regular 发布渠道(默认)中注册的区域级集群,其中两个节点位于 us-west1-c 可用区:
gcloud container clusters create my-regional-cluster \
--location us-west1 \
--node-locations us-west1-c \
--num-nodes 2
控制台
在 Google Cloud 控制台中,前往创建 Kubernetes 集群页面。
在集群基本信息部分,完成以下操作:
- 为集群输入名称。
- 对于位置类型,选择区域,然后为您的集群选择区域。
- 如果要覆盖默认节点位置(例如,要在单个区域中运行),请选中指定默认节点位置复选框,然后选择要运行节点池的区域。
选择发布渠道。 您可以根据需要选择无渠道,但此配置选项已被弃用,并将被移除。如需了解详情,请参阅未在发布渠道中注册的集群。
可选:从版本下拉列表中指定控制平面版本。
可选:为新集群配置其他设置。
可选:如果您要将新集群注册到舰队,请前往高级设置部分,然后按照 Google Cloud 控制台有关创建和注册新集群的说明完成集群注册。
如需创建和配置您自己的节点池,请按以下步骤操作:
- 点击 添加节点池。
- 在需要更改对话框中,点击进行更改。
在导航菜单中,系统会显示一个名为
default-pool的节点池。可选:如需创建没有节点池的集群,请按照以下步骤操作:
- 在导航菜单中,点击 default-pool。
- 点击 移除节点池。
- 为集群配置任何剩余设置,然后点击创建。
可选:如需向集群添加节点池,请点击 添加节点池。在导航菜单中,系统会显示一个新的节点池。
为节点池配置基本设置:
- 在导航菜单的节点池部分中,点击节点池的名称。用户管理的节点池详情页面会打开。
- 在名称字段中,输入节点池的名称。
- 在大小部分的节点数字段中,指定要创建的节点数。您必须具有节点及其资源(例如防火墙路由)的可用资源配额。在 GKE 1.37.1-gke.1153000 版及更高版本中,您可以通过指定值
0来创建空节点池。
为运行节点的虚拟机实例配置设置:
为节点池配置安全设置:
- 在导航菜单中,在所选节点池的展开部分中,点击安全。
- (可选)为节点指定自定义 IAM 服务账号:
- 在高级设置页面中,展开安全部分。
- 在服务账号菜单中,选择您想使用的服务账号。
我们强烈建议您指定节点可以使用的具有最低权限的 IAM 服务账号,而不是 Compute Engine 默认服务账号。如需了解如何创建具有最低权限的服务账号,请参阅使用最小权限服务账号。
点击创建。
Terraform
如需使用 Terraform 创建具有单可用区节点池的区域级集群,请参阅以下示例:
如需详细了解如何使用 Terraform,请参阅针对 GKE 的 Terraform 支持。
使用 kubectl 与集群交互
创建集群后,您需要配置 kubectl,然后才能通过命令行与集群交互。
创建具有多可用区节点池的区域级集群
以下说明介绍了如何使用默认设置的多可用区节点池创建区域级集群。集群的控制平面和节点将在指定区域的多个可用区中复制。
您可以使用 gcloud CLI、 Google Cloud 控制台或 Terraform 创建集群。
如果您要使用 Visual Studio Code 开发 GKE 应用,请尝试使用 Cloud Code 创建集群。
gcloud
在执行 gcloud CLI 命令以创建集群之前,请运行以下命令来设置正确的项目:
gcloud config set project PROJECT_ID
# The project set above is used for quota and billing by default.
# To use a different project for quota and billing, run the following command:
# gcloud config set billing/quota_project PROJECT_ID
如需使用 gcloud CLI 创建区域级集群,请使用以下命令之一并替换以下变量:
CLUSTER_NAME:新地区级集群的名称。CONTROL_PLANE_LOCATION:集群控制平面的 Compute Engine 区域。提供一个区域,例如us-east4。CHANNEL:发布渠道的类型,可以是rapid、regular、stable或None(已弃用)之一。默认情况下,集群会在regular发布渠道中注册。VERSION:您要为集群指定的版本。- 对于所含可用区数超过三个的区域或者需要较少可用区的情况,您可以使用可选的
--node-locations标志替换用于复制节点的默认区域。
我们强烈建议您指定节点可以使用的具有最低权限的 IAM 服务账号,而不是 Compute Engine 默认服务账号。如需了解如何创建具有最低权限的服务账号,请参阅使用最小权限服务账号。
如需在 gcloud CLI 中指定自定义服务账号,请在您的命令中添加以下标志:
--service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.将 SERVICE_ACCOUNT_NAME 替换为具有最低权限的服务账号的名称。
使用特定的发布渠道:
如需使用特定发布渠道创建新集群,请运行以下命令:
gcloud container clusters create CLUSTER_NAME \
--location CONTROL_PLANE_LOCATION \
--release-channel CHANNEL
使用特定版本:
如需使用特定集群版本创建新集群,请运行以下命令:
gcloud container clusters create CLUSTER_NAME \
--location CONTROL_PLANE_LOCATION \
--cluster-version VERSION
示例
以下命令会创建一个在 regular 发布渠道中注册的区域级集群,其中 us-west1 有九个节点(三个可用区各有三个节点,这是默认设置):
gcloud container clusters create my-regional-cluster --location us-west1
示例
以下命令会创建一个在 regular 发布渠道中注册的区域级集群,其中有六个节点(三个可用区各有两个节点;由 --num-nodes 指定):
gcloud container clusters create my-regional-cluster \
--location us-west1 \
--num-nodes 2
示例
以下命令会创建一个在 regular 发布渠道中注册的区域级集群,其中两个可用区有六个节点(由 --node-locations 指定的两个可用区各有三个节点):
gcloud container clusters create my-regional-cluster \
--location us-east4 \
--node-locations us-east4-b,us-east4-c
控制台
在 Google Cloud 控制台中,前往创建 Kubernetes 集群页面。
在集群基本信息部分,完成以下操作:
- 为集群输入名称。
- 对于位置类型,选择区域,然后为您的集群选择区域。
- 如果要覆盖默认节点位置(例如,要在单个区域中运行),请选中指定默认节点位置复选框,然后选择要运行节点池的区域。
选择发布渠道。 您可以根据需要选择无渠道,但此配置选项已被弃用,并将被移除。如需了解详情,请参阅未在发布渠道中注册的集群。
可选:从版本下拉列表中指定控制平面版本。
可选:为新集群配置其他设置。
可选:如果您要将新集群注册到舰队,请前往高级设置部分,然后按照 Google Cloud 控制台有关创建和注册新集群的说明完成集群注册。
如需创建和配置您自己的节点池,请按以下步骤操作:
- 点击 添加节点池。
- 在需要更改对话框中,点击进行更改。
在导航菜单中,系统会显示一个名为
default-pool的节点池。可选:如需创建没有节点池的集群,请按照以下步骤操作:
- 在导航菜单中,点击 default-pool。
- 点击 移除节点池。
- 为集群配置任何剩余设置,然后点击创建。
可选:如需向集群添加节点池,请点击 添加节点池。在导航菜单中,系统会显示一个新的节点池。
为节点池配置基本设置:
- 在导航菜单的节点池部分中,点击节点池的名称。用户管理的节点池详情页面会打开。
- 在名称字段中,输入节点池的名称。
- 在大小部分的节点数字段中,指定要创建的节点数。您必须具有节点及其资源(例如防火墙路由)的可用资源配额。在 GKE 1.37.1-gke.1153000 版及更高版本中,您可以通过指定值
0来创建空节点池。
为运行节点的虚拟机实例配置设置:
为节点池配置安全设置:
- 在导航菜单中,在所选节点池的展开部分中,点击安全。
- (可选)为节点指定自定义 IAM 服务账号:
- 在高级设置页面中,展开安全部分。
- 在服务账号菜单中,选择您想使用的服务账号。
我们强烈建议您指定节点可以使用的具有最低权限的 IAM 服务账号,而不是 Compute Engine 默认服务账号。如需了解如何创建具有最低权限的服务账号,请参阅使用最小权限服务账号。
点击创建。
Terraform
如需使用 Terraform 创建具有多可用区节点池的区域级集群,请参阅以下示例:
如需详细了解如何使用 Terraform,请参阅针对 GKE 的 Terraform 支持。
使用 kubectl 与集群交互
创建集群后,您需要配置 kubectl,然后才能通过命令行与集群交互。
创建节点数为零的区域级集群
在 GKE 1.37.1-gke.1153000 版及更高版本中,您可以通过以下任一方式创建零节点区域级集群:
- 跳过创建默认节点池:GKE 不会向集群添加任何节点池。如果您计划使用 Autopilot ComputeClass、节点池自动创建或您稍后创建的自定义节点池来运行工作负载,请使用此选项。
- 创建空节点池:GKE 会创建一个包含零个节点的节点池。如果您想在集群创建期间自定义节点池设置,而不创建实际节点,请使用此选项。
创建零节点集群时,系统 Pod 会一直处于不可调度状态,直到集群中至少有一个节点。如需创建具有零个节点的区域级集群,请选择以下选项之一:
gcloud
如需跳过创建默认节点池,请仅在
gcloud container clusters create命令中使用--num-nodes=0标志:gcloud container clusters create CLUSTER_NAME \ --location=CONTROL_PLANE_LOCATION \ --num-nodes=0替换以下内容:
CLUSTER_NAME:新区域级集群的名称。CONTROL_PLANE_LOCATION:集群控制平面的 Compute Engine 区域,例如us-central1。
如果您指定任何其他节点池配置标志(例如
--machine-type、--disk-type或--disk-size标志),则该命令会失败,因为没有可供 GKE 配置的节点池。如需创建具有空节点池的集群,请在
gcloud container clusters create命令中使用--num-nodes=0标志和--node-pool-name标志:gcloud container clusters create CLUSTER_NAME \ --location=CONTROL_PLANE_LOCATION \ --num-nodes=0 \ --node-pool-name=NODEPOOL_NAME将
NODEPOOL_NAME替换为空节点池的名称。您可以指定其他节点配置标志,以自定义空节点池中的节点。
控制台
在 Google Cloud 控制台中,前往创建 Kubernetes 集群页面。
为集群指定名称。
在位置类型部分中,选择区域级。
在区域下拉列表中,为集群的控制平面选择一个区域。
跳过创建默认节点池或创建空节点池:
如需跳过创建默认节点池,请在默认模式部分中,验证是否已选择 Autopilot 选项。或者,触发默认节点池的创建,然后将其移除:
- 点击 添加节点池。
- 在需要更改对话框中,点击进行更改。
系统会显示一个名为
default-pool的节点池。 - 在导航菜单中,点击 default-pool。
- 点击 移除节点池。
这些步骤会创建一个没有节点池的集群,并使用 Autopilot 模式运行未选择 ComputeClass 的工作负载。您还可以通过在默认模式部分中选择用户管理的节点池选项来阻止使用 Autopilot 模式。
如需创建空节点池,请按照以下步骤操作:
- 点击 添加节点池。
- 在需要更改对话框中,点击进行更改。
系统会显示一个名为
default-pool的节点池。 - 在导航菜单中,点击 default-pool。
- 在节点数(每个可用区)字段中,指定值
0。
为集群配置任何剩余设置,然后点击创建。
Terraform
- 如需跳过创建默认节点池,请在
google_container_cluster资源中将initial_node_count字段设置为0。 如需创建空的初始节点池,请执行以下操作:
- 在
google_container_cluster资源中,将initial_node_count字段的值设置为0。 - 添加
google_container_node_pool资源,并将node_count字段设置为0。
- 在
创建具有零个节点的集群后,您可以通过以下方式预配节点:
- 将 Standard 集群设置为默认使用 Autopilot,或在 Autopilot 模式下运行特定工作负载。
- 使用 ComputeClasses 为传入的工作负载自动创建节点。
- 手动添加节点池或调整现有空节点池的大小。