IngressClass resource fields and annotations
The IngressClass
resource is a class of Ingress resources supporting simultaneous use of multiple ingress controllers, e.g., Application Load Balancer and NGINX. Each IngressClass
resource specifies a distinct ingress controller. This enables traffic routing across multiple Ingress
controllers within the same application and Managed Service for Kubernetes cluster.
When using multiple ingress controllers, explicitly declare the target controller for each Ingress
resource. To do this, specify the relevant controller’s IngressClass
in the spec.ingressClassName field of the Ingress
resource.
IngressClass
is a standard Kubernetes resource. Its fields and annotations are described below. For more information on configuring and using IngressClass
resources, see the relevant Kubernetes articleIngress
resources and routing traffic across multiple ingress controllers.
IngressClass
apiVersion: networking.k8s.io/v1
kind: IngressClass
metadata: <ObjectMeta>
spec:
controller: <string>
Field |
Value / Type |
Description |
|
|
This is a required field. Kubernetes API version. |
|
|
Resource type |
|
|
This is a required field. |
|
|
This is a required field. Resource specification. |
|
|
This is a required field. Ingress controller name specified by the
|
Example
apiVersion: networking.k8s.io/v1
kind: IngressClass
metadata:
labels:
app.kubernetes.io/component: controller
name: alb
annotations:
ingressclass.kubernetes.io/is-default-class: "true"
spec:
controller: ingress.alb.yc.io/yc-alb-ingress-controller
ObjectMeta
name: <string>
labels:
<string>: <string>
annotations:
ingressclass.kubernetes.io/is-default-class: "<bool>"
Field |
Value / Type |
Description |
|
|
This is a required field. Resource name. For more information about the name format, see the relevant Kubernetes article This name is also specified in the spec.ingressClassName field of the |
|
|
Kubernetes: Metrics for Kubernetes object management and monitoring. We recommend |
|
|
Resource annotations. Available annotation is |