NAME

IO::K8s::Traefik::V1alpha1::Service - Service defines an upstream HTTP service to proxy traffic to.

VERSION

version 1.108

healthCheck

Healthcheck defines health checks for ExternalName services.

kind

Kind defines the kind of the Service.

middlewares

Middlewares defines the list of references to Middleware resources to apply to the service.

name

Name defines the name of the referenced Kubernetes Service or TraefikService. The differentiation between the two is specified in the Kind field.

namespace

Namespace defines the namespace of the referenced Kubernetes Service or TraefikService.

nativeLB

NativeLB controls, when creating the load-balancer, whether the LB's children are directly the pods IPs or if the only child is the Kubernetes Service clusterIP. The Kubernetes Service itself does load-balance to the pods. By default, NativeLB is false.

nodePortLB

NodePortLB controls, when creating the load-balancer, whether the LB's children are directly the nodes internal IPs using the nodePort when the service type is NodePort. It allows services to be reachable when Traefik runs externally from the Kubernetes cluster but within the same network of the nodes. By default, NodePortLB is false.

passHostHeader

PassHostHeader defines whether the client Host header is forwarded to the upstream Kubernetes Service. By default, passHostHeader is true.

passiveHealthCheck

PassiveHealthCheck defines passive health checks for ExternalName services.

port

Port defines the port of a Kubernetes Service. This can be a reference to a named port.

responseForwarding

ResponseForwarding defines how Traefik forwards the response from the upstream Kubernetes Service to the client.

scheme

Scheme defines the scheme to use for the request to the upstream Kubernetes Service. It defaults to https when Kubernetes Service port is 443, http otherwise.

serversTransport

ServersTransport defines the name of ServersTransport resource to use. It allows to configure the transport between Traefik and your servers. Can only be used on a Kubernetes Service.

sticky

Sticky defines the sticky sessions configuration. More info: https://doc.traefik.io/traefik/v3.7/reference/routing-configuration/http/load-balancing/service/#sticky-sessions

strategy

Strategy defines the load balancing strategy between the servers. Supported values are: wrr (Weighed round-robin), p2c (Power of two choices), hrw (Highest Random Weight), and leasttime (Least-Time). RoundRobin value is deprecated and supported for backward compatibility.

weight

Weight defines the weight and should only be specified when Name references a TraefikService object (and to be precise, one that embeds a Weighted Round Robin).

SUPPORT

Issues

Please report bugs and feature requests on GitHub at https://github.com/pplu/io-k8s-p5/issues.

CONTRIBUTING

Contributions are welcome! Please fork the repository and submit a pull request.

AUTHORS

  • Torsten Raudssus <getty@cpan.org>

  • Jose Luis Martinez Torres <jlmartin@cpan.org>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2018-2026 by Jose Luis Martinez Torres <jlmartin@cpan.org>.

This is free software, licensed under:

The Apache License, Version 2.0, January 2004