first shot improving api doc for ingressclassname

This commit is contained in:
Noah Ispas (iamNoah1) 2022-04-04 21:27:09 +02:00
parent 92a1d0f84c
commit e1ce5a682b

View File

@ -302,16 +302,16 @@ type IngressList struct {
// IngressSpec describes the Ingress the user wishes to exist. // IngressSpec describes the Ingress the user wishes to exist.
type IngressSpec struct { type IngressSpec struct {
// IngressClassName is the name of the IngressClass cluster resource. The // IngressClassName is the name of an IngressClass cluster resource. Ingress
// associated IngressClass defines which controller will implement the // controller implementations use this field to know whether they should be
// resource. This replaces the deprecated `kubernetes.io/ingress.class` // serving this Ingress resource, by a transitive connection
// annotation. For backwards compatibility, when that annotation is set, it // (controller -> IngressClass -> Ingress resource). Although the
// must be given precedence over this field. The controller may emit a // `kubernetes.io/ingress.class` annotation (simple constant name) was never
// warning if the field and annotation have different values. // formally defined, it was widely supported by Ingress controllers to create
// Implementations of this API should ignore Ingresses without a class // a direct bound between Ingress controller and Ingress resources. Newly
// specified. An IngressClass resource may be marked as default, which can // created Ingress resources should prefer using the field. However, even
// be used to set a default value for this field. For more information, // though the annotation is officially deprecated, for backwards compatibility
// refer to the IngressClass documentation. // reasons the annotation should still be honored if present.
// +optional // +optional
IngressClassName *string `json:"ingressClassName,omitempty" protobuf:"bytes,4,opt,name=ingressClassName"` IngressClassName *string `json:"ingressClassName,omitempty" protobuf:"bytes,4,opt,name=ingressClassName"`