首页/云/Kubernetes 速查/IngressClass 与多控制器选择
本包目录(307 条)
kubectl 基础56 条工作负载36 条
网络与服务55 条
配置与存储54 条调度与资源52 条集群运维与排障54 条

IngressClass 与多控制器选择

IngressClass 标识由哪个控制器处理 Ingress:集群可装多个控制器,用 spec.ingressClassName 指定;设默认类可省略该字段。

Kubernetes 速查云更新于 2026-10-12

查看与指定

查看与指定
kubectl get ingressclass
kubectl get ingressclass nginx -o yaml
kubectl get ingress web-ing -o jsonpath='{.spec.ingressClassName}'
kubectl annotate ingressclass nginx ingressclass.kubernetes.io/is-default-class=true

双控制器分流示例

双控制器分流示例
spec:
  ingressClassName: nginx-internal   # 内网入口控制器
  rules:
    - host: internal.example.com
默认类建议只设置一个:多个默认类时新 Ingress 的归宿可能不确定。

易错点

  • IngressController 与 IngressClass 的 controller 字段要对应,装错控制器时 Ingress 不被处理
  • 旧版本没有 ingressClassName(用注解 kubernetes.io/ingress.class),迁移时两者可能并存冲突

数据来源与参考

  • Kubernetes 官方文档 · IngressClass
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