Documentation
¶
Overview ¶
Package v1alpha2 contains API Schema definitions for the gateway.networking.k8s.io API group.
+k8s:openapi-gen=true +kubebuilder:object:generate=true +groupName=gateway.networking.k8s.io
Index ¶
- Constants
- Variables
- func Resource(resource string) schema.GroupResource
- type AddressType
- type AnnotationKey
- type AnnotationValue
- type BackendObjectReference
- type BackendRef
- type CommonRouteSpec
- type Duration
- type GRPCRoute
- type GRPCRouteList
- type GatewayController
- type Group
- type Hostname
- type Kind
- type LocalObjectReference
- type LocalPolicyTargetReference
- type LocalPolicyTargetReferenceWithSectionName
- type Namespace
- type NamespacedPolicyTargetReference
- type ObjectName
- type ParentReference
- type PolicyAncestorStatus
- type PolicyConditionReason
- type PolicyConditionType
- type PolicyStatus
- type PortNumber
- type PreciseHostname
- type ReferenceGrant
- type ReferenceGrantFrom
- type ReferenceGrantList
- type ReferenceGrantSpec
- type ReferenceGrantTo
- type RouteConditionReason
- type RouteConditionType
- type RouteParentStatus
- type RouteStatus
- type SecretObjectReference
- type SectionName
- type SessionPersistence
- type TCPRoute
- type TCPRouteList
- type TCPRouteRule
- type TCPRouteSpec
- type TCPRouteStatus
- type TLSRoute
- type TLSRouteList
- type TLSRouteRule
- type TLSRouteSpec
- type TLSRouteStatus
- type UDPRoute
- type UDPRouteList
- type UDPRouteRule
- type UDPRouteSpec
- type UDPRouteStatus
Constants ¶
const ( // This condition indicates whether the route has been accepted or rejected // by a Gateway, and why. // // Possible reasons for this condition to be true are: // // * "Accepted" // // Possible reasons for this condition to be False are: // // * "NotAllowedByListeners" // * "NoMatchingListenerHostname" // * "UnsupportedValue" // // Possible reasons for this condition to be Unknown are: // // * "Pending" // // Controllers may raise this condition with other reasons, // but should prefer to use the reasons listed above to improve // interoperability. RouteConditionAccepted RouteConditionType = "Accepted" // This reason is used with the "Accepted" condition when the Route has been // accepted by the Gateway. RouteReasonAccepted RouteConditionReason = "Accepted" // This reason is used with the "Accepted" condition when the route has not // been accepted by a Gateway because the Gateway has no Listener whose // allowedRoutes criteria permit the route RouteReasonNotAllowedByListeners RouteConditionReason = "NotAllowedByListeners" // This reason is used with the "Accepted" condition when the Gateway has no // compatible Listeners whose Hostname matches the route RouteReasonNoMatchingListenerHostname RouteConditionReason = "NoMatchingListenerHostname" // This reason is used with the "Accepted" condition when a value for an Enum // is not recognized. RouteReasonUnsupportedValue RouteConditionReason = "UnsupportedValue" // This reason is used with the "Accepted" when a controller has not yet // reconciled the route. RouteReasonPending RouteConditionReason = "Pending" // This condition indicates whether the controller was able to resolve all // the object references for the Route. // // Possible reasons for this condition to be true are: // // * "ResolvedRefs" // // Possible reasons for this condition to be false are: // // * "RefNotPermitted" // * "InvalidKind" // * "BackendNotFound" // // Controllers may raise this condition with other reasons, // but should prefer to use the reasons listed above to improve // interoperability. RouteConditionResolvedRefs RouteConditionType = "ResolvedRefs" // This reason is used with the "ResolvedRefs" condition when the condition // is true. RouteReasonResolvedRefs RouteConditionReason = "ResolvedRefs" // This reason is used with the "ResolvedRefs" condition when // one of the Listener's Routes has a BackendRef to an object in // another namespace, where the object in the other namespace does // not have a ReferenceGrant explicitly allowing the reference. RouteReasonRefNotPermitted RouteConditionReason = "RefNotPermitted" // This reason is used with the "ResolvedRefs" condition when // one of the Route's rules has a reference to an unknown or unsupported // Group and/or Kind. RouteReasonInvalidKind RouteConditionReason = "InvalidKind" // This reason is used with the "ResolvedRefs" condition when one of the // Route's rules has a reference to a resource that does not exist. RouteReasonBackendNotFound RouteConditionReason = "BackendNotFound" )
const GroupName = "gateway.networking.k8s.io"
GroupName specifies the group name used to register the objects.
Variables ¶
var ( // localSchemeBuilder and AddToScheme will stay in k8s.io/kubernetes. SchemeBuilder runtime.SchemeBuilder // Deprecated: use Install instead AddToScheme = localSchemeBuilder.AddToScheme Install = localSchemeBuilder.AddToScheme )
var GroupVersion = v1.GroupVersion{Group: GroupName, Version: "v1alpha2"}
GroupVersion specifies the group and the version used to register the objects.
var SchemeGroupVersion = schema.GroupVersion{Group: GroupName, Version: "v1alpha2"}
SchemeGroupVersion is group version used to register these objects Deprecated: use GroupVersion instead.
Functions ¶
func Resource ¶
func Resource(resource string) schema.GroupResource
Resource takes an unqualified resource and returns a Group qualified GroupResource
Types ¶
type AddressType ¶
type AddressType = v1.AddressType
const ( // A textual representation of a numeric IP address. IPv4 // addresses must be in dotted-decimal form. IPv6 addresses // must be in a standard IPv6 text representation // (see [RFC 5952](https://tools.ietf.org/html/rfc5952)). // // This type is intended for specific addresses. Address ranges are not // supported (e.g. you cannot use a CIDR range like 127.0.0.0/24 as an // IPAddress). // // Support: Extended IPAddressType AddressType = "IPAddress" // A Hostname represents a DNS based ingress point. This is similar to the // corresponding hostname field in Kubernetes load balancer status. For // example, this concept may be used for cloud load balancers where a DNS // name is used to expose a load balancer. // // Support: Extended HostnameAddressType AddressType = "Hostname" // A NamedAddress provides a way to reference a specific IP address by name. // For example, this may be a name or other unique identifier that refers // to a resource on a cloud provider such as a static IP. // // The `NamedAddress` type has been deprecated in favor of implementation // specific domain-prefixed strings. // // Support: Implementation-specific NamedAddressType AddressType = "NamedAddress" )
type AnnotationKey ¶
type AnnotationKey = v1.AnnotationKey
type AnnotationValue ¶
type AnnotationValue = v1.AnnotationValue
type BackendObjectReference ¶
type BackendObjectReference = v1.BackendObjectReference
type BackendRef ¶
type BackendRef = v1.BackendRef
type CommonRouteSpec ¶
type CommonRouteSpec = v1.CommonRouteSpec
type GRPCRoute ¶ added in v0.6.0
+genclient +kubebuilder:object:root=true +kubebuilder:skipversion +kubebuilder:deprecatedversion:warning="The v1alpha2 version of GRPCRoute has been deprecated and will be removed in a future release of the API. Please upgrade to v1."
func (*GRPCRoute) DeepCopy ¶ added in v0.6.0
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new GRPCRoute.
func (*GRPCRoute) DeepCopyInto ¶ added in v0.6.0
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (*GRPCRoute) DeepCopyObject ¶ added in v0.6.0
DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.
type GRPCRouteList ¶ added in v0.6.0
type GRPCRouteList struct {
metav1.TypeMeta `json:",inline"`
metav1.ListMeta `json:"metadata,omitempty"`
Items []GRPCRoute `json:"items"`
}
+kubebuilder:object:root=true
func (*GRPCRouteList) DeepCopy ¶ added in v0.6.0
func (in *GRPCRouteList) DeepCopy() *GRPCRouteList
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new GRPCRouteList.
func (*GRPCRouteList) DeepCopyInto ¶ added in v0.6.0
func (in *GRPCRouteList) DeepCopyInto(out *GRPCRouteList)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (*GRPCRouteList) DeepCopyObject ¶ added in v0.6.0
func (in *GRPCRouteList) DeepCopyObject() runtime.Object
DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.
type GatewayController ¶
type GatewayController = v1.GatewayController
type LocalObjectReference ¶
type LocalObjectReference = v1.LocalObjectReference
type LocalPolicyTargetReference ¶ added in v1.1.0
type LocalPolicyTargetReference v1.LocalPolicyTargetReference
func (*LocalPolicyTargetReference) DeepCopy ¶ added in v1.1.0
func (in *LocalPolicyTargetReference) DeepCopy() *LocalPolicyTargetReference
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new LocalPolicyTargetReference.
func (*LocalPolicyTargetReference) DeepCopyInto ¶ added in v1.1.0
func (in *LocalPolicyTargetReference) DeepCopyInto(out *LocalPolicyTargetReference)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type LocalPolicyTargetReferenceWithSectionName ¶ added in v1.1.0
type LocalPolicyTargetReferenceWithSectionName v1.LocalPolicyTargetReferenceWithSectionName
func (*LocalPolicyTargetReferenceWithSectionName) DeepCopy ¶ added in v1.1.0
func (in *LocalPolicyTargetReferenceWithSectionName) DeepCopy() *LocalPolicyTargetReferenceWithSectionName
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new LocalPolicyTargetReferenceWithSectionName.
func (*LocalPolicyTargetReferenceWithSectionName) DeepCopyInto ¶ added in v1.1.0
func (in *LocalPolicyTargetReferenceWithSectionName) DeepCopyInto(out *LocalPolicyTargetReferenceWithSectionName)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type NamespacedPolicyTargetReference ¶ added in v1.1.0
type NamespacedPolicyTargetReference v1.NamespacedPolicyTargetReference
func (*NamespacedPolicyTargetReference) DeepCopy ¶ added in v1.1.0
func (in *NamespacedPolicyTargetReference) DeepCopy() *NamespacedPolicyTargetReference
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new NamespacedPolicyTargetReference.
func (*NamespacedPolicyTargetReference) DeepCopyInto ¶ added in v1.1.0
func (in *NamespacedPolicyTargetReference) DeepCopyInto(out *NamespacedPolicyTargetReference)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type ObjectName ¶
type ObjectName = v1.ObjectName
type ParentReference ¶ added in v0.5.0
type ParentReference = v1.ParentReference
type PolicyAncestorStatus ¶ added in v1.0.0
type PolicyAncestorStatus v1.PolicyAncestorStatus
func (*PolicyAncestorStatus) DeepCopy ¶ added in v1.0.0
func (in *PolicyAncestorStatus) DeepCopy() *PolicyAncestorStatus
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new PolicyAncestorStatus.
func (*PolicyAncestorStatus) DeepCopyInto ¶ added in v1.0.0
func (in *PolicyAncestorStatus) DeepCopyInto(out *PolicyAncestorStatus)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type PolicyConditionReason ¶ added in v0.6.1
type PolicyConditionReason v1.PolicyConditionReason
type PolicyConditionType ¶ added in v0.6.1
type PolicyConditionType v1.PolicyConditionType
type PolicyStatus ¶ added in v1.0.0
type PolicyStatus v1.PolicyStatus
func (*PolicyStatus) DeepCopy ¶ added in v1.0.0
func (in *PolicyStatus) DeepCopy() *PolicyStatus
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new PolicyStatus.
func (*PolicyStatus) DeepCopyInto ¶ added in v1.0.0
func (in *PolicyStatus) DeepCopyInto(out *PolicyStatus)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type PortNumber ¶
type PortNumber = v1.PortNumber
type PreciseHostname ¶ added in v0.4.1
type PreciseHostname = v1.PreciseHostname
type ReferenceGrant ¶ added in v0.5.0
type ReferenceGrant v1beta1.ReferenceGrant
ReferenceGrant identifies kinds of resources in other namespaces that are trusted to reference the specified kinds of resources in the same namespace as the policy.
Each ReferenceGrant can be used to represent a unique trust relationship. Additional Reference Grants can be used to add to the set of trusted sources of inbound references for the namespace they are defined within.
A ReferenceGrant is required for all cross-namespace references in Gateway API (with the exception of cross-namespace Route-Gateway attachment, which is governed by the AllowedRoutes configuration on the Gateway, and cross-namespace Service ParentRefs on a "consumer" mesh Route, which defines routing rules applicable only to workloads in the Route namespace). ReferenceGrants allowing a reference from a Route to a Service are only applicable to BackendRefs.
ReferenceGrant is a form of runtime verification allowing users to assert which cross-namespace object references are permitted. Implementations that support ReferenceGrant MUST NOT permit cross-namespace references which have no grant, and MUST respond to the removal of a grant by revoking the access that the grant allowed.
func (*ReferenceGrant) DeepCopy ¶ added in v0.5.0
func (in *ReferenceGrant) DeepCopy() *ReferenceGrant
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new ReferenceGrant.
func (*ReferenceGrant) DeepCopyInto ¶ added in v0.5.0
func (in *ReferenceGrant) DeepCopyInto(out *ReferenceGrant)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (*ReferenceGrant) DeepCopyObject ¶ added in v0.5.0
func (in *ReferenceGrant) DeepCopyObject() runtime.Object
DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.
type ReferenceGrantFrom ¶ added in v0.5.0
type ReferenceGrantFrom = v1beta1.ReferenceGrantFrom
type ReferenceGrantList ¶ added in v0.5.0
type ReferenceGrantList struct {
metav1.TypeMeta `json:",inline"`
metav1.ListMeta `json:"metadata,omitempty"`
Items []ReferenceGrant `json:"items"`
}
+kubebuilder:object:root=true ReferenceGrantList contains a list of ReferenceGrant.
func (*ReferenceGrantList) DeepCopy ¶ added in v0.5.0
func (in *ReferenceGrantList) DeepCopy() *ReferenceGrantList
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new ReferenceGrantList.
func (*ReferenceGrantList) DeepCopyInto ¶ added in v0.5.0
func (in *ReferenceGrantList) DeepCopyInto(out *ReferenceGrantList)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (*ReferenceGrantList) DeepCopyObject ¶ added in v0.5.0
func (in *ReferenceGrantList) DeepCopyObject() runtime.Object
DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.
type ReferenceGrantSpec ¶ added in v0.5.0
type ReferenceGrantSpec = v1beta1.ReferenceGrantSpec
type ReferenceGrantTo ¶ added in v0.5.0
type ReferenceGrantTo = v1beta1.ReferenceGrantTo
type RouteConditionReason ¶ added in v0.5.0
type RouteConditionReason = v1.RouteConditionReason
type RouteConditionType ¶
type RouteConditionType = v1.RouteConditionType
type RouteParentStatus ¶
type RouteParentStatus = v1.RouteParentStatus
type RouteStatus ¶
type RouteStatus = v1.RouteStatus
type SecretObjectReference ¶
type SecretObjectReference = v1.SecretObjectReference
type SectionName ¶
type SectionName = v1.SectionName
type SessionPersistence ¶ added in v1.1.0
type SessionPersistence = v1.SessionPersistence
type TCPRoute ¶
type TCPRoute struct {
metav1.TypeMeta `json:",inline"`
// +optional
metav1.ObjectMeta `json:"metadata,omitempty"`
// Spec defines the desired state of TCPRoute.
// +required
Spec TCPRouteSpec `json:"spec"`
// Status defines the current state of TCPRoute.
// +optional
Status TCPRouteStatus `json:"status,omitempty"`
}
TCPRoute provides a way to route TCP requests. When combined with a Gateway listener, it can be used to forward connections on the port specified by the listener to a set of backends specified by the TCPRoute.
func (*TCPRoute) DeepCopy ¶
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new TCPRoute.
func (*TCPRoute) DeepCopyInto ¶
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (*TCPRoute) DeepCopyObject ¶
DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.
type TCPRouteList ¶
type TCPRouteList struct {
metav1.TypeMeta `json:",inline"`
metav1.ListMeta `json:"metadata,omitempty"`
Items []TCPRoute `json:"items"`
}
TCPRouteList contains a list of TCPRoute
func (*TCPRouteList) DeepCopy ¶
func (in *TCPRouteList) DeepCopy() *TCPRouteList
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new TCPRouteList.
func (*TCPRouteList) DeepCopyInto ¶
func (in *TCPRouteList) DeepCopyInto(out *TCPRouteList)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (*TCPRouteList) DeepCopyObject ¶
func (in *TCPRouteList) DeepCopyObject() runtime.Object
DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.
type TCPRouteRule ¶
type TCPRouteRule struct {
// Name is the name of the route rule. This name MUST be unique within a Route if it is set.
//
// Support: Extended
// +optional
Name *SectionName `json:"name,omitempty"`
// BackendRefs defines the backend(s) where matching requests should be
// sent. If unspecified or invalid (refers to a nonexistent resource or a
// Service with no endpoints), the underlying implementation MUST actively
// reject connection attempts to this backend. Connection rejections must
// respect weight; if an invalid backend is requested to have 80% of
// connections, then 80% of connections must be rejected instead.
//
// Support: Core for Kubernetes Service
//
// Support: Extended for Kubernetes ServiceImport
//
// Support: Implementation-specific for any other resource
//
// Support for weight: Extended
//
// +required
// +listType=atomic
// +kubebuilder:validation:MinItems=1
// +kubebuilder:validation:MaxItems=16
BackendRefs []BackendRef `json:"backendRefs,omitempty"`
}
TCPRouteRule is the configuration for a given rule.
func (*TCPRouteRule) DeepCopy ¶
func (in *TCPRouteRule) DeepCopy() *TCPRouteRule
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new TCPRouteRule.
func (*TCPRouteRule) DeepCopyInto ¶
func (in *TCPRouteRule) DeepCopyInto(out *TCPRouteRule)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type TCPRouteSpec ¶
type TCPRouteSpec struct {
CommonRouteSpec `json:",inline"`
// Rules are a list of TCP matchers and actions.
//
// +required
// +listType=atomic
// +kubebuilder:validation:MinItems=1
// +kubebuilder:validation:MaxItems=16
// <gateway:experimental:validation:XValidation:message="Rule name must be unique within the route",rule="self.all(l1, !has(l1.name) || self.exists_one(l2, has(l2.name) && l1.name == l2.name))">
Rules []TCPRouteRule `json:"rules"`
}
TCPRouteSpec defines the desired state of TCPRoute
func (*TCPRouteSpec) DeepCopy ¶
func (in *TCPRouteSpec) DeepCopy() *TCPRouteSpec
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new TCPRouteSpec.
func (*TCPRouteSpec) DeepCopyInto ¶
func (in *TCPRouteSpec) DeepCopyInto(out *TCPRouteSpec)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type TCPRouteStatus ¶
type TCPRouteStatus struct {
RouteStatus `json:",inline"`
}
TCPRouteStatus defines the observed state of TCPRoute
func (*TCPRouteStatus) DeepCopy ¶
func (in *TCPRouteStatus) DeepCopy() *TCPRouteStatus
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new TCPRouteStatus.
func (*TCPRouteStatus) DeepCopyInto ¶
func (in *TCPRouteStatus) DeepCopyInto(out *TCPRouteStatus)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type TLSRoute ¶
type TLSRoute struct {
metav1.TypeMeta `json:",inline"`
// +optional
metav1.ObjectMeta `json:"metadata,omitempty"`
// Spec defines the desired state of TLSRoute.
// +required
Spec TLSRouteSpec `json:"spec"`
// Status defines the current state of TLSRoute.
// +optional
Status TLSRouteStatus `json:"status,omitempty"`
}
The TLSRoute resource is similar to TCPRoute, but can be configured to match against TLS-specific metadata. This allows more flexibility in matching streams for a given TLS listener.
If you need to forward traffic to a single target for a TLS listener, you could choose to use a TCPRoute with a TLS listener.
func (*TLSRoute) DeepCopy ¶
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new TLSRoute.
func (*TLSRoute) DeepCopyInto ¶
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (*TLSRoute) DeepCopyObject ¶
DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.
type TLSRouteList ¶
type TLSRouteList struct {
metav1.TypeMeta `json:",inline"`
metav1.ListMeta `json:"metadata,omitempty"`
Items []TLSRoute `json:"items"`
}
TLSRouteList contains a list of TLSRoute
func (*TLSRouteList) DeepCopy ¶
func (in *TLSRouteList) DeepCopy() *TLSRouteList
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new TLSRouteList.
func (*TLSRouteList) DeepCopyInto ¶
func (in *TLSRouteList) DeepCopyInto(out *TLSRouteList)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (*TLSRouteList) DeepCopyObject ¶
func (in *TLSRouteList) DeepCopyObject() runtime.Object
DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.
type TLSRouteRule ¶
type TLSRouteRule struct {
// Name is the name of the route rule. This name MUST be unique within a Route if it is set.
//
// Support: Extended
// +optional
Name *SectionName `json:"name,omitempty"`
// BackendRefs defines the backend(s) where matching requests should be
// sent. If unspecified or invalid (refers to a nonexistent resource or
// a Service with no endpoints), the rule performs no forwarding; if no
// filters are specified that would result in a response being sent, the
// underlying implementation must actively reject request attempts to this
// backend, by rejecting the connection or returning a 500 status code.
// Request rejections must respect weight; if an invalid backend is
// requested to have 80% of requests, then 80% of requests must be rejected
// instead.
//
// Support: Core for Kubernetes Service
//
// Support: Extended for Kubernetes ServiceImport
//
// Support: Implementation-specific for any other resource
//
// Support for weight: Extended
//
// +required
// +listType=atomic
// +kubebuilder:validation:MinItems=1
// +kubebuilder:validation:MaxItems=16
BackendRefs []BackendRef `json:"backendRefs,omitempty"`
}
TLSRouteRule is the configuration for a given rule.
func (*TLSRouteRule) DeepCopy ¶
func (in *TLSRouteRule) DeepCopy() *TLSRouteRule
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new TLSRouteRule.
func (*TLSRouteRule) DeepCopyInto ¶
func (in *TLSRouteRule) DeepCopyInto(out *TLSRouteRule)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type TLSRouteSpec ¶
type TLSRouteSpec struct {
CommonRouteSpec `json:",inline"`
// Hostnames defines a set of SNI names that should match against the
// SNI attribute of TLS ClientHello message in TLS handshake. This matches
// the RFC 1123 definition of a hostname with 2 notable exceptions:
//
// 1. IPs are not allowed in SNI names per RFC 6066.
// 2. A hostname may be prefixed with a wildcard label (`*.`). The wildcard
// label must appear by itself as the first label.
//
// If a hostname is specified by both the Listener and TLSRoute, there
// must be at least one intersecting hostname for the TLSRoute to be
// attached to the Listener. For example:
//
// * A Listener with `test.example.com` as the hostname matches TLSRoutes
// that have either not specified any hostnames, or have specified at
// least one of `test.example.com` or `*.example.com`.
// * A Listener with `*.example.com` as the hostname matches TLSRoutes
// that have either not specified any hostnames or have specified at least
// one hostname that matches the Listener hostname. For example,
// `test.example.com` and `*.example.com` would both match. On the other
// hand, `example.com` and `test.example.net` would not match.
//
// If both the Listener and TLSRoute have specified hostnames, any
// TLSRoute hostnames that do not match the Listener hostname MUST be
// ignored. For example, if a Listener specified `*.example.com`, and the
// TLSRoute specified `test.example.com` and `test.example.net`,
// `test.example.net` must not be considered for a match.
//
// If both the Listener and TLSRoute have specified hostnames, and none
// match with the criteria above, then the TLSRoute is not accepted. The
// implementation must raise an 'Accepted' Condition with a status of
// `False` in the corresponding RouteParentStatus.
//
// Support: Core
//
// +optional
// +listType=atomic
// +kubebuilder:validation:MaxItems=16
Hostnames []Hostname `json:"hostnames,omitempty"`
// Rules are a list of TLS matchers and actions.
//
// +required
// +listType=atomic
// +kubebuilder:validation:MinItems=1
// +kubebuilder:validation:MaxItems=16
// <gateway:experimental:validation:XValidation:message="Rule name must be unique within the route",rule="self.all(l1, !has(l1.name) || self.exists_one(l2, has(l2.name) && l1.name == l2.name))">
Rules []TLSRouteRule `json:"rules"`
}
TLSRouteSpec defines the desired state of a TLSRoute resource.
func (*TLSRouteSpec) DeepCopy ¶
func (in *TLSRouteSpec) DeepCopy() *TLSRouteSpec
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new TLSRouteSpec.
func (*TLSRouteSpec) DeepCopyInto ¶
func (in *TLSRouteSpec) DeepCopyInto(out *TLSRouteSpec)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type TLSRouteStatus ¶
type TLSRouteStatus struct {
RouteStatus `json:",inline"`
}
TLSRouteStatus defines the observed state of TLSRoute
func (*TLSRouteStatus) DeepCopy ¶
func (in *TLSRouteStatus) DeepCopy() *TLSRouteStatus
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new TLSRouteStatus.
func (*TLSRouteStatus) DeepCopyInto ¶
func (in *TLSRouteStatus) DeepCopyInto(out *TLSRouteStatus)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type UDPRoute ¶
type UDPRoute struct {
metav1.TypeMeta `json:",inline"`
// +optional
metav1.ObjectMeta `json:"metadata,omitempty"`
// Spec defines the desired state of UDPRoute.
// +required
Spec UDPRouteSpec `json:"spec"`
// Status defines the current state of UDPRoute.
// +optional
Status UDPRouteStatus `json:"status,omitempty"`
}
UDPRoute provides a way to route UDP traffic. When combined with a Gateway listener, it can be used to forward traffic on the port specified by the listener to a set of backends specified by the UDPRoute.
func (*UDPRoute) DeepCopy ¶
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new UDPRoute.
func (*UDPRoute) DeepCopyInto ¶
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (*UDPRoute) DeepCopyObject ¶
DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.
type UDPRouteList ¶
type UDPRouteList struct {
metav1.TypeMeta `json:",inline"`
metav1.ListMeta `json:"metadata,omitempty"`
Items []UDPRoute `json:"items"`
}
UDPRouteList contains a list of UDPRoute
func (*UDPRouteList) DeepCopy ¶
func (in *UDPRouteList) DeepCopy() *UDPRouteList
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new UDPRouteList.
func (*UDPRouteList) DeepCopyInto ¶
func (in *UDPRouteList) DeepCopyInto(out *UDPRouteList)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (*UDPRouteList) DeepCopyObject ¶
func (in *UDPRouteList) DeepCopyObject() runtime.Object
DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.
type UDPRouteRule ¶
type UDPRouteRule struct {
// Name is the name of the route rule. This name MUST be unique within a Route if it is set.
//
// Support: Extended
// +optional
Name *SectionName `json:"name,omitempty"`
// BackendRefs defines the backend(s) where matching requests should be
// sent. If unspecified or invalid (refers to a nonexistent resource or a
// Service with no endpoints), the underlying implementation MUST actively
// reject connection attempts to this backend. Packet drops must
// respect weight; if an invalid backend is requested to have 80% of
// the packets, then 80% of packets must be dropped instead.
//
// Support: Core for Kubernetes Service
//
// Support: Extended for Kubernetes ServiceImport
//
// Support: Implementation-specific for any other resource
//
// Support for weight: Extended
//
// +required
// +listType=atomic
// +kubebuilder:validation:MinItems=1
// +kubebuilder:validation:MaxItems=16
BackendRefs []BackendRef `json:"backendRefs,omitempty"`
}
UDPRouteRule is the configuration for a given rule.
func (*UDPRouteRule) DeepCopy ¶
func (in *UDPRouteRule) DeepCopy() *UDPRouteRule
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new UDPRouteRule.
func (*UDPRouteRule) DeepCopyInto ¶
func (in *UDPRouteRule) DeepCopyInto(out *UDPRouteRule)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type UDPRouteSpec ¶
type UDPRouteSpec struct {
CommonRouteSpec `json:",inline"`
// Rules are a list of UDP matchers and actions.
//
// +required
// +listType=atomic
// +kubebuilder:validation:MinItems=1
// +kubebuilder:validation:MaxItems=16
// <gateway:experimental:validation:XValidation:message="Rule name must be unique within the route",rule="self.all(l1, !has(l1.name) || self.exists_one(l2, has(l2.name) && l1.name == l2.name))">
Rules []UDPRouteRule `json:"rules"`
}
UDPRouteSpec defines the desired state of UDPRoute.
func (*UDPRouteSpec) DeepCopy ¶
func (in *UDPRouteSpec) DeepCopy() *UDPRouteSpec
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new UDPRouteSpec.
func (*UDPRouteSpec) DeepCopyInto ¶
func (in *UDPRouteSpec) DeepCopyInto(out *UDPRouteSpec)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type UDPRouteStatus ¶
type UDPRouteStatus struct {
RouteStatus `json:",inline"`
}
UDPRouteStatus defines the observed state of UDPRoute.
func (*UDPRouteStatus) DeepCopy ¶
func (in *UDPRouteStatus) DeepCopy() *UDPRouteStatus
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new UDPRouteStatus.
func (*UDPRouteStatus) DeepCopyInto ¶
func (in *UDPRouteStatus) DeepCopyInto(out *UDPRouteStatus)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.