hex.k8s.traefik

• Latest: 39.0.6
• Latest date: 2026-03-20
• Version count: 52
• Source: json module
• values.yaml: link
• pinned latest sha256: 13vfhsgjvzl8mkq2rdqa5cg3q63v3v3kpjvakg3i8nbca4rqid3n
• extra helper functions: 10

Copy Pinned Spec

(hex.k8s.traefik.version.v39-0-6 {
  valuesAttrs = {};
})

Helper Functions

hex.k8s.traefik.ingress_route.build

Usage

render an IngressRoute resource to YAML using the args accepted by ingress_route.setup.

returns YAML as a string; ingress_route.setup returns an attrset.

Copy Call Skeleton

(hex.k8s.traefik.ingress_route.build {
  name = "build";
  domain = "https://example.com";
})

Required Args

Arg	Type	Notes
name	string	IngressRoute resource name
domain	string	host or host regexp matched by the route

Optional Args

Arg	Type	Default	Notes
regex	bool	false	use HostRegexp instead of Host
port	number	80	backend service port
namespace	string	"default"	backend service namespace
service	string	name	backend service name
serviceScheme	string	if port == 443 then "https" else "http"	backend service scheme
extraService	attrset	{ }	extra fields merged into primary service entry
extraServices	list	[ ]	additional service entries appended to services
internal	bool	true	switch ingress class between internal and external traefik
secretName	string	""	TLS secret name, empty string disables TLS
labels	list	[ ]	metadata labels list inserted when non-empty
middlewares	list	[ ]	middleware refs attached to the route
extraRule	attrset	{ }	extra fields merged into route rule
extraRoutes	list	[ ]	additional route entries appended to spec.routes
extraSpec	attrset	{ }	extra fields merged into spec
ingressRouteNamespace	string	"default"	namespace for the IngressRoute resource
pre23	bool	false	use legacy traefik.containo.us API group
apiVersion	string	if pre23 then "traefik.containo.us/v1alpha1" else "traefik.io/v1alpha1"	override Traefik CRD apiVersion

hex.k8s.traefik.ingress_route.setup

Usage

build an IngressRoute resource attrset for host routing and middleware wiring.

Copy Call Skeleton

(hex.k8s.traefik.ingress_route.setup {
  name = "setup";
  domain = "https://example.com";
})

Required Args

Arg	Type	Notes
name	string	IngressRoute resource name
domain	string	host or host regexp matched by the route

Optional Args

Arg	Type	Default	Notes
regex	bool	false	use HostRegexp instead of Host
port	number	80	backend service port
namespace	string	"default"	backend service namespace
service	string	name	backend service name
serviceScheme	string	if port == 443 then "https" else "http"	backend service scheme
extraService	attrset	{ }	extra fields merged into primary service entry
extraServices	list	[ ]	additional service entries appended to services
internal	bool	true	switch ingress class between internal and external traefik
secretName	string	""	TLS secret name, empty string disables TLS
labels	list	[ ]	metadata labels list inserted when non-empty
middlewares	list	[ ]	middleware refs attached to the route
extraRule	attrset	{ }	extra fields merged into route rule
extraRoutes	list	[ ]	additional route entries appended to spec.routes
extraSpec	attrset	{ }	extra fields merged into spec
ingressRouteNamespace	string	"default"	namespace for the IngressRoute resource
pre23	bool	false	use legacy traefik.containo.us API group
apiVersion	string	if pre23 then "traefik.containo.us/v1alpha1" else "traefik.io/v1alpha1"	override Traefik CRD apiVersion

hex.k8s.traefik.middleware._.add_prefix

Usage

create an addPrefix middleware that prepends a path prefix.

Copy Call Skeleton

(hex.k8s.traefik.middleware._.add_prefix {
  prefix = "TODO";
})

Required Args

Arg	Type	Notes
prefix	string	prefix to prepend to request paths

Optional Args

Arg	Type	Default	Notes
name	string	"add-prefix"	Middleware resource name
extraSpec	attrset	{ }	extra fields merged at resource root

hex.k8s.traefik.middleware._.compress

