Traefik & Kubernetes with Gateway API

The Kubernetes Gateway API, The Experimental Way.

Gateway API is the evolution of Kubernetes APIs that relate to Services, e.g. Ingress. The Gateway API project is part of Kubernetes, working under SIG-NETWORK.

The Kubernetes Gateway provider is a Traefik implementation of the service apis specifications from the Kubernetes SIGs.

This provider is proposed as an experimental feature and partially supports the service apis v0.1.0 specification.

Enabling The Experimental Kubernetes Gateway Provider

As this provider is in experimental stage, it needs to be activated in the experimental section of the static configuration.

File (TOML)

  1. [experimental]
  2.   kubernetesGateway = true
  4. [providers.kubernetesGateway]
  5. #...

File (YAML)

  1. experimental:
  2.   kubernetesGateway: true
  4. providers:
  5.   kubernetesGateway: {}
  6.   #...

CLI

  1. --experimental.kubernetesgateway=true --providers.kubernetesgateway=true #...

Configuration Requirements

All Steps for a Successful Deployment

  • Add/update the Kubernetes Gateway API definitions.
  • Add/update the RBAC for the Traefik custom resources.
  • Add all needed Kubernetes Gateway API resources.

Examples

Kubernetes Gateway Provider Basic Example

Gateway API

  1. ---
  2. kind: GatewayClass
  3. apiVersion: networking.x-k8s.io/v1alpha1
  4. metadata:
  5.   name: my-gateway-class
  6. spec:
  7.   controller: traefik.io/gateway-controller
  9. ---
  10. kind: Gateway
  11. apiVersion: networking.x-k8s.io/v1alpha1
  12. metadata:
  13.   name: my-gateway
  14. spec:
  15.   gatewayClassName: my-gateway-class
  16.   listeners:
  17.     - protocol: HTTPS
  18.       port: 443
  19.       tls:
  20.         certificateRef:
  21.           group: "core"
  22.           kind: "Secret"
  23.           name: "mysecret"
  24.       routes:
  25.         kind: HTTPRoute
  26.         selector:
  27.           matchLabels:
  28.             app: foo
  29. ---
  30. kind: HTTPRoute
  31. apiVersion: networking.x-k8s.io/v1alpha1
  32. metadata:
  33.   name: http-app-1
  34.   namespace: default
  35.   labels:
  36.     app: foo
  37. spec:
  38.   hostnames:
  39.     - "whoami"
  40.   rules:
  41.     - matches:
  42.         - path:
  43.             type: Exact
  44.             value: /foo
  45.       forwardTo:
  46.         - serviceName: whoami
  47.           port: 80
  48.           weight: 1

Whoami Service

  1. ---
  2. kind: Deployment
  3. apiVersion: apps/v1
  4. metadata:
  5.   name: whoami
  7. spec:
  8.   replicas: 2
  9.   selector:
  10.     matchLabels:
  11.       app: whoami
  12.   template:
  13.     metadata:
  14.       labels:
  15.         app: whoami
  16.     spec:
  17.       containers:
  18.         - name: whoami
  19.           image: traefik/whoami
  21. ---
  22. apiVersion: v1
  23. kind: Service
  24. metadata:
  25.   name: whoami
  27. spec:
  28.   ports:
  29.     - protocol: TCP
  30.       port: 80
  31.   selector:
  32.     app: whoami

Traefik Service

  1. ---
  2. apiVersion: v1
  3. kind: ServiceAccount
  4. metadata:
  5.   name: traefik-controller
  7. ---
  8. kind: Deployment
  9. apiVersion: apps/v1
  10. metadata:
  11.   name: traefik
  13. spec:
  14.   replicas: 1
  15.   selector:
  16.     matchLabels:
  17.       app: traefik-lb
  18.   template:
  19.     metadata:
  20.       labels:
  21.         app: traefik-lb
  22.     spec:
  23.       serviceAccountName: traefik-controller
  24.       containers:
  25.         - name: traefik
  26.           image: traefik/traefik:latest
  27.           imagePullPolicy: IfNotPresent
  28.           args:
  29.             - --entrypoints.web.address=:80
  30.             - --entrypoints.websecure.address=:443
  31.             - --experimental.kubernetesgateway
  32.             - --providers.kubernetesgateway
  33.           ports:
  34.             - name: web
  35.               containerPort: 80
  36.             - name: websecure
  37.               containerPort: 443
  39. ---
  40. apiVersion: v1
  41. kind: Service
  42. metadata:
  43.   name: traefik
  44. spec:
  45.   selector:
  46.     app: traefik-lb
  47.   ports:
  48.     - protocol: TCP
  49.       port: 80
  50.       targetPort: web
  51.       name: web
  52.     - protocol: TCP
  53.       port: 443
  54.       targetPort: websecure
  55.       name: websecure
  56.   type: LoadBalancer

