GKE集群从1.27升级至1.28：废弃API排查及应对指引咨询

一、检查废弃API的方法 #

1. 直接查询集群内的废弃资源与API版本 #

• 列出集群中所有标记为废弃的API资源：

  kubectl api-resources --deprecated=true
  

• 对比当前集群支持的API版本与1.28版本的差异，重点关注被移除的beta版本：

  kubectl api-versions
  

  GKE 1.28基于Kubernetes 1.28，核心废弃/移除的API包括：flowcontrol.apiserver.k8s.io/v1beta1（FlowSchema、PriorityLevelConfiguration）、autoscaling/v2beta2（HorizontalPodAutoscaler）、discovery.k8s.io/v1beta1（EndpointSlice）等。

2. 检查现有资源使用的废弃API版本 #

针对上述核心废弃API，直接查询资源实例：

• 检查FlowSchema/PriorityLevelConfiguration：

  kubectl get flowschemas.v1beta1.flowcontrol.apiserver.k8s.io
  kubectl get prioritylevelconfigurations.v1beta1.flowcontrol.apiserver.k8s.io
  

• 检查HorizontalPodAutoscaler：

  kubectl get hpa -o jsonpath='{.items[*].apiVersion}' | tr ' ' '\n' | grep v2beta2
  

• 检查EndpointSlice：

  kubectl get endpointslices.v1beta1.discovery.k8s.io
  

  若命令返回资源列表，说明集群中存在使用废弃API的资源。

3. 通过日志定位废弃API调用 #

在GKE中利用Cloud Logging筛选API请求日志，过滤调用废弃API的请求：

• 构建日志过滤条件，例如针对flowcontrol.apiserver.k8s.io/v1beta1：

  resource.type="k8s_cluster"
  logName="projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Fdata_access"
  protoPayload.requestURI:"/apis/flowcontrol.apiserver.k8s.io/v1beta1/"
  

  该方法可定位到具体调用废弃API的客户端（如应用、运维工具）。

4. 检查应用Manifest与客户端代码 #

• 遍历所有应用的YAML配置文件，搜索apiVersion字段，排查是否使用了废弃版本。
• 检查应用代码中使用的Kubernetes客户端库（如client-go、kubernetes-python），确认版本是否兼容1.28，避免硬编码调用废弃API路径。

二、废弃API的应对措施 #

1. 升级API版本至稳定版 #

针对不同的废弃API，替换为对应的稳定版本，并调整字段（若有变更）：

• HorizontalPodAutoscaler：将autoscaling/v2beta2替换为autoscaling/v2，注意metrics字段的结构调整（如targetAverageValue需改为target.averageValue）。
• FlowSchema/PriorityLevelConfiguration：将flowcontrol.apiserver.k8s.io/v1beta1替换为flowcontrol.apiserver.k8s.io/v1，字段结构基本兼容，但需确认spec中的规则配置。
• EndpointSlice：将discovery.k8s.io/v1beta1替换为discovery.k8s.io/v1，该版本自Kubernetes 1.21起已稳定，无字段变更。

2. 更新客户端库与应用代码 #

• 升级应用使用的Kubernetes客户端库至支持1.28版本的分支（如client-go v0.28.x），确保客户端调用的是稳定版API。
• 移除代码中硬编码的废弃API路径，改用客户端库提供的结构化方法调用API。

3. 清理与迁移遗留资源 #

• 删除不再使用的废弃API资源；对于仍在使用的资源，通过kubectl convert工具转换版本：

  kubectl convert -f old-resource.yaml --output-version=flowcontrol.apiserver.k8s.io/v1 > new-resource.yaml
  

  应用转换后的资源文件，确认服务正常后删除旧版本资源。

4. 测试与验证 #

• 在测试集群先完成升级，验证所有应用的可用性，重点检查依赖Kubernetes API的组件（如HPA、流量控制策略）是否正常工作。
• 监控升级后的API调用日志，确认无404/403等废弃API调用错误。

5. 持续监控 #

升级完成后，配置Cloud Monitoring告警，针对废弃API调用的日志设置告警规则，及时发现遗漏的废弃API使用场景。

内容的提问来源于stack exchange，提问作者Schatt