本文档介绍了如何将现有 Google Kubernetes Engine (GKE) VPC 原生集群从 Dataplane V1 迁移到 GKE Dataplane V2、监控迁移过程,以及在需要时回滚迁移。
本文档适用于管理其 GKE 集群的网络配置的平台管理员、运维人员和网络专家。
在开始之前,请参阅迁移到 GKE Dataplane V2 简介,了解每个迁移阶段会发生什么,以及如何规划工作负载中断。
准备工作
在启动迁移之前,请验证您的集群是否符合资格要求,并考虑对工作负载的影响。
验证您的集群是否满足以下要求:
- 集群是 VPC 原生集群。
- 集群运行的是 1.35.3-gke.1155000 或更高版本。
- 节点池运行的是 1.35.1-gke.1516000 或更高版本。
- 如果您使用的是 Cloud Service Mesh 或开源 Istio,则 Istio 版本为 1.23 或更高版本。
准备集群
在开始迁移之前,请完成以下任务:
- 移除 NetworkPolicy:移除现有网络政策。如果 GKE 在重新创建节点时突然强制执行网络政策,您可能会遇到意外的网络中断。
- Calico 网络政策:如果您使用的是启用了网络政策 (Calico) 的 GKE Standard 集群,请停用网络政策强制执行。您无法直接迁移这些集群。
- Active Assist 建议:查看 Active Assist 或集群详情页面,了解可能与迁移冲突的建议。
- IP 地址容量:验证集群的 Pod IP 地址范围是否有足够的容量来支持节点池升级策略。如需了解详情,请参阅 GKE IP 地址利用率数据分析。
- 网络功能:在开始迁移之前或迁移完成后,启用 NodeLocal DNSCache 或节点内可见性等网络功能。您无法在迁移期间启用这些功能。
了解限制
- 锁定的网络配置:开始迁移后,您无法更改集群级网络配置,直到迁移完成。
- 维护窗口:迁移会遵循维护窗口和维护排除项,因此可能会出现停滞。如需加快此过程,您可以手动修补节点池。如需了解相关步骤,请参阅加快迁移速度。
- 可选的 GKE Dataplane V2 功能:在迁移完成后,配置可选的 GKE Dataplane V2 功能,例如 GKE Dataplane V2 可观测性或 Pod 的多网络支持。
- Terraform:您无法使用 Terraform 迁移到 GKE Dataplane V2。
启动迁移
如需手动启动迁移并绕过自动诊断检查,您可以使用 Google Cloud CLI 修补集群。
运行以下命令:
gcloud container clusters update CLUSTER_NAME \
--location=LOCATION \
--enable-dataplane-v2
替换以下内容:
CLUSTER_NAME:集群的名称。LOCATION:集群的计算位置。
观察迁移进度
您可以通过检查 datapathProvider 字段来监控迁移状态。在转换期间,此字段会显示 MIGRATE_TO_ADVANCED_DATAPATH。
检查集群状态:
gcloud container clusters describe CLUSTER_NAME \ --location=LOCATION \ --format='value(networkConfig.datapathProvider)'替换以下内容:
CLUSTER_NAME:集群的名称。LOCATION:集群的计算位置。
检查节点池状态:
gcloud container node-pools list \ --cluster=CLUSTER_NAME \ --location=LOCATION \ --format='value(name, networkConfig.datapathProvider)'替换以下内容:
CLUSTER_NAME:集群的名称。LOCATION:集群的计算位置。
检查
anetdDaemonSet,验证代理是否正在运行:kubectl get ds -n kube-system anetd
加快迁移
如需绕过自动发布时间表,您可以选择手动修补节点池。
如需手动修补节点池,请运行以下命令:
gcloud container node-pools update NODE_POOL_NAME \
--cluster=CLUSTER_NAME \
--location=LOCATION \
--datapath-provider=advanced-datapath
替换以下内容:
NODE_POOL_NAME:节点池的名称。CLUSTER_NAME:集群的名称。LOCATION:集群的计算位置。
完成迁移
所有节点池都迁移到 GKE Dataplane V2 后,GKE 会自动完成迁移。迁移完成后,命令输出会显示状态 ADVANCED_DATAPATH,并且集群会运行 GKE Dataplane V2。
通过检查集群状态来观察完成情况:
gcloud container clusters describe CLUSTER_NAME \
--location=LOCATION \
--format='value(networkConfig.datapathProvider)'
替换以下内容:
CLUSTER_NAME:集群的名称。LOCATION:集群的计算位置。
迁移完成后,输出会显示 ADVANCED_DATAPATH。
回滚迁移
在最终确定阶段完成之前,您可以随时还原到 Dataplane V1。撤消迁移是正向迁移的对称过程:启动回滚后,GKE 会自动将节点池修补回旧版数据路径,然后最终确定集群。
观察
anetd运行状况:在回滚迁移之前,请检查代理是否正在运行,以确定是否可以缓解故障。kubectl get ds -n kube-system anetd取消正在进行的节点池操作:
识别并取消会阻止集群补丁请求的所有正在运行的节点池操作。
gcloud container operations list \ --location=LOCATION \ --filter="operationType=UPGRADE_NODES AND status=RUNNING AND targetLink:*/clusters/CLUSTER_NAME"替换以下内容:
LOCATION:集群的计算位置。CLUSTER_NAME:集群的名称。
使用操作 ID 取消操作:
gcloud container operations cancel OPERATION_ID \ --location=LOCATION替换以下内容:
OPERATION_ID:正在运行的操作的 ID。LOCATION:集群的计算位置。
启动回滚:发出集群补丁请求,以还原到 Dataplane V1。
gcloud container clusters update CLUSTER_NAME \ --location=LOCATION \ --no-enable-dataplane-v2替换以下内容:
CLUSTER_NAME:集群的名称。LOCATION:集群的计算位置。
观察节点池发布:检查节点池状态,验证是否已迁移到旧版数据路径。
gcloud container node-pools list \ --cluster=CLUSTER_NAME \ --location=LOCATION \ --format='value(name, networkConfig.datapathProvider)'替换以下内容:
CLUSTER_NAME:集群的名称。LOCATION:集群的计算位置。
在回滚期间,命令输出会显示已修补节点池的状态为
LEGACY_DATAPATH。观察最终确定:在所有节点池都迁移到 Dataplane V1 后,GKE 会自动完成迁移。通过检查集群状态来观察完成情况:
gcloud container clusters describe CLUSTER_NAME \ --location=LOCATION \ --format='value(networkConfig.datapathProvider)'替换以下内容:
CLUSTER_NAME:集群的名称。LOCATION:集群的计算位置。
回滚完成后,命令输出会显示状态
LEGACY_DATAPATH。
排查迁移问题
本部分提供的信息可帮助您排查和解决在迁移到 GKE Dataplane V2 时可能遇到的常见问题。
节点池迁移失败
迁移节点池时,GKE 会使用配置的超额配置升级或蓝绿升级策略来创建新节点,然后再删除旧节点。如果您的 Google Cloud 可用区没有足够的资源来预配新节点,则迁移会失败,并显示 GCE_STOCKOUT 或 ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS 错误。GKE 会自动重新尝试迁移这些节点池。如果您手动修补节点池,请等待资源可用时再尝试迁移。
后续步骤
- 如需详细了解 GKE Dataplane V2 可观测性,请参阅 GKE Dataplane V2 可观测性。