AKS部署ArgoCD Ingress报v1版IngressBackend未知serviceName错误

核心根因 #

这个报错和AKS集群本身的配置无关，本质是Kubernetes版本迭代带来的Ingress资源结构不兼容：

• 你使用的Ingress声明的apiVersion是networking.k8s.io/v1，但字段沿用了旧版本的扁平写法
• Kubernetes从1.19版本开始正式将networking.k8s.io/v1版本Ingress转为GA稳定版，该版本完全移除了后端配置里的serviceName、servicePort扁平字段，要求后端服务必须嵌套在service字段下，通过name、port子字段定义
• 你之前使用的v1.18.14版本AKS集群，API Server校验逻辑还兼容旧字段写法，因此原有配置可以正常运行；当前1.19.6版本的API Server已经严格按照GA版的结构规则做校验，因此会直接抛出未知字段的拒绝报错
• 部分公开的ArgoCD Ingress配置示例沿用了早期v1beta1版本的Ingress写法，没有适配v1 GA后的结构变更，直接照搬这类示例就会触发同类问题

修复方法 #

只需要调整Ingress配置中的backend部分为符合v1规范的嵌套结构，其余注解、路由规则、TLS配置完全不需要改动：

1. 新旧backend字段写法对照：
   旧错误写法：

backend:
  serviceName: argocd-server
  servicePort: http

新合规写法：

backend:
  service:
    name: argocd-server
    port:
      name: http

2. 调整后的完整可运行Ingress配置参考：

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: argocd-server-http-ingress
  namespace: argocd
  annotations:
    kubernetes.io/ingress.class: "nginx-internal"
    nginx.ingress.kubernetes.io/force-ssl-redirect: "true"
    nginx.ingress.kubernetes.io/backend-protocol: "HTTP"
spec:
  rules:
    - http:
        paths:
          - path: /argocd
            pathType: ImplementationSpecific
            backend:
              service:
                name: argocd-server
                port:
                  name: http
      host: argocd.example.com
  tls:
    - hosts:
        - argocd.example.com
      secretName: argocd-secret

注意事项 #

• 不要通过添加--validate=false参数跳过API Server校验强行提交配置，就算提交成功，1.19以上版本的Ingress Controller也无法识别旧的扁平字段，最后会出现路由配置不生效、后端服务无法访问的问题
• 后续所有部署在1.19+版本K8s集群上的Ingress资源，都需要按照上述嵌套结构编写后端配置，避免触发同类校验错误

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