Usage

create a compress middleware for HTTP response compression.

Copy Call Skeleton

(hex.k8s.traefik.middleware._.compress {
})

Required Args

Arg	Type	Notes

Optional Args

Arg	Type	Default	Notes
name	string	"compress"	Middleware resource name
extraSpec	attrset	{ }	extra fields merged at resource root

hex.k8s.traefik.middleware._.default_index

Usage

create a middleware that rewrites / to /index.html.

Copy Call Skeleton

(hex.k8s.traefik.middleware._.default_index {
})

Required Args

Arg	Type	Notes

Optional Args

Arg	Type	Default	Notes
name	string	"default-index"	Middleware resource name
extraSpec	attrset	{ }	extra fields merged at resource root

hex.k8s.traefik.middleware._.ip_allowlist

Usage

create an ipAllowList middleware with allowed source ranges.

Copy Call Skeleton

(hex.k8s.traefik.middleware._.ip_allowlist {
  ips = [ ];
})

Required Args

Arg	Type	Notes
ips	list	CIDR ranges allowed to access matching routes

Optional Args

Arg	Type	Default	Notes
name	string	"ip-allowlist"	Middleware resource name
extraSpec	attrset	{ }	extra fields merged at resource root

hex.k8s.traefik.middleware._.ip_whitelist

Usage

create a legacy ipWhiteList middleware with allowed source ranges.

Copy Call Skeleton

(hex.k8s.traefik.middleware._.ip_whitelist {
  ips = [ ];
})

Required Args

Arg	Type	Notes
ips	list	CIDR ranges allowed to access matching routes

Optional Args

Arg	Type	Default	Notes
name	string	"ip-whitelist"	Middleware resource name
extraSpec	attrset	{ }	extra fields merged at resource root

hex.k8s.traefik.middleware._.strip_prefix

Usage

create a stripPrefix middleware that removes path prefixes.

Copy Call Skeleton

(hex.k8s.traefik.middleware._.strip_prefix {
  prefixes = [ ];
})

Required Args

Arg	Type	Notes
prefixes	list	prefixes to strip from request paths

Optional Args

Arg	Type	Default	Notes
name	string	"strip-prefix"	Middleware resource name
extraSpec	attrset	{ }	extra fields merged at resource root

hex.k8s.traefik.middleware.build

Usage

render a Middleware resource to YAML using the args accepted by middleware.setup.

returns YAML as a string; middleware.setup returns an attrset.

Copy Call Skeleton

(hex.k8s.traefik.middleware.build {
  name = "build";
  spec = { };
})

Required Args

Arg	Type	Notes
name	string	Middleware resource name
spec	attrset	middleware spec body (addPrefix/stripPrefix/etc)

Optional Args

Arg	Type	Default	Notes
kind	string	"Middleware"	Kubernetes resource kind to render
pre23	bool	false	use legacy traefik.containo.us API group
apiVersion	string	if pre23 then "traefik.containo.us/v1alpha1" else "traefik.io/v1alpha1"	override Traefik CRD apiVersion
extraSpec	attrset	{ }	extra fields merged at resource root

hex.k8s.traefik.middleware.setup

Usage

build a generic Middleware resource attrset for custom middleware specs.

Copy Call Skeleton

(hex.k8s.traefik.middleware.setup {
  name = "setup";
  spec = { };
})

Required Args

Arg	Type	Notes
name	string	Middleware resource name
spec	attrset	middleware spec body (addPrefix/stripPrefix/etc)

Optional Args

Arg	Type	Default	Notes
kind	string	"Middleware"	Kubernetes resource kind to render
pre23	bool	false	use legacy traefik.containo.us API group
apiVersion	string	if pre23 then "traefik.containo.us/v1alpha1" else "traefik.io/v1alpha1"	override Traefik CRD apiVersion
extraSpec	attrset	{ }	extra fields merged at resource root

Versions

