本页面介绍了如何在 Google Kubernetes Engine (GKE) 中创建启用默认功能的 Standard 可用区级集群。可用区级集群在单个可用区中具有单个控制平面实例。根据您的可用性要求,您可以选择将区域级集群的节点分布到单个区域或多个区域。
本页面适用于需要在 GKE 上创建和配置集群以及部署工作负载的 Operator、Cloud Architect 和开发者。如需详细了解我们在 Google Cloud内容中提及的常见角色和示例任务,请参阅常见的 GKE 用户角色和任务。
在阅读本页面之前,请确保您熟悉集群配置选项。
准备工作
在开始之前,请确保您已执行以下任务:
- 启用 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@developer.gserviceaccount.com" \ --role="roles/container.defaultNodeServiceAccount"
将
PROJECT_NUMBER替换为上一步中的项目编号。
创建区域级集群
创建新的可用区级集群时,您至少需要指定名称、项目(通常是当前项目)和可用区(通常是命令行工具的默认位置),所有其他值都使用默认设置。不过,还有更多可能的配置设置,本部分仅介绍其中一部分,并且其中一些设置在创建集群后无法更改。请确保您了解哪些设置在创建集群后无法更改,并且在创建集群时选择正确的设置,以免不得不重新创建集群。
您可以在集群配置选项简介中查看集群配置选项的概览,并在 gcloud container clusters create 和 Terraform google_container_cluster 参考指南中查看可能的选项的完整列表。
您可以使用 gcloud CLI、Google Cloud 控制台或 Terraform 创建可用区级集群。
如果您要使用 Cloud Code for VS Code 开发 GKE 应用,请尝试使用 Cloud Code 创建集群。
gcloud
如需使用 gcloud CLI 创建可用区级集群,请使用以下命令之一。
请替换以下内容:
CLUSTER_NAME:新集群的名称。CHANNEL:发布渠道的类型,可以是rapid、regular、stable或None(已弃用)之一。默认情况下,集群会在regular发布渠道中注册。CONTROL_PLANE_LOCATION:集群控制平面的 Compute Engine 可用区。VERSION:您要为集群指定的版本。COMPUTE_ZONE,COMPUTE_ZONE1,[...]:在其中创建节点的可用区。您可以根据集群的需要指定任意数量的可用区。所有可用区必须与集群的控制平面位于同一区域,由--location标志指定。对于可用区级集群,--node-locations必须包含集群的主要可用区。
我们强烈建议您指定节点可以使用的具有最低权限的 IAM 服务账号,而不是 Compute Engine 默认服务账号。如需了解如何创建具有最低权限的服务账号,请参阅使用最小权限服务账号。
如需在 gcloud CLI 中指定自定义服务账号,请在您的命令中添加以下标志:
--service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com将 SERVICE_ACCOUNT_NAME 替换为具有最低权限的服务账号的名称。
使用特定的发布渠道:
如需使用特定发布渠道创建新集群,请运行以下命令:
gcloud container clusters create CLUSTER_NAME \
--release-channel CHANNEL \
--location CONTROL_PLANE_LOCATION \
--node-locations COMPUTE_ZONE,COMPUTE_ZONE1
使用特定版本:
如需使用特定集群版本创建新集群,请运行以下命令:
gcloud container clusters create CLUSTER_NAME \
--cluster-version VERSION \
--location CONTROL_PLANE_LOCATION \
--node-locations COMPUTE_ZONE,COMPUTE_ZONE1
示例
以下命令会创建一个名为 example-cluster 的多可用区集群,其中集群控制平面位于 us-east4-a 可用区,并且有三个节点位置。集群已在 regular 发布渠道中注册。
如果省略 --num-nodes 标志,则集群会默认为每个区域创建三个节点。由于指定了三个可用区,因此该命令会创建一个包含九个节点的集群,其中 us-east4-a、us-east4-b 和 us-east4-c 各有三个节点。在 GKE 1.37.1-gke.1153000 版及更高版本中,您可以将 --num-nodes 标志设置为 0,以创建零节点集群。
gcloud container clusters create example-cluster \
--location us-east4-a \
--node-locations us-east4-a,us-east4-b,us-east4-c
控制台
如需使用 Google Cloud 控制台创建可用区级集群,请执行以下任务:
在 Google Cloud 控制台中,前往创建一个 Kubernetes 集群页面。
在集群基本信息部分,完成以下操作:
- 为集群输入名称。
- 对于位置类型,选择可用区,然后为您的集群选择所需的可用区。
- 如果要创建多可用区集群,请选中指定默认节点位置复选框,然后选择您希望运行节点池的其他可用区。
选择发布渠道。 您可以根据需要选择无渠道,但此配置选项已被弃用,并将被移除。如需了解详情,请参阅未在发布渠道中注册的集群。
可选:从版本下拉列表中指定控制平面版本。
可选:为新集群配置其他设置。
可选:如果您要将新集群注册到舰队,请前往高级设置部分,然后按照 Google Cloud 控制台有关创建和注册新集群的说明完成集群注册。
如需创建和配置您自己的节点池,请按以下步骤操作:
- 点击 添加节点池。
- 在需要更改对话框中,点击进行更改。
在导航菜单中,系统会显示一个名为
default-pool的节点池。可选:如需创建没有节点池的集群,请按照以下步骤操作:
- 在导航菜单中,点击 default-pool。
- 点击 移除节点池。
- 为集群配置任何剩余设置,然后点击创建。
可选:如需向集群添加节点池,请点击 添加节点池。在导航菜单中,系统会显示一个新的节点池。
为节点池配置基本设置:
- 在导航菜单的节点池部分中,点击节点池的名称。用户管理的节点池详情页面会打开。
- 在名称字段中,输入节点池的名称。
- 在大小部分的节点数字段中,指定要创建的节点数。您必须具有节点及其资源(例如防火墙路由)的可用资源配额。在 GKE 1.37.1-gke.1153000 版及更高版本中,您可以通过指定值
0来创建空节点池。
为运行节点的虚拟机实例配置设置:
为节点池配置安全设置:
- 在导航菜单中,在所选节点池的展开部分中,点击安全。
- (可选)为节点指定自定义 IAM 服务账号:
- 在高级设置页面中,展开安全部分。
- 在服务账号菜单中,选择您想使用的服务账号。
我们强烈建议您指定节点可以使用的具有最低权限的 IAM 服务账号,而不是 Compute Engine 默认服务账号。如需了解如何创建具有最低权限的服务账号,请参阅使用最小权限服务账号。
点击创建。
Terraform
如需使用 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-a。
如果您指定任何其他节点池配置标志(例如
--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 为传入的工作负载自动创建节点。
- 手动添加节点池或调整现有空节点池的大小。
集群模板
GKE 之前支持集群模板。这些模板已从 Google Cloud 控制台中移除,但仍可通过以下链接访问: