在AKS上执行Helm安装/升级/卸载Nginx Ingress时遇超时错误

排查与修复步骤 #

• 检查AKS集群API服务器状态
  该错误多由集群API服务器响应超时引发，先通过Azure CLI确认集群健康状态：

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

  若状态非Succeeded，等待集群自动恢复或联系Azure技术支持。

• 清理异常Secret资源
  错误提示指向的nginx-ingress-nginx-ingress-default-server-tls Secret可能存在状态异常，手动删除该资源：

  kubectl delete secret nginx-ingress-nginx-ingress-default-server-tls -n nginx-ingress
  

  注意替换命令中的命名空间为你实际使用的Nginx Ingress部署命名空间。

• 强制卸载Helm Release
  常规卸载命令失效时，用强制删除跳过钩子和状态检查：

  helm uninstall nginx-ingress -n nginx-ingress --no-hooks --force
  

  若存在残留的CRD资源，一并清理：

  kubectl delete crd ingressclasses.networking.k8s.io
  

• 延长Helm操作超时时间
  安装或升级时增加Helm的超时阈值，给API服务器足够的响应时间：

  helm upgrade --install nginx-ingress ingress-nginx/ingress-nginx -n nginx-ingress --values values.yaml --timeout 10m
  

• 检查集群节点资源负载
  节点CPU、内存资源耗尽会拖慢API服务器响应，查看节点资源使用情况：

  kubectl top nodes
  

  若资源紧张，考虑扩容节点池或清理集群内无用的Pod、Deployment资源。

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