ListenerSetPolicy

ListenerSetPolicy is a Gwin custom resource for configuring listener-level policies for ListenerSet resources. It allows you to define HTTP protocol settings, stream timeouts, and ALB resource naming that apply to ListenerSet resources matched by name or label selector.

ListenerSetPolicy and ListenerSet annotations are equivalent ways to configure the same settings. Use ListenerSetPolicy when you want to apply the same settings to multiple ListenerSets or manage policy separately from the ListenerSet resource.

• Cheatsheet
• ListenerSetPolicySpec
  • LocalObjectReference
  • LabelSelector
  • LabelSelectorRequirement
  • ListenerSetPolicyConfig
  • GatewayListener
  • Listener
  • ListenerHTTP
  • HTTPProtocolSettings
  • HTTP2Options
  • ListenerStream
• ListenerSetPolicyStatus

CheatsheetCheatsheet

apiVersion: gwin.yandex.cloud/v1
kind: ListenerSetPolicy
metadata:
  name: my-policy
  namespace: my-ns  # policy only matches ListenerSets in the same namespace
spec:
  targetRefs:
    - kind: ListenerSet
      name: my-listenerset  # target a specific ListenerSet by name
  selector:
    matchLabels:
      team: backend  # or target all ListenerSets with this label
  policy:
    listeners:  # applies to all listeners in matched ListenerSets
      albListenerName: "my-alb-listener"
      http:
        protocolSettings:
          allowHTTP10: "true"
          http2Options:
            maxConcurrentStreams: "100"
      stream:
        idleTimeout: "300s"
    listener:
      my-https-listener:  # applies only to the listener named "my-https-listener"
        albListenerName: "my-https-alb-listener"
        albHTTPRouterName: "my-https-router"
        http:
          protocolSettings:
            allowHTTP10: "false"
        attach:  # manage virtual hosts in an existing HTTP router
          virtualHosts:
            httpRouterID: "http-router-id"

ListenerSetPolicySpecListenerSetPolicySpec

Appears in: ListenerSetPolicy

The policy is restricted to ListenerSet resources within the same namespace.

When determining which resources the policy applies to, the following rules are used:

• If both targetRefs and selector are specified, a resource must match both criteria.
• If neither is specified, the policy applies to all ListenerSets in the same namespace.

LocalObjectReferenceLocalObjectReference

Reference to a resource in the same namespace.

Appears in: ListenerSetPolicySpec

LabelSelectorLabelSelector

Label-based selection criteria for ListenerSets.

Appears in: ListenerSetPolicySpec

LabelSelectorRequirementLabelSelectorRequirement

Appears in: LabelSelector

ListenerSetPolicyConfigListenerSetPolicyConfig

Policy configuration for listeners in the matched ListenerSet.

Appears in: ListenerSetPolicySpec

GatewayListenerGatewayListener

Settings for a listener.

Appears in: ListenerSetPolicyConfig

HTTPRouterAttachHTTPRouterAttach

Attachment to an existing cloud HTTP router.

Appears in: GatewayListener

VirtualHostsAttachVirtualHostsAttach

Appears in: HTTPRouterAttach

ListenerListener

Base listener settings (embedded in GatewayListener).

Appears in: GatewayListener

ListenerHTTPListenerHTTP

HTTP-specific listener settings.

Appears in: GatewayListener

HTTPProtocolSettingsHTTPProtocolSettings

HTTP protocol options.

Appears in: ListenerHTTP

HTTP2OptionsHTTP2Options

HTTP/2 connection settings.

Appears in: HTTPProtocolSettings

ListenerStreamListenerStream

Stream listener settings.

Appears in: GatewayListener

ListenerSetPolicyStatusListenerSetPolicyStatus

Appears in: ListenerSetPolicy