root@ubuntu:~/kubernetes-ingress/deployments/common# kubectl explain IngressClass
KIND: IngressClass
VERSION: networking.k8s.io/v1beta1
DESCRIPTION:
IngressClass represents the class of the Ingress, referenced by the Ingress
Spec. The `ingressclass.kubernetes.io/is-default-class` annotation can be
used to indicate that an IngressClass should be considered default. When a
single IngressClass resource has this annotation set to true, new Ingress
resources without a class specified will be assigned this default class.
FIELDS:
apiVersion <string>
APIVersion defines the versioned schema of this representation of an
object. Servers should convert recognized schemas to the latest internal
value, and may reject unrecognized values. More info:
https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
kind <string>
Kind is a string value representing the REST resource this object
represents. Servers may infer this from the endpoint the client submits
requests to. Cannot be updated. In CamelCase. More info:
https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
metadata <Object>
Standard object's metadata. More info:
https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
spec <Object>
Spec is the desired state of the IngressClass. More info:
https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
root@ubuntu:~/kubernetes-ingress/deployments/common# kubectl explain IngressClass.spec
KIND: IngressClass
VERSION: networking.k8s.io/v1beta1
RESOURCE: spec <Object>
DESCRIPTION:
Spec is the desired state of the IngressClass. More info:
https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
IngressClassSpec provides information about the class of an Ingress.
FIELDS:
controller <string>
Controller refers to the name of the controller that should handle this
class. This allows for different "flavors" that are controlled by the same
controller. For example, you may have different Parameters for the same
implementing controller. This should be specified as a domain-prefixed path
no more than 250 characters in length, e.g. "acme.io/ingress-controller".
This field is immutable.
parameters <Object>
Parameters is a link to a custom resource containing additional
configuration for the controller. This is optional if the controller does
not require extra parameters.
root@ubuntu:~/kubernetes-ingress/deployments/common# kubectl explain IngressClass.spec.controller
KIND: IngressClass
VERSION: networking.k8s.io/v1beta1
FIELD: controller <string>
DESCRIPTION:
Controller refers to the name of the controller that should handle this
class. This allows for different "flavors" that are controlled by the same
controller. For example, you may have different Parameters for the same
implementing controller. This should be specified as a domain-prefixed path
no more than 250 characters in length, e.g. "acme.io/ingress-controller".
This field is immutable.
root@ubuntu:~/kubernetes-ingress/deployments/common# kubectl create -f ingress-k8s-class.yaml
error: error validating "ingress-k8s-class.yaml": error validating data: ValidationError(IngressClass.spec): invalid type for io.k8s.api.networking.v1beta1.IngressClassSpec: got "string", expected "map"; if you choose to ignore these errors, turn validation off with --validate=false
root@ubuntu:~/kubernetes-ingress/deployments/common# cat ingress-k8s-class.yaml
apiVersion: networking.k8s.io/v1beta1
kind: IngressClass
metadata:
name: nginx-k8s
# annotations:
# ingressclass.kubernetes.io/is-default-class: "true"
spec:
controller:kubernetes.io/ingress-controller
root@ubuntu:~/kubernetes-ingress/deployments/common# cat ingress-
ingress-class.yaml ingress-k8s-class.yaml
root@ubuntu:~/kubernetes-ingress/deployments/common# cat ingress-class.yaml
apiVersion: networking.k8s.io/v1beta1
kind: IngressClass
metadata:
name: nginx-org
# annotations:
# ingressclass.kubernetes.io/is-default-class: "true"
spec:
controller: nginx.org/ingress-controller
root@ubuntu:~/kubernetes-ingress/deployments/common# kubectl get ingressclass
NAME CONTROLLER PARAMETERS AGE
nginx-k8s kubernetes.io/ingress-controller <none> 14s
nginx-org nginx.org/ingress-controller <none> 4h30m
root@ubuntu:~/kubernetes-ingress/deployments/common#