Gateway API CRDs

  1. # All resources definition must be declared
  3. ---
  4. apiVersion: apiextensions.k8s.io/v1
  5. kind: CustomResourceDefinition
  6. metadata:
  7.   annotations:
  8.     controller-gen.kubebuilder.io/version: v0.4.0
  9.   creationTimestamp: null
  10.   name: gatewayclasses.networking.x-k8s.io
  11. spec:
  12.   group: networking.x-k8s.io
  13.   names:
  14.     kind: GatewayClass
  15.     listKind: GatewayClassList
  16.     plural: gatewayclasses
  17.     shortNames:
  18.     - gc
  19.     singular: gatewayclass
  20.   scope: Cluster
  21.   versions:
  22.   - additionalPrinterColumns:
  23.     - jsonPath: .spec.controller
  24.       name: Controller
  25.       type: string
  26.     name: v1alpha1
  27.     schema:
  28.       openAPIV3Schema:
  29.         description: "GatewayClass describes a class of Gateways available to the user for creating Gateway resources. \n GatewayClass is a Cluster level resource. \n Support: Core."
  30.         properties:
  31.           apiVersion:
  32.             description: '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'
  33.             type: string
  34.           kind:
  35.             description: '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'
  36.             type: string
  37.           metadata:
  38.             type: object
  39.           spec:
  40.             description: Spec for this GatewayClass.
  41.             properties:
  42.               controller:
  43.                 description: "Controller is a domain/path string that indicates the controller that is managing Gateways of this class. \n Example: \"acme.io/gateway-controller\". \n This field is not mutable and cannot be empty. \n The format of this field is DOMAIN \"/\" PATH, where DOMAIN and PATH are valid Kubernetes names (https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names). \n Support: Core"
  44.                 maxLength: 253
  45.                 type: string
  46.               parametersRef:
  47.                 description: "ParametersRef is a controller-specific resource containing the configuration parameters corresponding to this class. This is optional if the controller does not require any additional configuration. \n Parameters resources are implementation specific custom resources. These resources must be cluster-scoped. \n If the referent cannot be found, the GatewayClass's \"InvalidParameters\" status condition will be true. \n Support: Custom"
  48.                 properties:
  49.                   group:
  50.                     description: Group is the group of the referent.
  51.                     maxLength: 253
  52.                     minLength: 1
  53.                     type: string
  54.                   kind:
  55.                     description: Kind is kind of the referent.
  56.                     maxLength: 253
  57.                     minLength: 1
  58.                     type: string
  59.                   name:
  60.                     description: Name is the name of the referent.
  61.                     maxLength: 253
  62.                     minLength: 1
  63.                     type: string
  64.                 required:
  65.                 - group
  66.                 - kind
  67.                 - name
  68.                 type: object
  69.             required:
  70.             - controller
  71.             type: object
  72.           status:
  73.             default:
  74.               conditions:
  75.               - lastTransitionTime: "1970-01-01T00:00:00Z"
  76.                 message: Waiting for controller
  77.                 reason: Waiting
  78.                 status: Unknown
  79.                 type: InvalidParameters
  80.             description: Status of the GatewayClass.
  81.             properties:
  82.               conditions:
  83.                 default:
  84.                 - lastTransitionTime: "1970-01-01T00:00:00Z"
  85.                   message: Waiting for controller
  86.                   reason: Waiting
  87.                   status: "False"
  88.                   type: Admitted
  89.                 description: Conditions is the current status from the controller for this GatewayClass.
  90.                 items:
  91.                   description: "Condition contains details for one aspect of the current state of this API Resource. --- This struct is intended for direct use as an array at the field path .status.conditions.  For example, type FooStatus struct{     // Represents the observations of a foo's current state.     // Known .status.conditions.type are: \"Available\", \"Progressing\", and \"Degraded\"     // +patchMergeKey=type     // +patchStrategy=merge     // +listType=map     // +listMapKey=type     Conditions []metav1.Condition `json:\"conditions,omitempty\" patchStrategy:\"merge\" patchMergeKey:\"type\" protobuf:\"bytes,1,rep,name=conditions\"` \n     // other fields }"
  92.                   properties:
  93.                     lastTransitionTime:
  94.                       description: lastTransitionTime is the last time the condition transitioned from one status to another. This should be when the underlying condition changed.  If that is not known, then using the time when the API field changed is acceptable.
  95.                       format: date-time
  96.                       type: string
  97.                     message:
  98.                       description: message is a human readable message indicating details about the transition. This may be an empty string.
  99.                       maxLength: 32768
  100.                       type: string
  101.                     observedGeneration:
  102.                       description: observedGeneration represents the .metadata.generation that the condition was set based upon. For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date with respect to the current state of the instance.
  103.                       format: int64
  104.                       minimum: 0
  105.                       type: integer
  106.                     reason:
  107.                       description: reason contains a programmatic identifier indicating the reason for the condition's last transition. Producers of specific condition types may define expected values and meanings for this field, and whether the values are considered a guaranteed API. The value should be a CamelCase string. This field may not be empty.
  108.                       maxLength: 1024
  109.                       minLength: 1
  110.                       pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
  111.                       type: string
  112.                     status:
  113.                       description: status of the condition, one of True, False, Unknown.
  114.                       enum:
  115.                       - "True"
  116.                       - "False"
  117.                       - Unknown
  118.                       type: string
  119.                     type:
  120.                       description: type of condition in CamelCase or in foo.example.com/CamelCase. --- Many .condition.type values are consistent across resources like Available, but because arbitrary conditions can be useful (see .node.status.conditions), the ability to deconflict is important. The regex it matches is (dns1123SubdomainFmt/)?(qualifiedNameFmt)
  121.                       maxLength: 316
  122.                       pattern: ^([a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*/)?(([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])$
  123.                       type: string
  124.                   required:
  125.                   - lastTransitionTime
  126.                   - message
  127.                   - reason
  128.                   - status
  129.                   - type
  130.                   type: object
  131.                 maxItems: 8
  132.                 type: array
  133.                 x-kubernetes-list-map-keys:
  134.                 - type
  135.                 x-kubernetes-list-type: map
  136.             type: object
  137.         type: object
  138.     served: true
  139.     storage: true
  140.     subresources:
  141.       status: {}
  142. status:
  143.   acceptedNames:
  144.     kind: ""
  145.     plural: ""
  146.   conditions: []
  147.   storedVersions: []
  149. ---
  150. apiVersion: apiextensions.k8s.io/v1
  151. kind: CustomResourceDefinition
  152. metadata:
  153.   annotations:
  154.     controller-gen.kubebuilder.io/version: v0.4.0
  155.   creationTimestamp: null
  156.   name: gateways.networking.x-k8s.io
  157. spec:
  158.   group: networking.x-k8s.io
  159.   names:
  160.     kind: Gateway
  161.     listKind: GatewayList
  162.     plural: gateways
  163.     shortNames:
  164.     - gtw
  165.     singular: gateway
  166.   scope: Namespaced
  167.   versions:
  168.   - additionalPrinterColumns:
  169.     - jsonPath: .spec.gatewayClassName
  170.       name: Class
  171.       type: string
  172.     name: v1alpha1
  173.     schema:
  174.       openAPIV3Schema:
  175.         description: "Gateway represents an instantiation of a service-traffic handling infrastructure by binding Listeners to a set of IP addresses. \n Implementations should add the `gateway-exists-finalizer.networking.x-k8s.io` finalizer on the associated GatewayClass whenever Gateway(s) is running. This ensures that a GatewayClass associated with a Gateway(s) is not deleted while in use."
  176.         properties:
  177.           apiVersion:
  178.             description: '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'
  179.             type: string
  180.           kind:
  181.             description: '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'
  182.             type: string
  183.           metadata:
  184.             type: object
  185.           spec:
  186.             description: "GatewaySpec defines the desired state of Gateway. \n Not all possible combinations of options specified in the Spec are valid. Some invalid configurations can be caught synchronously via a webhook, but there are many cases that will require asynchronous signaling via the GatewayStatus block."
  187.             properties:
  188.               addresses:
  189.                 description: "Addresses requested for this gateway. This is optional and behavior can depend on the GatewayClass. If a value is set in the spec and the requested address is invalid, the GatewayClass MUST indicate this in the associated entry in GatewayStatus.Addresses. \n If no Addresses are specified, the GatewayClass may schedule the Gateway in an implementation-defined manner, assigning an appropriate set of Addresses. \n The GatewayClass MUST bind all Listeners to every GatewayAddress that it assigns to the Gateway. \n Support: Core"
  190.                 items:
  191.                   description: GatewayAddress describes an address that can be bound to a Gateway.
  192.                   properties:
  193.                     type:
  194.                       default: IPAddress
  195.                       description: "Type of the Address. This is either \"IPAddress\" or \"NamedAddress\". \n Support: Extended"
  196.                       enum:
  197.                       - IPAddress
  198.                       - NamedAddress
  199.                       type: string
  200.                     value:
  201.                       description: 'Value. Examples: "1.2.3.4", "128::1", "my-ip-address". Validity of the values will depend on `Type` and support by the controller.'
  202.                       maxLength: 253
  203.                       minLength: 1
  204.                       type: string
  205.                   required:
  206.                   - value
  207.                   type: object
  208.                 maxItems: 16
  209.                 type: array
  210.               gatewayClassName:
  211.                 description: GatewayClassName used for this Gateway. This is the name of a GatewayClass resource.
  212.                 maxLength: 253
  213.                 minLength: 1
  214.                 type: string
  215.               listeners:
  216.                 description: "Listeners associated with this Gateway. Listeners define logical endpoints that are bound on this Gateway's addresses. At least one Listener MUST be specified. \n An implementation MAY group Listeners by Port and then collapse each group of Listeners into a single Listener if the implementation determines that the Listeners in the group are \"compatible\". An implementation MAY also group together and collapse compatible Listeners belonging to different Gateways. \n For example, an implementation might consider Listeners to be compatible with each other if all of the following conditions are met: \n 1. Either each Listener within the group specifies the \"HTTP\"    Protocol or each Listener within the group specifies either    the \"HTTPS\" or \"TLS\" Protocol. \n 2. Each Listener within the group specifies a Hostname that is unique    within the group. \n 3. As a special case, one Listener within a group may omit Hostname,    in which case this Listener matches when no other Listener    matches. \n If the implementation does collapse compatible Listeners, the hostname provided in the incoming client request MUST be matched to a Listener to find the correct set of Routes. The incoming hostname MUST be matched using the Hostname field for each Listener in order of most to least specific. That is, exact matches must be processed before wildcard matches. \n If this field specifies multiple Listeners that have the same Port value but are not compatible, the implementation must raise a \"Conflicted\" condition in the Listener status. \n Support: Core"
  217.                 items:
  218.                   description: Listener embodies the concept of a logical endpoint where a Gateway can accept network connections. Each listener in a Gateway must have a unique combination of Hostname, Port, and Protocol. This will be enforced by a validating webhook.
  219.                   properties:
  220.                     hostname:
  221.                       description: "Hostname specifies the virtual hostname to match for protocol types that define this concept. When unspecified or \"*\", all hostnames are matched. This field can be omitted for protocols that don't require hostname based matching. \n Hostname is the fully qualified domain name of a network host, as defined by RFC 3986. Note the following deviations from the \"host\" part of the URI as defined in the RFC: \n 1. IP literals are not allowed. 2. The `:` delimiter is not respected because ports are not allowed. \n Hostname can be \"precise\" which is a domain name without the terminating dot of a network host (e.g. \"foo.example.com\") or \"wildcard\", which is a domain name prefixed with a single wildcard label (e.g. \"*.example.com\"). The wildcard character '*' must appear by itself as the first DNS label and matches only a single label. \n Support: Core"
  222.                       maxLength: 253
  223.                       minLength: 1
  224.                       type: string
  225.                     port:
  226.                       description: "Port is the network port. Multiple listeners may use the same port, subject to the Listener compatibility rules. \n Support: Core"
  227.                       format: int32
  228.                       maximum: 65535
  229.                       minimum: 1
  230.                       type: integer
  231.                     protocol:
  232.                       description: "Protocol specifies the network protocol this listener expects to receive. The GatewayClass MUST apply the Hostname match appropriately for each protocol: \n * For the \"TLS\" protocol, the Hostname match MUST be   applied to the [SNI](https://tools.ietf.org/html/rfc6066#section-3)   server name offered by the client. * For the \"HTTP\" protocol, the Hostname match MUST be   applied to the host portion of the   [effective request URI](https://tools.ietf.org/html/rfc7230#section-5.5)   or the [:authority pseudo-header](https://tools.ietf.org/html/rfc7540#section-8.1.2.3) * For the \"HTTPS\" protocol, the Hostname match MUST be   applied at both the TLS and HTTP protocol layers. \n Support: Core"
  233.                       type: string
  234.                     routes:
  235.                       description: "Routes specifies a schema for associating routes with the Listener using selectors. A Route is a resource capable of servicing a request and allows a cluster operator to expose a cluster resource (i.e. Service) by externally-reachable URL, load-balance traffic and terminate SSL/TLS.  Typically, a route is a \"HTTPRoute\" or \"TCPRoute\" in group \"networking.x-k8s.io\", however, an implementation may support other types of resources. \n The Routes selector MUST select a set of objects that are compatible with the application protocol specified in the Protocol field. \n Although a client request may technically match multiple route rules, only one rule may ultimately receive the request. Matching precedence MUST be determined in order of the following criteria: \n * The most specific match. For example, the most specific HTTPRoute match   is determined by the longest matching combination of hostname and path. * The oldest Route based on creation timestamp. For example, a Route with   a creation timestamp of \"2020-09-08 01:02:03\" is given precedence over   a Route with a creation timestamp of \"2020-09-08 01:02:04\". * If everything else is equivalent, the Route appearing first in   alphabetical order (namespace/name) should be given precedence. For   example, foo/bar is given precedence over foo/baz. \n All valid portions of a Route selected by this field should be supported. Invalid portions of a Route can be ignored (sometimes that will mean the full Route). If a portion of a Route transitions from valid to invalid, support for that portion of the Route should be dropped to ensure consistency. For example, even if a filter specified by a Route is invalid, the rest of the Route should still be supported. \n Support: Core"
  236.                       properties:
  237.                         group:
  238.                           default: networking.x-k8s.io
  239.                           description: "Group is the group of the route resource to select. Omitting the value or specifying the empty string indicates the networking.x-k8s.io API group. For example, use the following to select an HTTPRoute: \n routes:   kind: HTTPRoute \n Otherwise, if an alternative API group is desired, specify the desired group: \n routes:   group: acme.io   kind: FooRoute \n Support: Core"
  240.                           maxLength: 253
  241.                           minLength: 1
  242.                           type: string
  243.                         kind:
  244.                           description: "Kind is the kind of the route resource to select. \n Kind MUST correspond to kinds of routes that are compatible with the application protocol specified in the Listener's Protocol field. \n If an implementation does not support or recognize this resource type, it SHOULD raise a \"ConditionInvalidRoutes\" condition for the affected Listener. \n Support: Core"
  245.                           type: string
  246.                         namespaces:
  247.                           default:
  248.                             from: Same
  249.                           description: "Namespaces indicates in which namespaces Routes should be selected for this Gateway. This is restricted to the namespace of this Gateway by default. \n Support: Core"
  250.                           properties:
  251.                             from:
  252.                               description: "From indicates where Routes will be selected for this Gateway. Possible values are: * All: Routes in all namespaces may be used by this Gateway. * Selector: Routes in namespaces selected by the selector may be used by   this Gateway. * Same: Only Routes in the same namespace may be used by this Gateway. \n Support: Core"
  253.                               enum:
  254.                               - All
  255.                               - Selector
  256.                               - Same
  257.                               type: string
  258.                             selector:
  259.                               description: "Selector must be specified when From is set to \"Selector\". In that case, only Routes in Namespaces matching this Selector will be selected by this Gateway. This field is ignored for other values of \"From\". \n Support: Core"
  260.                               properties:
  261.                                 matchExpressions:
  262.                                   description: matchExpressions is a list of label selector requirements. The requirements are ANDed.
  263.                                   items:
  264.                                     description: A label selector requirement is a selector that contains values, a key, and an operator that relates the key and values.
  265.                                     properties:
  266.                                       key:
  267.                                         description: key is the label key that the selector applies to.
  268.                                         type: string
  269.                                       operator:
  270.                                         description: operator represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists and DoesNotExist.
  271.                                         type: string
  272.                                       values:
  273.                                         description: values is an array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. This array is replaced during a strategic merge patch.
  274.                                         items:
  275.                                           type: string
  276.                                         type: array
  277.                                     required:
  278.                                     - key
  279.                                     - operator
  280.                                     type: object
  281.                                   type: array
  282.                                 matchLabels:
  283.                                   additionalProperties:
  284.                                     type: string
  285.                                   description: matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels map is equivalent to an element of matchExpressions, whose key field is "key", the operator is "In", and the values array contains only "value". The requirements are ANDed.
  286.                                   type: object
  287.                               type: object
  288.                           type: object
  289.                         selector:
  290.                           description: "Selector specifies a set of route labels used for selecting routes to associate with the Gateway. If RouteSelector is defined, only routes matching the RouteSelector are associated with the Gateway. An empty RouteSelector matches all routes. \n Support: Core"
  291.                           properties:
  292.                             matchExpressions:
  293.                               description: matchExpressions is a list of label selector requirements. The requirements are ANDed.
  294.                               items:
  295.                                 description: A label selector requirement is a selector that contains values, a key, and an operator that relates the key and values.
  296.                                 properties:
  297.                                   key:
  298.                                     description: key is the label key that the selector applies to.
  299.                                     type: string
  300.                                   operator:
  301.                                     description: operator represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists and DoesNotExist.
  302.                                     type: string
  303.                                   values:
  304.                                     description: values is an array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. This array is replaced during a strategic merge patch.
  305.                                     items:
  306.                                       type: string
  307.                                     type: array
  308.                                 required:
  309.                                 - key
  310.                                 - operator
  311.                                 type: object
  312.                               type: array
  313.                             matchLabels:
  314.                               additionalProperties:
  315.                                 type: string
  316.                               description: matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels map is equivalent to an element of matchExpressions, whose key field is "key", the operator is "In", and the values array contains only "value". The requirements are ANDed.
  317.                               type: object
  318.                           type: object
  319.                       required:
  320.                       - kind
  321.                       type: object
  322.                     tls:
  323.                       description: "TLS is the TLS configuration for the Listener. This field is required if the Protocol field is \"HTTPS\" or \"TLS\" and ignored otherwise. \n The association of SNIs to Certificate defined in GatewayTLSConfig is defined based on the Hostname field for this listener. \n The GatewayClass MUST use the longest matching SNI out of all available certificates for any TLS handshake. \n Support: Core"
  324.                       properties:
  325.                         certificateRef:
  326.                           description: 'CertificateRef is the reference to Kubernetes object that contain a TLS certificate and private key. This certificate MUST be used for TLS handshakes for the domain this GatewayTLSConfig is associated with. If an entry in this list omits or specifies the empty string for both the group and the resource, the resource defaults to "secrets". An implementation may support other resources (for example, resource "mycertificates" in group "networking.acme.io"). Support: Core (Kubernetes Secrets) Support: Implementation-specific (Other resource types)'
  327.                           properties:
  328.                             group:
  329.                               description: Group is the group of the referent.
  330.                               maxLength: 253
  331.                               minLength: 1
  332.                               type: string
  333.                             kind:
  334.                               description: Kind is kind of the referent.
  335.                               maxLength: 253
  336.                               minLength: 1
  337.                               type: string
  338.                             name:
  339.                               description: Name is the name of the referent.
  340.                               maxLength: 253
  341.                               minLength: 1
  342.                               type: string
  343.                           required:
  344.                           - group
  345.                           - kind
  346.                           - name
  347.                           type: object
  348.                         mode:
  349.                           description: 'Mode defines the TLS behavior for the TLS session initiated by the client. There are two possible modes: - Terminate: The TLS session between the downstream client   and the Gateway is terminated at the Gateway. - Passthrough: The TLS session is NOT terminated by the Gateway. This   implies that the Gateway can''t decipher the TLS stream except for   the ClientHello message of the TLS protocol.   CertificateRef field is ignored in this mode.'
  350.                           enum:
  351.                           - Terminate
  352.                           - Passthrough
  353.                           type: string
  354.                         options:
  355.                           additionalProperties:
  356.                             type: string
  357.                           description: "Options are a list of key/value pairs to give extended options to the provider. \n There variation among providers as to how ciphersuites are expressed. If there is a common subset for expressing ciphers then it will make sense to loft that as a core API construct. \n Support: Implementation-specific."
  358.                           type: object
  359.                         routeOverride:
  360.                           default:
  361.                             certificate: Deny
  362.                           description: "RouteOverride dictates if TLS settings can be configured via Routes or not. \n CertificateRef must be defined even if `routeOverride.certificate` is set to 'Allow' as it will be used as the default certificate for the listener."
  363.                           properties:
  364.                             certificate:
  365.                               default: Deny
  366.                               description: "Certificate dictates if TLS certificates can be configured via Routes. If set to 'Allow', a TLS certificate for a hostname defined in a Route takes precedence over the certificate defined in Gateway. \n Support: Core"
  367.                               enum:
  368.                               - Allow
  369.                               - Deny
  370.                               type: string
  371.                           required:
  372.                           - certificate
  373.                           type: object
  374.                       type: object
  375.                   required:
  376.                   - port
  377.                   - protocol
  378.                   - routes
  379.                   type: object
  380.                 maxItems: 64
  381.                 minItems: 1
  382.                 type: array
  383.             required:
  384.             - gatewayClassName
  385.             - listeners
  386.             type: object
  387.           status:
  388.             default:
  389.               conditions:
  390.               - lastTransitionTime: "1970-01-01T00:00:00Z"
  391.                 message: Waiting for controller
  392.                 reason: NotReconciled
  393.                 status: "False"
  394.                 type: Scheduled
  395.             description: GatewayStatus defines the observed state of Gateway.
  396.             properties:
  397.               addresses:
  398.                 description: "Addresses lists the IP addresses that have actually been bound to the Gateway. These addresses may differ from the addresses in the Spec, e.g. if the Gateway automatically assigns an address from a reserved pool. \n These addresses should all be of type \"IPAddress\"."
  399.                 items:
  400.                   description: GatewayAddress describes an address that can be bound to a Gateway.
  401.                   properties:
  402.                     type:
  403.                       default: IPAddress
  404.                       description: "Type of the Address. This is either \"IPAddress\" or \"NamedAddress\". \n Support: Extended"
  405.                       enum:
  406.                       - IPAddress
  407.                       - NamedAddress
  408.                       type: string
  409.                     value:
  410.                       description: 'Value. Examples: "1.2.3.4", "128::1", "my-ip-address". Validity of the values will depend on `Type` and support by the controller.'
  411.                       maxLength: 253
  412.                       minLength: 1
  413.                       type: string
  414.                   required:
  415.                   - value
  416.                   type: object
  417.                 maxItems: 16
  418.                 type: array
  419.               conditions:
  420.                 default:
  421.                 - lastTransitionTime: "1970-01-01T00:00:00Z"
  422.                   message: Waiting for controller
  423.                   reason: NotReconciled
  424.                   status: "False"
  425.                   type: Scheduled
  426.                 description: "Conditions describe the current conditions of the Gateway. \n Implementations should prefer to express Gateway conditions using the `GatewayConditionType` and `GatewayConditionReason` constants so that operators and tools can converge on a common vocabulary to describe Gateway state. \n Known condition types are: \n * \"Scheduled\" * \"Ready\""
  427.                 items:
  428.                   description: "Condition contains details for one aspect of the current state of this API Resource. --- This struct is intended for direct use as an array at the field path .status.conditions.  For example, type FooStatus struct{     // Represents the observations of a foo's current state.     // Known .status.conditions.type are: \"Available\", \"Progressing\", and \"Degraded\"     // +patchMergeKey=type     // +patchStrategy=merge     // +listType=map     // +listMapKey=type     Conditions []metav1.Condition `json:\"conditions,omitempty\" patchStrategy:\"merge\" patchMergeKey:\"type\" protobuf:\"bytes,1,rep,name=conditions\"` \n     // other fields }"
  429.                   properties:
  430.                     lastTransitionTime:
  431.                       description: lastTransitionTime is the last time the condition transitioned from one status to another. This should be when the underlying condition changed.  If that is not known, then using the time when the API field changed is acceptable.
  432.                       format: date-time
  433.                       type: string
  434.                     message:
  435.                       description: message is a human readable message indicating details about the transition. This may be an empty string.
  436.                       maxLength: 32768
  437.                       type: string
  438.                     observedGeneration:
  439.                       description: observedGeneration represents the .metadata.generation that the condition was set based upon. For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date with respect to the current state of the instance.
  440.                       format: int64
  441.                       minimum: 0
  442.                       type: integer
  443.                     reason:
  444.                       description: reason contains a programmatic identifier indicating the reason for the condition's last transition. Producers of specific condition types may define expected values and meanings for this field, and whether the values are considered a guaranteed API. The value should be a CamelCase string. This field may not be empty.
  445.                       maxLength: 1024
  446.                       minLength: 1
  447.                       pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
  448.                       type: string
  449.                     status:
  450.                       description: status of the condition, one of True, False, Unknown.
  451.                       enum:
  452.                       - "True"
  453.                       - "False"
  454.                       - Unknown
  455.                       type: string
  456.                     type:
  457.                       description: type of condition in CamelCase or in foo.example.com/CamelCase. --- Many .condition.type values are consistent across resources like Available, but because arbitrary conditions can be useful (see .node.status.conditions), the ability to deconflict is important. The regex it matches is (dns1123SubdomainFmt/)?(qualifiedNameFmt)
  458.                       maxLength: 316
  459.                       pattern: ^([a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*/)?(([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])$
  460.                       type: string
  461.                   required:
  462.                   - lastTransitionTime
  463.                   - message
  464.                   - reason
  465.                   - status
  466.                   - type
  467.                   type: object
  468.                 maxItems: 8
  469.                 type: array
  470.                 x-kubernetes-list-map-keys:
  471.                 - type
  472.                 x-kubernetes-list-type: map
  473.               listeners:
  474.                 description: Listeners provide status for each unique listener port defined in the Spec.
  475.                 items:
  476.                   description: ListenerStatus is the status associated with a Listener.
  477.                   properties:
  478.                     conditions:
  479.                       description: Conditions describe the current condition of this listener.
  480.                       items:
  481.                         description: "Condition contains details for one aspect of the current state of this API Resource. --- This struct is intended for direct use as an array at the field path .status.conditions.  For example, type FooStatus struct{     // Represents the observations of a foo's current state.     // Known .status.conditions.type are: \"Available\", \"Progressing\", and \"Degraded\"     // +patchMergeKey=type     // +patchStrategy=merge     // +listType=map     // +listMapKey=type     Conditions []metav1.Condition `json:\"conditions,omitempty\" patchStrategy:\"merge\" patchMergeKey:\"type\" protobuf:\"bytes,1,rep,name=conditions\"` \n     // other fields }"
  482.                         properties:
  483.                           lastTransitionTime:
  484.                             description: lastTransitionTime is the last time the condition transitioned from one status to another. This should be when the underlying condition changed.  If that is not known, then using the time when the API field changed is acceptable.
  485.                             format: date-time
  486.                             type: string
  487.                           message:
  488.                             description: message is a human readable message indicating details about the transition. This may be an empty string.
  489.                             maxLength: 32768
  490.                             type: string
  491.                           observedGeneration:
  492.                             description: observedGeneration represents the .metadata.generation that the condition was set based upon. For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date with respect to the current state of the instance.
  493.                             format: int64
  494.                             minimum: 0
  495.                             type: integer
  496.                           reason:
  497.                             description: reason contains a programmatic identifier indicating the reason for the condition's last transition. Producers of specific condition types may define expected values and meanings for this field, and whether the values are considered a guaranteed API. The value should be a CamelCase string. This field may not be empty.
  498.                             maxLength: 1024
  499.                             minLength: 1
  500.                             pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
  501.                             type: string
  502.                           status:
  503.                             description: status of the condition, one of True, False, Unknown.
  504.                             enum:
  505.                             - "True"
  506.                             - "False"
  507.                             - Unknown
  508.                             type: string
  509.                           type:
  510.                             description: type of condition in CamelCase or in foo.example.com/CamelCase. --- Many .condition.type values are consistent across resources like Available, but because arbitrary conditions can be useful (see .node.status.conditions), the ability to deconflict is important. The regex it matches is (dns1123SubdomainFmt/)?(qualifiedNameFmt)
  511.                             maxLength: 316
  512.                             pattern: ^([a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*/)?(([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])$
  513.                             type: string
  514.                         required:
  515.                         - lastTransitionTime
  516.                         - message
  517.                         - reason
  518.                         - status
  519.                         - type
  520.                         type: object
  521.                       maxItems: 8
  522.                       type: array
  523.                       x-kubernetes-list-map-keys:
  524.                       - type
  525.                       x-kubernetes-list-type: map
  526.                     hostname:
  527.                       description: Hostname is the Listener hostname value for which this message is reporting the status.
  528.                       maxLength: 253
  529.                       minLength: 1
  530.                       type: string
  531.                     port:
  532.                       description: Port is the unique Listener port value for which this message is reporting the status.
  533.                       format: int32
  534.                       maximum: 65535
  535.                       minimum: 1
  536.                       type: integer
  537.                     protocol:
  538.                       description: Protocol is the Listener protocol value for which this message is reporting the status.
  539.                       type: string
  540.                   required:
  541.                   - conditions
  542.                   - port
  543.                   - protocol
  544.                   type: object
  545.                 maxItems: 64
  546.                 type: array
  547.                 x-kubernetes-list-map-keys:
  548.                 - port
  549.                 x-kubernetes-list-type: map
  550.             type: object
  551.         type: object
  552.     served: true
  553.     storage: true
  554.     subresources:
  555.       status: {}
  556. status:
  557.   acceptedNames:
  558.     kind: ""
  559.     plural: ""
  560.   conditions: []
  561.   storedVersions: []
  563. ---
  564. apiVersion: apiextensions.k8s.io/v1
  565. kind: CustomResourceDefinition
  566. metadata:
  567.   annotations:
  568.     controller-gen.kubebuilder.io/version: v0.4.0
  569.   creationTimestamp: null
  570.   name: httproutes.networking.x-k8s.io
  571. spec:
  572.   group: networking.x-k8s.io
  573.   names:
  574.     kind: HTTPRoute
  575.     listKind: HTTPRouteList
  576.     plural: httproutes
  577.     singular: httproute
  578.   scope: Namespaced
  579.   versions:
  580.   - additionalPrinterColumns:
  581.     - jsonPath: .spec.hostnames
  582.       name: Hostnames
  583.       type: string
  584.     name: v1alpha1
  585.     schema:
  586.       openAPIV3Schema:
  587.         description: HTTPRoute is the Schema for the HTTPRoute resource.
  588.         properties:
  589.           apiVersion:
  590.             description: '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'
  591.             type: string
  592.           kind:
  593.             description: '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'
  594.             type: string
  595.           metadata:
  596.             type: object
  597.           spec:
  598.             description: HTTPRouteSpec defines the desired state of HTTPRoute
  599.             properties:
  600.               gateways:
  601.                 default:
  602.                   allow: SameNamespace
  603.                 description: Gateways defines which Gateways can use this Route.
  604.                 properties:
  605.                   allow:
  606.                     default: SameNamespace
  607.                     description: 'Allow indicates which Gateways will be allowed to use this route. Possible values are: * All: Gateways in any namespace can use this route. * FromList: Only Gateways specified in GatewayRefs may use this route. * SameNamespace: Only Gateways in the same namespace may use this route.'
  608.                     enum:
  609.                     - All
  610.                     - FromList
  611.                     - SameNamespace
  612.                     type: string
  613.                   gatewayRefs:
  614.                     description: GatewayRefs must be specified when Allow is set to "FromList". In that case, only Gateways referenced in this list will be allowed to use this route. This field is ignored for other values of "Allow".
  615.                     items:
  616.                       description: GatewayReference identifies a Gateway in a specified namespace.
  617.                       properties:
  618.                         name:
  619.                           description: Name is the name of the referent.
  620.                           maxLength: 253
  621.                           minLength: 1
  622.                           type: string
  623.                         namespace:
  624.                           description: Namespace is the namespace of the referent.
  625.                           maxLength: 253
  626.                           minLength: 1
  627.                           type: string
  628.                       required:
  629.                       - name
  630.                       - namespace
  631.                       type: object
  632.                     type: array
  633.                 type: object
  634.               hostnames:
  635.                 description: "Hostnames defines a set of hostname that should match against the HTTP Host header to select a HTTPRoute to process the request. Hostname is the fully qualified domain name of a network host, as defined by RFC 3986. Note the following deviations from the \"host\" part of the URI as defined in the RFC: \n 1. IPs are not allowed. 2. The `:` delimiter is not respected because ports are not allowed. \n Incoming requests are matched against the hostnames before the HTTPRoute rules. If no hostname is specified, traffic is routed based on the HTTPRouteRules. \n Hostname can be \"precise\" which is a domain name without the terminating dot of a network host (e.g. \"foo.example.com\") or \"wildcard\", which is a domain name prefixed with a single wildcard label (e.g. \"*.example.com\"). The wildcard character '*' must appear by itself as the first DNS label and matches only a single label. You cannot have a wildcard label by itself (e.g. Host == \"*\"). Requests will be matched against the Host field in the following order: 1. If Host is precise, the request matches this rule if    the http host header is equal to Host. 2. If Host is a wildcard, then the request matches this rule if    the http host header is to equal to the suffix    (removing the first label) of the wildcard rule. \n Support: Core"
  636.                 items:
  637.                   description: Hostname is used to specify a hostname that should be matched.
  638.                   maxLength: 253
  639.                   minLength: 1
  640.                   type: string
  641.                 maxItems: 16
  642.                 type: array
  643.               rules:
  644.                 description: Rules are a list of HTTP matchers, filters and actions.
  645.                 items:
  646.                   description: HTTPRouteRule defines semantics for matching an HTTP request based on conditions, optionally executing additional processing steps, and forwarding the request to an API object.
  647.                   properties:
  648.                     filters:
  649.                       description: "Filters define the filters that are applied to requests that match this rule. \n The effects of ordering of multiple behaviors are currently unspecified. This can change in the future based on feedback during the alpha stage. \n Conformance-levels at this level are defined based on the type of filter: - ALL core filters MUST be supported by all implementations. - Implementers are encouraged to support extended filters. - Implementation-specific custom filters have no API guarantees across   implementations. \n Specifying a core filter multiple times has unspecified or custom conformance. \n Support: core"
  650.                       items:
  651.                         description: 'HTTPRouteFilter defines additional processing steps that must be completed during the request or response lifecycle. HTTPRouteFilters are meant as an extension point to express additional processing that may be done in Gateway implementations. Some examples include request or response modification, implementing authentication strategies, rate-limiting, and traffic shaping. API guarantee/conformance is defined based on the type of the filter. TODO(hbagdi): re-render CRDs once controller-tools supports union tags: - https://github.com/kubernetes-sigs/controller-tools/pull/298 - https://github.com/kubernetes-sigs/controller-tools/issues/461'
  652.                         properties:
  653.                           extensionRef:
  654.                             description: "ExtensionRef is an optional, implementation-specific extension to the \"filter\" behavior.  For example, resource \"myroutefilter\" in group \"networking.acme.io\"). ExtensionRef MUST NOT be used for core and extended filters. \n Support: Implementation-specific"
  655.                             properties:
  656.                               group:
  657.                                 description: Group is the group of the referent.
  658.                                 maxLength: 253
  659.                                 minLength: 1
  660.                                 type: string
  661.                               kind:
  662.                                 description: Kind is kind of the referent.
  663.                                 maxLength: 253
  664.                                 minLength: 1
  665.                                 type: string
  666.                               name:
  667.                                 description: Name is the name of the referent.
  668.                                 maxLength: 253
  669.                                 minLength: 1
  670.                                 type: string
  671.                             required:
  672.                             - group
  673.                             - kind
  674.                             - name
  675.                             type: object
  676.                           requestHeaderModifier:
  677.                             description: "RequestHeaderModifier defines a schema for a filter that modifies request headers. \n Support: Core"
  678.                             properties:
  679.                               add:
  680.                                 additionalProperties:
  681.                                   type: string
  682.                                 description: "Add adds the given header (name, value) to the request before the action. \n Input:   GET /foo HTTP/1.1 \n Config:   add: {\"my-header\": \"foo\"} \n Output:   GET /foo HTTP/1.1   my-header: foo \n Support: Extended"
  683.                                 type: object
  684.                               remove:
  685.                                 description: "Remove the given header(s) from the HTTP request before the action. The value of RemoveHeader is a list of HTTP header names. Note that the header names are case-insensitive [RFC-2616 4.2]. \n Input:   GET /foo HTTP/1.1   My-Header1: ABC   My-Header2: DEF   My-Header2: GHI \n Config:   remove: [\"my-header1\", \"my-header3\"] \n Output:   GET /foo HTTP/1.1   My-Header2: DEF \n Support: Extended"
  686.                                 items:
  687.                                   type: string
  688.                                 maxItems: 16
  689.                                 type: array
  690.                             type: object
  691.                           requestMirror:
  692.                             description: "RequestMirror defines a schema for a filter that mirrors requests. \n Support: Extended"
  693.                             properties:
  694.                               backendRef:
  695.                                 description: "BackendRef is a local object reference to mirror matched requests to. If both BackendRef and ServiceName are specified, ServiceName will be given precedence. \n If the referent cannot be found, the rule is not included in the route. The controller should raise the \"ResolvedRefs\" condition on the Gateway with the \"DegradedRoutes\" reason. The gateway status for this route should be updated with a condition that describes the error more specifically. \n Support: Custom"
  696.                                 properties:
  697.                                   group:
  698.                                     description: Group is the group of the referent.
  699.                                     maxLength: 253
  700.                                     minLength: 1
  701.                                     type: string
  702.                                   kind:
  703.                                     description: Kind is kind of the referent.
  704.                                     maxLength: 253
  705.                                     minLength: 1
  706.                                     type: string
  707.                                   name:
  708.                                     description: Name is the name of the referent.
  709.                                     maxLength: 253
  710.                                     minLength: 1
  711.                                     type: string
  712.                                 required:
  713.                                 - group
  714.                                 - kind
  715.                                 - name
  716.                                 type: object
  717.                               port:
  718.                                 description: Port specifies the destination port number to use for the backend referenced by the ServiceName or BackendRef field.
  719.                                 format: int32
  720.                                 maximum: 65535
  721.                                 minimum: 1
  722.                                 type: integer
  723.                               serviceName:
  724.                                 description: "ServiceName refers to the name of the Service to mirror matched requests to. When specified, this takes the place of BackendRef. If both BackendRef and ServiceName are specified, ServiceName will be given precedence. \n If the referent cannot be found, the rule is not included in the route. The controller should raise the \"ResolvedRefs\" condition on the Gateway with the \"DegradedRoutes\" reason. The gateway status for this route should be updated with a condition that describes the error more specifically. \n Support: Core"
  725.                                 maxLength: 253
  726.                                 type: string
  727.                             required:
  728.                             - port
  729.                             type: object
  730.                           type:
  731.                             description: "Type identifies the type of filter to apply. As with other API fields, types are classified into three conformance levels: \n - Core: Filter types and their corresponding configuration defined by   \"Support: Core\" in this package, e.g. \"RequestHeaderModifier\". All   implementations must support core filters. \n - Extended: Filter types and their corresponding configuration defined by   \"Support: Extended\" in this package, e.g. \"RequestMirror\". Implementers   are encouraged to support extended filters. \n - Custom: Filters that are defined and supported by specific vendors.   In the future, filters showing convergence in behavior across multiple   implementations will be considered for inclusion in extended or core   conformance levels. Filter-specific configuration for such filters   is specified using the ExtensionRef field. `Type` should be set to   \"ExtensionRef\" for custom filters. \n Implementers are encouraged to define custom implementation types to extend the core API with implementation-specific behavior."
  732.                             enum:
  733.                             - RequestHeaderModifier
  734.                             - RequestMirror
  735.                             - ExtensionRef
  736.                             type: string
  737.                         required:
  738.                         - type
  739.                         type: object
  740.                       maxItems: 16
  741.                       type: array
  742.                     forwardTo:
  743.                       description: ForwardTo defines the backend(s) where matching requests should be sent. If unspecified, the rule performs no forwarding. If unspecified and no filters are specified that would result in a response being sent, a 503 error code is returned.
  744.                       items:
  745.                         description: HTTPRouteForwardTo defines how a HTTPRoute should forward a request.
  746.                         properties:
  747.                           backendRef:
  748.                             description: "BackendRef is a reference to a backend to forward matched requests to. If both BackendRef and ServiceName are specified, ServiceName will be given precedence. \n If the referent cannot be found, the route must be dropped from the Gateway. The controller should raise the \"ResolvedRefs\" condition on the Gateway with the \"DroppedRoutes\" reason. The gateway status for this route should be updated with a condition that describes the error more specifically. \n Support: Custom"
  749.                             properties:
  750.                               group:
  751.                                 description: Group is the group of the referent.
  752.                                 maxLength: 253
  753.                                 minLength: 1
  754.                                 type: string
  755.                               kind:
  756.                                 description: Kind is kind of the referent.
  757.                                 maxLength: 253
  758.                                 minLength: 1
  759.                                 type: string
  760.                               name:
  761.                                 description: Name is the name of the referent.
  762.                                 maxLength: 253
  763.                                 minLength: 1
  764.                                 type: string
  765.                             required:
  766.                             - group
  767.                             - kind
  768.                             - name
  769.                             type: object
  770.                           filters:
  771.                             description: "Filters defined at this-level should be executed if and only if the request is being forwarded to the backend defined here. \n Support: Custom (For broader support of filters, use the Filters field in HTTPRouteRule.)"
  772.                             items:
  773.                               description: 'HTTPRouteFilter defines additional processing steps that must be completed during the request or response lifecycle. HTTPRouteFilters are meant as an extension point to express additional processing that may be done in Gateway implementations. Some examples include request or response modification, implementing authentication strategies, rate-limiting, and traffic shaping. API guarantee/conformance is defined based on the type of the filter. TODO(hbagdi): re-render CRDs once controller-tools supports union tags: - https://github.com/kubernetes-sigs/controller-tools/pull/298 - https://github.com/kubernetes-sigs/controller-tools/issues/461'
  774.                               properties:
  775.                                 extensionRef:
  776.                                   description: "ExtensionRef is an optional, implementation-specific extension to the \"filter\" behavior.  For example, resource \"myroutefilter\" in group \"networking.acme.io\"). ExtensionRef MUST NOT be used for core and extended filters. \n Support: Implementation-specific"
  777.                                   properties:
  778.                                     group:
  779.                                       description: Group is the group of the referent.
  780.                                       maxLength: 253
  781.                                       minLength: 1
  782.                                       type: string
  783.                                     kind:
  784.                                       description: Kind is kind of the referent.
  785.                                       maxLength: 253
  786.                                       minLength: 1
  787.                                       type: string
  788.                                     name:
  789.                                       description: Name is the name of the referent.
  790.                                       maxLength: 253
  791.                                       minLength: 1
  792.                                       type: string
  793.                                   required:
  794.                                   - group
  795.                                   - kind
  796.                                   - name
  797.                                   type: object
  798.                                 requestHeaderModifier:
  799.                                   description: "RequestHeaderModifier defines a schema for a filter that modifies request headers. \n Support: Core"
  800.                                   properties:
  801.                                     add:
  802.                                       additionalProperties:
  803.                                         type: string
  804.                                       description: "Add adds the given header (name, value) to the request before the action. \n Input:   GET /foo HTTP/1.1 \n Config:   add: {\"my-header\": \"foo\"} \n Output:   GET /foo HTTP/1.1   my-header: foo \n Support: Extended"
  805.                                       type: object
  806.                                     remove:
  807.                                       description: "Remove the given header(s) from the HTTP request before the action. The value of RemoveHeader is a list of HTTP header names. Note that the header names are case-insensitive [RFC-2616 4.2]. \n Input:   GET /foo HTTP/1.1   My-Header1: ABC   My-Header2: DEF   My-Header2: GHI \n Config:   remove: [\"my-header1\", \"my-header3\"] \n Output:   GET /foo HTTP/1.1   My-Header2: DEF \n Support: Extended"
  808.                                       items:
  809.                                         type: string
  810.                                       maxItems: 16
  811.                                       type: array
  812.                                   type: object
  813.                                 requestMirror:
  814.                                   description: "RequestMirror defines a schema for a filter that mirrors requests. \n Support: Extended"
  815.                                   properties:
  816.                                     backendRef:
  817.                                       description: "BackendRef is a local object reference to mirror matched requests to. If both BackendRef and ServiceName are specified, ServiceName will be given precedence. \n If the referent cannot be found, the rule is not included in the route. The controller should raise the \"ResolvedRefs\" condition on the Gateway with the \"DegradedRoutes\" reason. The gateway status for this route should be updated with a condition that describes the error more specifically. \n Support: Custom"
  818.                                       properties:
  819.                                         group:
  820.                                           description: Group is the group of the referent.
  821.                                           maxLength: 253
  822.                                           minLength: 1
  823.                                           type: string
  824.                                         kind:
  825.                                           description: Kind is kind of the referent.
  826.                                           maxLength: 253
  827.                                           minLength: 1
  828.                                           type: string
  829.                                         name:
  830.                                           description: Name is the name of the referent.
  831.                                           maxLength: 253
  832.                                           minLength: 1
  833.                                           type: string
  834.                                       required:
  835.                                       - group
  836.                                       - kind
  837.                                       - name
  838.                                       type: object
  839.                                     port:
  840.                                       description: Port specifies the destination port number to use for the backend referenced by the ServiceName or BackendRef field.
  841.                                       format: int32
  842.                                       maximum: 65535
  843.                                       minimum: 1
  844.                                       type: integer
  845.                                     serviceName:
  846.                                       description: "ServiceName refers to the name of the Service to mirror matched requests to. When specified, this takes the place of BackendRef. If both BackendRef and ServiceName are specified, ServiceName will be given precedence. \n If the referent cannot be found, the rule is not included in the route. The controller should raise the \"ResolvedRefs\" condition on the Gateway with the \"DegradedRoutes\" reason. The gateway status for this route should be updated with a condition that describes the error more specifically. \n Support: Core"
  847.                                       maxLength: 253
  848.                                       type: string
  849.                                   required:
  850.                                   - port
  851.                                   type: object
  852.                                 type:
  853.                                   description: "Type identifies the type of filter to apply. As with other API fields, types are classified into three conformance levels: \n - Core: Filter types and their corresponding configuration defined by   \"Support: Core\" in this package, e.g. \"RequestHeaderModifier\". All   implementations must support core filters. \n - Extended: Filter types and their corresponding configuration defined by   \"Support: Extended\" in this package, e.g. \"RequestMirror\". Implementers   are encouraged to support extended filters. \n - Custom: Filters that are defined and supported by specific vendors.   In the future, filters showing convergence in behavior across multiple   implementations will be considered for inclusion in extended or core   conformance levels. Filter-specific configuration for such filters   is specified using the ExtensionRef field. `Type` should be set to   \"ExtensionRef\" for custom filters. \n Implementers are encouraged to define custom implementation types to extend the core API with implementation-specific behavior."
  854.                                   enum:
  855.                                   - RequestHeaderModifier
  856.                                   - RequestMirror
  857.                                   - ExtensionRef
  858.                                   type: string
  859.                               required:
  860.                               - type
  861.                               type: object
  862.                             maxItems: 16
  863.                             type: array
  864.                           port:
  865.                             description: "Port specifies the destination port number to use for the backend referenced by the ServiceName or BackendRef field. \n Support: Core"
  866.                             format: int32
  867.                             maximum: 65535
  868.                             minimum: 1
  869.                             type: integer
  870.                           serviceName:
  871.                             description: "ServiceName refers to the name of the Service to forward matched requests to. When specified, this takes the place of BackendRef. If both BackendRef and ServiceName are specified, ServiceName will be given precedence. \n If the referent cannot be found, the route must be dropped from the Gateway. The controller should raise the \"ResolvedRefs\" condition on the Gateway with the \"DroppedRoutes\" reason. The gateway status for this route should be updated with a condition that describes the error more specifically. \n The protocol to use should be specified with the AppProtocol field on Service resources. This field was introduced in Kubernetes 1.18. If using an earlier version of Kubernetes, a `networking.x-k8s.io/app-protocol` annotation on the BackendPolicy resource may be used to define the protocol. If the AppProtocol field is available, this annotation should not be used. The AppProtocol field, when populated, takes precedence over the annotation in the BackendPolicy resource. For custom backends, it is encouraged to add a semantically-equivalent field in the Custom Resource Definition. \n Support: Core"
  872.                             maxLength: 253
  873.                             type: string
  874.                           weight:
  875.                             default: 1
  876.                             description: "Weight specifies the proportion of HTTP requests forwarded to the backend referenced by the ServiceName or BackendRef field. This is computed as weight/(sum of all weights in this ForwardTo list). For non-zero values, there may be some epsilon from the exact proportion defined here depending on the precision an implementation supports. Weight is not a percentage and the sum of weights does not need to equal 100. \n If only one backend is specified and it has a weight greater than 0, 100% of the traffic is forwarded to that backend. If weight is set to 0, no traffic should be forwarded for this entry. If unspecified, weight defaults to 1. \n Support: Core"
  877.                             format: int32
  878.                             maximum: 1000000
  879.                             minimum: 0
  880.                             type: integer
  881.                         required:
  882.                         - port
  883.                         type: object
  884.                       maxItems: 4
  885.                       type: array
  886.                     matches:
  887.                       default:
  888.                       - path:
  889.                           type: Prefix
  890.                           value: /
  891.                       description: "Matches define conditions used for matching the rule against incoming HTTP requests. Each match is independent, i.e. this rule will be matched if **any** one of the matches is satisfied. \n For example, take the following matches configuration: \n ``` matches: - path:     value: \"/foo\"   headers:     values:       version: \"2\" - path:     value: \"/v2/foo\" ``` \n For a request to match against this rule, a request should satisfy EITHER of the two conditions: \n - path prefixed with `/foo` AND contains the header `version: \"2\"` - path prefix of `/v2/foo` \n See the documentation for HTTPRouteMatch on how to specify multiple match conditions that should be ANDed together. \n If no matches are specified, the default is a prefix path match on \"/\", which has the effect of matching every HTTP request. \n A client request may match multiple HTTP route rules. Matching precedence MUST be determined in order of the following criteria, continuing on ties: * The longest matching hostname. * The longest matching path. * The largest number of header matches * The oldest Route based on creation timestamp. For example, a Route with   a creation timestamp of \"2020-09-08 01:02:03\" is given precedence over   a Route with a creation timestamp of \"2020-09-08 01:02:04\". * The Route appearing first in alphabetical order (namespace/name) for   example, foo/bar is given precedence over foo/baz."
  892.                       items:
  893.                         description: "HTTPRouteMatch defines the predicate used to match requests to a given action. Multiple match types are ANDed together, i.e. the match will evaluate to true only if all conditions are satisfied. \n For example, the match below will match a HTTP request only if its path starts with `/foo` AND it contains the `version: \"1\"` header: \n ``` match:   path:     value: \"/foo\"   headers:     values:       version: \"1\" ```"
  894.                         properties:
  895.                           extensionRef:
  896.                             description: "ExtensionRef is an optional, implementation-specific extension to the \"match\" behavior. For example, resource \"myroutematcher\" in group \"networking.acme.io\". If the referent cannot be found, the rule is not included in the route. The controller should raise the \"ResolvedRefs\" condition on the Gateway with the \"DegradedRoutes\" reason. The gateway status for this route should be updated with a condition that describes the error more specifically. \n Support: custom"
  897.                             properties:
  898.                               group:
  899.                                 description: Group is the group of the referent.
  900.                                 maxLength: 253
  901.                                 minLength: 1
  902.                                 type: string
  903.                               kind:
  904.                                 description: Kind is kind of the referent.
  905.                                 maxLength: 253
  906.                                 minLength: 1
  907.                                 type: string
  908.                               name:
  909.                                 description: Name is the name of the referent.
  910.                                 maxLength: 253
  911.                                 minLength: 1
  912.                                 type: string
  913.                             required:
  914.                             - group
  915.                             - kind
  916.                             - name
  917.                             type: object
  918.                           headers:
  919.                             description: Headers specifies a HTTP request header matcher.
  920.                             properties:
  921.                               type:
  922.                                 default: Exact
  923.                                 description: "Type specifies how to match against the value of the header. \n Support: core (Exact) Support: custom (RegularExpression, ImplementationSpecific) \n Since RegularExpression PathType has custom conformance, implementations can support POSIX, PCRE or any other dialects of regular expressions. Please read the implementation's documentation to determine the supported dialect. \n HTTP Header name matching MUST be case-insensitive (RFC 2616 - section 4.2)."
  924.                                 enum:
  925.                                 - Exact
  926.                                 - RegularExpression
  927.                                 - ImplementationSpecific
  928.                                 type: string
  929.                               values:
  930.                                 additionalProperties:
  931.                                   type: string
  932.                                 description: "Values is a map of HTTP Headers to be matched. It MUST contain at least one entry. \n The HTTP header field name to match is the map key, and the value of the HTTP header is the map value. HTTP header field name matching MUST be case-insensitive. \n Multiple match values are ANDed together, meaning, a request must match all the specified headers to select the route."
  933.                                 type: object
  934.                             required:
  935.                             - values
  936.                             type: object
  937.                           path:
  938.                             default:
  939.                               type: Prefix
  940.                               value: /
  941.                             description: Path specifies a HTTP request path matcher. If this field is not specified, a default prefix match on the "/" path is provided.
  942.                             properties:
  943.                               type:
  944.                                 default: Prefix
  945.                                 description: "Type specifies how to match against the path Value. \n Support: core (Exact, Prefix) Support: custom (RegularExpression, ImplementationSpecific) \n Since RegularExpression PathType has custom conformance, implementations can support POSIX, PCRE or any other dialects of regular expressions. Please read the implementation's documentation to determine the supported dialect."
  946.                                 enum:
  947.                                 - Exact
  948.                                 - Prefix
  949.                                 - RegularExpression
  950.                                 - ImplementationSpecific
  951.                                 type: string
  952.                               value:
  953.                                 description: Value of the HTTP path to match against.
  954.                                 minLength: 1
  955.                                 type: string
  956.                             required:
  957.                             - value
  958.                             type: object
  959.                         type: object
  960.                       maxItems: 8
  961.                       type: array
  962.                   type: object
  963.                 maxItems: 16
  964.                 minItems: 1
  965.                 type: array
  966.               tls:
  967.                 description: "TLS defines the TLS certificate to use for Hostnames defined in this Route. This configuration only takes effect if the AllowRouteOverride field is set to true in the associated Gateway resource. \n Collisions can happen if multiple HTTPRoutes define a TLS certificate for the same hostname. In such a case, conflict resolution guiding principles apply, specificallly, if hostnames are same and two different certificates are specified then the certificate in the oldest resource wins. \n Please note that HTTP Route-selection takes place after the TLS Handshake (ClientHello). Due to this, TLS certificate defined here will take precedence even if the request has the potential to match multiple routes (in case multiple HTTPRoutes share the same hostname). \n Support: Core"
  968.                 properties:
  969.                   certificateRef:
  970.                     description: 'CertificateRef refers to a Kubernetes object that contains a TLS certificate and private key. This certificate MUST be used for TLS handshakes for the domain this RouteTLSConfig is associated with. If an entry in this list omits or specifies the empty string for both the group and kind, the resource defaults to "secrets". An implementation may support other resources (for example, resource "mycertificates" in group "networking.acme.io"). Support: Core (Kubernetes Secrets) Support: Implementation-specific (Other resource types)'
  971.                     properties:
  972.                       group:
  973.                         description: Group is the group of the referent.
  974.                         maxLength: 253
  975.                         minLength: 1
  976.                         type: string
  977.                       kind:
  978.                         description: Kind is kind of the referent.
  979.                         maxLength: 253
  980.                         minLength: 1
  981.                         type: string
  982.                       name:
  983.                         description: Name is the name of the referent.
  984.                         maxLength: 253
  985.                         minLength: 1
  986.                         type: string
  987.                     required:
  988.                     - group
  989.                     - kind
  990.                     - name
  991.                     type: object
  992.                 required:
  993.                 - certificateRef
  994.                 type: object
  995.             required:
  996.             - rules
  997.             type: object
  998.           status:
  999.             description: HTTPRouteStatus defines the observed state of HTTPRoute.
  1000.             properties:
  1001.               gateways:
  1002.                 description: "Gateways is a list of the Gateways that are associated with the route, and the status of the route with respect to each of these Gateways. When a Gateway selects this route, the controller that manages the Gateway should add an entry to this list when the controller first sees the route and should update the entry as appropriate when the route is modified. \n A maximum of 100 Gateways will be represented in this list. If this list is full, there may be additional Gateways using this Route that are not included in the list."
  1003.                 items:
  1004.                   description: RouteGatewayStatus describes the status of a route with respect to an associated Gateway.
  1005.                   properties:
  1006.                     conditions:
  1007.                       description: Conditions describes the status of the route with respect to the Gateway.  For example, the "Admitted" condition indicates whether the route has been admitted or rejected by the Gateway, and why.  Note that the route's availability is also subject to the Gateway's own status conditions and listener status.
  1008.                       items:
  1009.                         description: "Condition contains details for one aspect of the current state of this API Resource. --- This struct is intended for direct use as an array at the field path .status.conditions.  For example, type FooStatus struct{     // Represents the observations of a foo's current state.     // Known .status.conditions.type are: \"Available\", \"Progressing\", and \"Degraded\"     // +patchMergeKey=type     // +patchStrategy=merge     // +listType=map     // +listMapKey=type     Conditions []metav1.Condition `json:\"conditions,omitempty\" patchStrategy:\"merge\" patchMergeKey:\"type\" protobuf:\"bytes,1,rep,name=conditions\"` \n     // other fields }"
  1010.                         properties:
  1011.                           lastTransitionTime:
  1012.                             description: lastTransitionTime is the last time the condition transitioned from one status to another. This should be when the underlying condition changed.  If that is not known, then using the time when the API field changed is acceptable.
  1013.                             format: date-time
  1014.                             type: string
  1015.                           message:
  1016.                             description: message is a human readable message indicating details about the transition. This may be an empty string.
  1017.                             maxLength: 32768
  1018.                             type: string
  1019.                           observedGeneration:
  1020.                             description: observedGeneration represents the .metadata.generation that the condition was set based upon. For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date with respect to the current state of the instance.
  1021.                             format: int64
  1022.                             minimum: 0
  1023.                             type: integer
  1024.                           reason:
  1025.                             description: reason contains a programmatic identifier indicating the reason for the condition's last transition. Producers of specific condition types may define expected values and meanings for this field, and whether the values are considered a guaranteed API. The value should be a CamelCase string. This field may not be empty.
  1026.                             maxLength: 1024
  1027.                             minLength: 1
  1028.                             pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
  1029.                             type: string
  1030.                           status:
  1031.                             description: status of the condition, one of True, False, Unknown.
  1032.                             enum:
  1033.                             - "True"
  1034.                             - "False"
  1035.                             - Unknown
  1036.                             type: string
  1037.                           type:
  1038.                             description: type of condition in CamelCase or in foo.example.com/CamelCase. --- Many .condition.type values are consistent across resources like Available, but because arbitrary conditions can be useful (see .node.status.conditions), the ability to deconflict is important. The regex it matches is (dns1123SubdomainFmt/)?(qualifiedNameFmt)
  1039.                             maxLength: 316
  1040.                             pattern: ^([a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*/)?(([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])$
  1041.                             type: string
  1042.                         required:
  1043.                         - lastTransitionTime
  1044.                         - message
  1045.                         - reason
  1046.                         - status
  1047.                         - type
  1048.                         type: object
  1049.                       maxItems: 8
  1050.                       type: array
  1051.                       x-kubernetes-list-map-keys:
  1052.                       - type
  1053.                       x-kubernetes-list-type: map
  1054.                     gatewayRef:
  1055.                       description: GatewayRef is a reference to a Gateway object that is associated with the route.
  1056.                       properties:
  1057.                         name:
  1058.                           description: Name is the name of the referent.
  1059.                           maxLength: 253
  1060.                           minLength: 1
  1061.                           type: string
  1062.                         namespace:
  1063.                           description: Namespace is the namespace of the referent.
  1064.                           maxLength: 253
  1065.                           minLength: 1
  1066.                           type: string
  1067.                       required:
  1068.                       - name
  1069.                       - namespace
  1070.                       type: object
  1071.                   required:
  1072.                   - gatewayRef
  1073.                   type: object
  1074.                 maxItems: 100
  1075.                 type: array
  1076.             required:
  1077.             - gateways
  1078.             type: object
  1079.         type: object
  1080.     served: true
  1081.     storage: true
  1082.     subresources:
  1083.       status: {}
  1084. status:
  1085.   acceptedNames:
  1086.     kind: ""
  1087.     plural: ""
  1088.   conditions: []
  1089.   storedVersions: []

RBAC

  1. ---
  2. apiVersion: rbac.authorization.k8s.io/v1
  3. kind: ClusterRole
  4. metadata:
  5.   name: gateway-role
  6. rules:
  7.   - apiGroups:
  8.       - ""
  9.     resources:
  10.       - services
  11.       - endpoints
  12.       - secrets
  13.     verbs:
  14.       - get
  15.       - list
  16.       - watch
  17.   - apiGroups:
  18.       - networking.x-k8s.io
  19.     resources:
  20.       - gatewayclasses
  21.       - gateways
  22.       - httproutes
  23.     verbs:
  24.       - get
  25.       - list
  26.       - watch
  27.   - apiGroups:
  28.       - networking.x-k8s.io
  29.     resources:
  30.       - gatewayclasses/status
  31.       - gateways/status
  32.       - httproutes/status
  33.     verbs:
  34.       - update
  36. ---
  37. kind: ClusterRoleBinding
  38. apiVersion: rbac.authorization.k8s.io/v1beta1
  39. metadata:
  40.   name: gateway-controller
  42. roleRef:
  43.   apiGroup: rbac.authorization.k8s.io
  44.   kind: ClusterRole
  45.   name: gateway-role
  46. subjects:
  47.   - kind: ServiceAccount
  48.     name: traefik-controller
  49.     namespace: default

The Kubernetes Service APIs provides several guides of how to use their API. Those guides will help you to go further than the example above. The getting started show you how to install the CRDs from their repository. Thus, keep in mind that the Traefik Gateway provider only supports the v0.1.0.

For now, the Traefik Gateway Provider could be used to achieve the following set-up guides:

Resource Configuration

When using Kubernetes Gateway API as a provider, Traefik uses Kubernetes Custom Resource Definition to retrieve its routing configuration.

All concepts can be found in the official API concepts documentation. Traefik implements the following resources:

  • GatewayClass defines a set of Gateways that share a common configuration and behaviour.
  • Gateway describes how traffic can be translated to Services within the cluster.
  • HTTPRoute define HTTP rules for mapping requests from a Gateway to Kubernetes Services.

Provider Configuration

endpoint

Optional, Default=empty

File (TOML)

  1. [providers.kubernetesGateway]
  2.   endpoint = "http://localhost:8080"
  3.   # ...

File (YAML)

  1. providers:
  2.   kubernetesGateway:
  3.     endpoint: "http://localhost:8080"
  4.     # ...

CLI

  1. --providers.kubernetesgateway.endpoint=http://localhost:8080

The Kubernetes server endpoint as URL.

When deployed into Kubernetes, Traefik will read the environment variables KUBERNETES_SERVICE_HOST and KUBERNETES_SERVICE_PORT or KUBECONFIG to construct the endpoint.

The access token will be looked up in /var/run/secrets/kubernetes.io/serviceaccount/token and the SSL CA certificate in /var/run/secrets/kubernetes.io/serviceaccount/ca.crt. Both are mounted automatically when deployed inside Kubernetes.

The endpoint may be specified to override the environment variable values inside a cluster.

When the environment variables are not found, Traefik will try to connect to the Kubernetes API server with an external-cluster client. In this case, the endpoint is required. Specifically, it may be set to the URL used by kubectl proxy to connect to a Kubernetes cluster using the granted authentication and authorization of the associated kubeconfig.

token

Optional, Default=empty

File (TOML)

  1. [providers.kubernetesGateway]
  2.   token = "mytoken"
  3.   # ...

File (YAML)

  1. providers:
  2.   kubernetesGateway:
  3.     token: "mytoken"
  4.     # ...

CLI

  1. --providers.kubernetesgateway.token=mytoken

Bearer token used for the Kubernetes client configuration.

certAuthFilePath

Optional, Default=empty

File (TOML)

  1. [providers.kubernetesGateway]
  2.   certAuthFilePath = "/my/ca.crt"
  3.   # ...

File (YAML)

  1. providers:
  2.   kubernetesGateway:
  3.     certAuthFilePath: "/my/ca.crt"
  4.     # ...

CLI

  1. --providers.kubernetesgateway.certauthfilepath=/my/ca.crt

Path to the certificate authority file. Used for the Kubernetes client configuration.

namespaces

Optional, Default: all namespaces (empty array)

File (TOML)

  1. [providers.kubernetesGateway]
  2.   namespaces = ["default", "production"]
  3.   # ...

File (YAML)

  1. providers:
  2.   kubernetesGateway:
  3.     namespaces:
  4.     - "default"
  5.     - "production"
  6.     # ...

CLI

  1. --providers.kubernetesgateway.namespaces=default,production

Array of namespaces to watch.

labelselector

Optional, Default: empty (process all resources)

File (TOML)

  1. [providers.kubernetesGateway]
  2.   labelselector = "app=traefik"
  3.   # ...

File (YAML)

  1. providers:
  2.   kubernetesGateway:
  3.     labelselector: "app=traefik"
  4.     # ...

CLI

  1. --providers.kubernetesgateway.labelselector="app=traefik"

By default, Traefik processes all resource objects in the configured namespaces. A label selector can be defined to filter on specific GatewayClass objects only.

See label-selectors for details.

throttleDuration

Optional, Default: 0 (no throttling)

File (TOML)

  1. [providers.kubernetesGateway]
  2.   throttleDuration = "10s"
  3.   # ...

File (YAML)

  1. providers:
  2.   kubernetesGateway:
  3.     throttleDuration: "10s"
  4.     # ...

CLI

  1. --providers.kubernetesgateway.throttleDuration=10s