如何确认AKS API版本升级或弃用是否会影响集群功能及AGIC？

核心结论 #

API版本弃用不会直接中断已运行的应用（包括AGIC），仅影响集群管理类的API调用操作，只要做好API版本切换，AGIC可正常运行并部署到未来集群。

1. API版本弃用的直接影响 #

• 仅针对集群管理操作：比如用该预览版本调用AKS REST API创建/更新集群、节点池、修改集群配置等，弃用后这类调用会直接失败，必须切换到官方支持的稳定API版本（如2023-08-01及以上稳定版）。
• 已部署的应用不受影响：正在运行的AGIC Pod、Ingress规则、后端服务等，不会因为API版本弃用突然停止工作——应用依赖的是Kubernetes核心API，而非AKS的预览管理API。

2. AGIC Helm部署的兼容性保障 #

• AGIC的运行不依赖AKS的预览管理API：它主要和Kubernetes的networking.k8s.io/v1（Ingress稳定API）、Azure ARM服务交互，只要集群控制平面使用的是稳定API版本，AGIC就能正常运行。
• 检查部署配置：确认你的AGIC Helm values或部署脚本中，没有硬编码指定2023-03-01-preview这个API版本。正常情况下，Helm chart会自动适配集群的API版本，无需手动指定AKS的管理API版本。
• 保持AGIC版本更新：如果集群升级到了较新的Kubernetes版本，同步升级AGIC Helm chart到兼容版本即可，官方维护的AGIC chart会持续适配AKS的稳定API变更。

3. 未来集群部署的注意事项 #

• 创建新集群时，指定官方稳定的API版本：通过Azure CLI创建时用az aks create --api-version <stable-version>，或直接使用Azure门户默认的稳定版本，避免再使用预览版API。
• 部署AGIC前验证兼容性：新集群创建完成后，先确认Kubernetes版本，再选择对应兼容的AGIC Helm chart版本（参考AGIC版本说明中的K8s版本兼容表）。

4. 快速验证步骤 #

• 查看当前集群的API版本：

  az aks show --resource-group <你的资源组名> --name <集群名> --query "kubernetesVersion"
  

• 测试AGIC重新部署：在测试集群升级API版本后，执行Helm更新或重新安装AGIC，验证Ingress规则是否正常生成、流量是否能正确路由到后端服务。

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