Version	Date	Attr
39.0.6	2026-03-20	hex.k8s.traefik.version.v39-0-6
39.0.5	2026-03-09	hex.k8s.traefik.version.v39-0-5
39.0.4	2026-03-05	hex.k8s.traefik.version.v39-0-4
39.0.3	2026-03-05	hex.k8s.traefik.version.v39-0-3
39.0.2	2026-02-20	hex.k8s.traefik.version.v39-0-2
39.0.1	2026-02-13	hex.k8s.traefik.version.v39-0-1
39.0.0	2026-01-23	hex.k8s.traefik.version.v39-0-0
38.0.2	2026-01-08	hex.k8s.traefik.version.v38-0-2
38.0.1	2025-12-19	hex.k8s.traefik.version.v38-0-1
38.0.0	2025-12-18	hex.k8s.traefik.version.v38-0-0
37.4.0	2025-11-21	hex.k8s.traefik.version.v37-4-0
37.3.0	2025-11-10	hex.k8s.traefik.version.v37-3-0
37.2.0	2025-10-22	hex.k8s.traefik.version.v37-2-0
37.1.2	2025-10-03	hex.k8s.traefik.version.v37-1-2
37.1.1	2025-09-10	hex.k8s.traefik.version.v37-1-1
37.1.0	2025-09-03	hex.k8s.traefik.version.v37-1-0
37.0.0	2025-07-30	hex.k8s.traefik.version.v37-0-0
36.3.0	2025-07-01	hex.k8s.traefik.version.v36-3-0
36.2.0	2025-06-24	hex.k8s.traefik.version.v36-2-0
36.1.0	2025-06-11	hex.k8s.traefik.version.v36-1-0
36.0.0	2025-06-06	hex.k8s.traefik.version.v36-0-0
35.4.0	2025-05-23	hex.k8s.traefik.version.v35-4-0
35.3.0	2025-05-19	hex.k8s.traefik.version.v35-3-0
35.2.0	2025-04-29	hex.k8s.traefik.version.v35-2-0
35.1.0	2025-04-25	hex.k8s.traefik.version.v35-1-0
35.0.1	2025-04-18	hex.k8s.traefik.version.v35-0-1
34.5.0	2025-03-31	hex.k8s.traefik.version.v34-5-0
34.4.1	2025-03-04	hex.k8s.traefik.version.v34-4-1
34.3.0	2025-02-07	hex.k8s.traefik.version.v34-3-0
34.2.0	2025-01-28	hex.k8s.traefik.version.v34-2-0
34.1.0	2025-01-15	hex.k8s.traefik.version.v34-1-0
33.2.1	2024-12-13	hex.k8s.traefik.version.v33-2-1
33.1.0	2024-12-02	hex.k8s.traefik.version.v33-1-0
33.0.0	2024-10-30	hex.k8s.traefik.version.v33-0-0
32.1.1	2024-10-11	hex.k8s.traefik.version.v32-1-1
32.0.0	2024-09-27	hex.k8s.traefik.version.v32-0-0
31.1.1	2024-09-20	hex.k8s.traefik.version.v31-1-1
31.0.0	2024-09-03	hex.k8s.traefik.version.v31-0-0
30.1.0	2024-08-16	hex.k8s.traefik.version.v30-1-0
29.0.1	2024-07-09	hex.k8s.traefik.version.v29-0-1
28.3.0	2024-06-14	hex.k8s.traefik.version.v28-3-0
27.0.2	2024-04-12	hex.k8s.traefik.version.v27-0-2
26.1.0	2024-02-19	hex.k8s.traefik.version.v26-1-0
25.0.0	2023-10-23	hex.k8s.traefik.version.v25-0-0
24.0.0	2023-08-10	hex.k8s.traefik.version.v24-0-0
23.2.0	2023-07-27	hex.k8s.traefik.version.v23-2-0
22.3.0	-	hex.k8s.traefik.version.v22-3-0
21.2.1	-	hex.k8s.traefik.version.v21-2-1
20.8.0	-	hex.k8s.traefik.version.v20-8-0
19.0.4	-	hex.k8s.traefik.version.v19-0-4
12.0.7	-	hex.k8s.traefik.version.v12-0-7
10.33.0	-	hex.k8s.traefik.version.v10-33-0

Back to Chart Index