393 lines
18 KiB
Markdown
393 lines
18 KiB
Markdown
|
# Traefik & KV Stores
|
||
|
|
|
||
|
|
A Story of key & values
|
||
|
|
{: .subtitle }
|
||
|
|
|
||
|
|
## Routing Configuration
|
||
|
|
|
||
|
|
!!! info "Keys"
|
||
|
|
|
||
|
|
- Keys are case insensitive.
|
||
|
|
- The complete list of keys can be found in [the reference page](../../reference/dynamic-configuration/kv.md).
|
||
|
|
|
||
|
|
### Routers
|
||
|
|
|
||
|
|
!!! warning "The character `@` is not authorized in the router name `<router_name>`."
|
||
|
|
|
||
|
|
??? info "`traefik/http/routers/<router_name>/rule`"
|
||
|
|
|
||
|
|
See [rule](../routers/index.md#rule) for more information.
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|--------------------------------------|----------------------------|
|
||
|
|
| `traefik/http/routers/myrouter/rule` | ```Host(`mydomain.com`)``` |
|
||
|
|
|
||
|
|
??? info "`traefik/http/routers/<router_name>/entrypoints`"
|
||
|
|
|
||
|
|
See [entry points](../routers/index.md#entrypoints) for more information.
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|-----------------------------------------------|-------------|
|
||
|
|
| `traefik.http.routers.myrouter.entrypoints/0` | `web` |
|
||
|
|
| `traefik.http.routers.myrouter.entrypoints/1` | `websecure` |
|
||
|
|
|
||
|
|
??? info "`traefik/http/routers/<router_name>/middlewares`"
|
||
|
|
|
||
|
|
See [middlewares](../routers/index.md#middlewares) and [middlewares overview](../../middlewares/overview.md) for more information.
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|-----------------------------------------------|-------------|
|
||
|
|
| `traefik/http/routers/myrouter/middlewares/0` | `auth` |
|
||
|
|
| `traefik/http/routers/myrouter/middlewares/1` | `prefix` |
|
||
|
|
| `traefik/http/routers/myrouter/middlewares/2` | `cb` |
|
||
|
|
|
||
|
|
??? info "`traefik/http/routers/<router_name>/service`"
|
||
|
|
|
||
|
|
See [rule](../routers/index.md#service) for more information.
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|-----------------------------------------|-------------|
|
||
|
|
| `traefik/http/routers/myrouter/service` | `myservice` |
|
||
|
|
|
||
|
|
??? info "`traefik/http/routers/<router_name>/tls`"
|
||
|
|
|
||
|
|
See [tls](../routers/index.md#tls) for more information.
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|-------------------------------------|--------|
|
||
|
|
| `traefik/http/routers/myrouter/tls` | `true` |
|
||
|
|
|
||
|
|
??? info "`traefik/http/routers/<router_name>/tls/certresolver`"
|
||
|
|
|
||
|
|
See [certResolver](../routers/index.md#certresolver) for more information.
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|--------------------------------------------------|--------------|
|
||
|
|
| `traefik/http/routers/myrouter/tls/certresolver` | `myresolver` |
|
||
|
|
|
||
|
|
??? info "`traefik/http/routers/<router_name>/tls/domains/<n>/main`"
|
||
|
|
|
||
|
|
See [domains](../routers/index.md#domains) for more information.
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|----------------------------------------------------|--------------|
|
||
|
|
| `traefik/http/routers/myrouter/tls/domains/0/main` | `foobar.com` |
|
||
|
|
|
||
|
|
??? info "`traefik/http/routers/<router_name>/tls/domains/<n>/sans/<n>`"
|
||
|
|
|
||
|
|
See [domains](../routers/index.md#domains) for more information.
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|------------------------------------------------------|-------------------|
|
||
|
|
| `traefik/http/routers/myrouter/tls/domains/0/sans/0` | `test.foobar.com` |
|
||
|
|
| `traefik/http/routers/myrouter/tls/domains/0/sans/1` | `dev.foobar.com` |
|
||
|
|
|
||
|
|
??? info "`traefik/http/routers/<router_name>/tls/options`"
|
||
|
|
|
||
|
|
See [options](../routers/index.md#options) for more information.
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|---------------------------------------------|----------|
|
||
|
|
| `traefik/http/routers/myrouter/tls/options` | `foobar` |
|
||
|
|
|
||
|
|
??? info "`traefik/http/routers/<router_name>/priority`"
|
||
|
|
|
||
|
|
See [priority](../routers/index.md#priority) for more information.
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|------------------------------------------|-------|
|
||
|
|
| `traefik/http/routers/myrouter/priority` | `42` |
|
||
|
|
|
||
|
|
### Services
|
||
|
|
|
||
|
|
!!! warning "The character `@` is not authorized in the service name `<service_name>`."
|
||
|
|
|
||
|
|
??? info "`traefik/http/services/<service_name>/loadbalancer/servers/<n>/url`"
|
||
|
|
|
||
|
|
See [servers](../services/index.md#servers) for more information.
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|-----------------------------------------------------------------|--------|
|
||
|
|
| `traefik/http/services/myservice/loadbalancer/servers/0/scheme` | `http` |
|
||
|
|
|
||
|
|
??? info "`traefik/http/services/<service_name>/loadbalancer/servers/<n>/scheme`"
|
||
|
|
|
||
|
|
Overrides the default scheme.
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|-----------------------------------------------------------------|--------|
|
||
|
|
| `traefik/http/services/myservice/loadbalancer/servers/0/scheme` | `http` |
|
||
|
|
|
||
|
|
??? info "`traefik/http/services/<service_name>/loadbalancer/passhostheader`"
|
||
|
|
|
||
|
|
See [pass Host header](../services/index.md#pass-host-header) for more information.
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|-----------------------------------------------------------------|--------|
|
||
|
|
| `traefik/http/services/myservice/loadbalancer/passhostheader` | `true` |
|
||
|
|
|
||
|
|
??? info "`traefik/http/services/<service_name>/loadbalancer/healthcheck/headers/<header_name>`"
|
||
|
|
|
||
|
|
See [health check](../services/index.md#health-check) for more information.
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|--------------------------------------------------------------------------|----------|
|
||
|
|
| `traefik/http/services/myservice/loadbalancer/healthcheck/headers/X-Foo` | `foobar` |
|
||
|
|
|
||
|
|
??? info "`traefik/http/services/<service_name>/loadbalancer/healthcheck/hostname`"
|
||
|
|
|
||
|
|
See [health check](../services/index.md#health-check) for more information.
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|---------------------------------------------------------------------|--------------|
|
||
|
|
| `traefik/http/services/myservice/loadbalancer/healthcheck/hostname` | `foobar.com` |
|
||
|
|
|
||
|
|
??? info "`traefik/http/services/<service_name>/loadbalancer/healthcheck/interval`"
|
||
|
|
|
||
|
|
See [health check](../services/index.md#health-check) for more information.
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|---------------------------------------------------------------------|-------|
|
||
|
|
| `traefik/http/services/myservice/loadbalancer/healthcheck/interval` | `10` |
|
||
|
|
|
||
|
|
??? info "`traefik/http/services/<service_name>/loadbalancer/healthcheck/path`"
|
||
|
|
|
||
|
|
See [health check](../services/index.md#health-check) for more information.
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|-----------------------------------------------------------------|--------|
|
||
|
|
| `traefik/http/services/myservice/loadbalancer/healthcheck/path` | `/foo` |
|
||
|
|
|
||
|
|
??? info "`traefik/http/services/<service_name>/loadbalancer/healthcheck/port`"
|
||
|
|
|
||
|
|
See [health check](../services/index.md#health-check) for more information.
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|-----------------------------------------------------------------|-------|
|
||
|
|
| `traefik/http/services/myservice/loadbalancer/healthcheck/port` | `42` |
|
||
|
|
|
||
|
|
??? info "`traefik/http/services/<service_name>/loadbalancer/healthcheck/scheme`"
|
||
|
|
|
||
|
|
See [health check](../services/index.md#health-check) for more information.
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|-------------------------------------------------------------------|--------|
|
||
|
|
| `traefik/http/services/myservice/loadbalancer/healthcheck/scheme` | `http` |
|
||
|
|
|
||
|
|
??? info "`traefik/http/services/<service_name>/loadbalancer/healthcheck/timeout`"
|
||
|
|
|
||
|
|
See [health check](../services/index.md#health-check) for more information.
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|--------------------------------------------------------------------|-------|
|
||
|
|
| `traefik/http/services/myservice/loadbalancer/healthcheck/timeout` | `10` |
|
||
|
|
|
||
|
|
??? info "`traefik/http/services/<service_name>/loadbalancer/sticky`"
|
||
|
|
|
||
|
|
See [sticky sessions](../services/index.md#sticky-sessions) for more information.
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|-------------------------------------------------------|--------|
|
||
|
|
| `traefik/http/services/myservice/loadbalancer/sticky` | `true` |
|
||
|
|
|
||
|
|
??? info "`traefik/http/services/<service_name>/loadbalancer/sticky/cookie/httponly`"
|
||
|
|
|
||
|
|
See [sticky sessions](../services/index.md#sticky-sessions) for more information.
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|-----------------------------------------------------------------------|--------|
|
||
|
|
| `traefik/http/services/myservice/loadbalancer/sticky/cookie/httponly` | `true` |
|
||
|
|
|
||
|
|
??? info "`traefik/http/services/<service_name>/loadbalancer/sticky/cookie/name`"
|
||
|
|
|
||
|
|
See [sticky sessions](../services/index.md#sticky-sessions) for more information.
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|-------------------------------------------------------------------|----------|
|
||
|
|
| `traefik/http/services/myservice/loadbalancer/sticky/cookie/name` | `foobar` |
|
||
|
|
|
||
|
|
??? info "`traefik/http/services/<service_name>/loadbalancer/sticky/cookie/secure`"
|
||
|
|
|
||
|
|
See [sticky sessions](../services/index.md#sticky-sessions) for more information.
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|---------------------------------------------------------------------|--------|
|
||
|
|
| `traefik/http/services/myservice/loadbalancer/sticky/cookie/secure` | `true` |
|
||
|
|
|
||
|
|
??? info "`traefik/http/services/<service_name>/loadbalancer/responseforwarding/flushinterval`"
|
||
|
|
|
||
|
|
See [response forwarding](../services/index.md#response-forwarding) for more information.
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|---------------------------------------------------------------------------------|-------|
|
||
|
|
| `traefik/http/services/myservice/loadbalancer/responseforwarding/flushinterval` | `10` |
|
||
|
|
|
||
|
|
??? info "`traefik/http/services/<service_name>/mirroring/service`"
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|----------------------------------------------------------|----------|
|
||
|
|
| `traefik/http/services/<service_name>/mirroring/service` | `foobar` |
|
||
|
|
|
||
|
|
??? info "`traefik/http/services/<service_name>/mirroring/mirrors/<n>/name`"
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|-------------------------------------------------------------------|----------|
|
||
|
|
| `traefik/http/services/<service_name>/mirroring/mirrors/<n>/name` | `foobar` |
|
||
|
|
|
||
|
|
??? info "`traefik/http/services/<service_name>/mirroring/mirrors/<n>/percent`"
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|----------------------------------------------------------------------|-------|
|
||
|
|
| `traefik/http/services/<service_name>/mirroring/mirrors/<n>/percent` | `42` |
|
||
|
|
|
||
|
|
??? info "`traefik/http/services/<service_name>/weighted/services/<n>/name`"
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|-------------------------------------------------------------------|----------|
|
||
|
|
| `traefik/http/services/<service_name>/weighted/services/<n>/name` | `foobar` |
|
||
|
|
|
||
|
|
??? info "`traefik/http/services/<service_name>/weighted/services/<n>/weight`"
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|---------------------------------------------------------------------|-------|
|
||
|
|
| `traefik/http/services/<service_name>/weighted/services/<n>/weight` | `42` |
|
||
|
|
|
||
|
|
??? info "`traefik/http/services/<service_name>/weighted/sticky/cookie/name`"
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|--------------------------------------------------------------------|----------|
|
||
|
|
| `traefik/http/services/<service_name>/weighted/sticky/cookie/name` | `foobar` |
|
||
|
|
|
||
|
|
??? info "`traefik/http/services/<service_name>/weighted/sticky/cookie/secure`"
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|----------------------------------------------------------------------|--------|
|
||
|
|
| `traefik/http/services/<service_name>/weighted/sticky/cookie/secure` | `true` |
|
||
|
|
|
||
|
|
??? info "`traefik/http/services/<service_name>/weighted/sticky/cookie/httpOnly`"
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|------------------------------------------------------------------------|--------|
|
||
|
|
| `traefik/http/services/<service_name>/weighted/sticky/cookie/httpOnly` | `true` |
|
||
|
|
|
||
|
|
### Middleware
|
||
|
|
|
||
|
|
More information about available middlewares in the dedicated [middlewares section](../../middlewares/overview.md).
|
||
|
|
|
||
|
|
!!! warning "The character `@` is not authorized in the middleware name."
|
||
|
|
|
||
|
|
!!! warning "Conflicts in Declaration"
|
||
|
|
|
||
|
|
If you declare multiple middleware with the same name but with different parameters, the middleware fails to be declared.
|
||
|
|
|
||
|
|
### TCP
|
||
|
|
|
||
|
|
You can declare TCP Routers and/or Services using KV.
|
||
|
|
|
||
|
|
#### TCP Routers
|
||
|
|
|
||
|
|
??? info "`traefik/tcp/routers/<router_name>/entrypoints`"
|
||
|
|
|
||
|
|
See [entry points](../routers/index.md#entrypoints_1) for more information.
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|-------------------------------------------------|-------|
|
||
|
|
| `traefik/tcp/routers/mytcprouter/entrypoints/0` | `ep1` |
|
||
|
|
| `traefik/tcp/routers/mytcprouter/entrypoints/1` | `ep2` |
|
||
|
|
|
||
|
|
??? info "`traefik/tcp/routers/<router_name>/rule`"
|
||
|
|
|
||
|
|
See [rule](../routers/index.md#rule_1) for more information.
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|--------------------------------------|------------------------------|
|
||
|
|
| `traefik/tcp/routers/my-router/rule` | ```HostSNI(`my-host.com`)``` |
|
||
|
|
|
||
|
|
??? info "`traefik/tcp/routers/<router_name>/service`"
|
||
|
|
|
||
|
|
See [service](../routers/index.md#services) for more information.
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|-------------------------------------------|-------------|
|
||
|
|
| `traefik/tcp/routers/mytcprouter/service` | `myservice` |
|
||
|
|
|
||
|
|
??? info "`traefik/tcp/routers/<router_name>/tls`"
|
||
|
|
|
||
|
|
See [TLS](../routers/index.md#tls_1) for more information.
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|---------------------------------------|--------|
|
||
|
|
| `traefik/tcp/routers/mytcprouter/tls` | `true` |
|
||
|
|
|
||
|
|
??? info "`traefik/tcp/routers/<router_name>/tls/certresolver`"
|
||
|
|
|
||
|
|
See [certResolver](../routers/index.md#certresolver_1) for more information.
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|----------------------------------------------------|--------------|
|
||
|
|
| `traefik/tcp/routers/mytcprouter/tls/certresolver` | `myresolver` |
|
||
|
|
|
||
|
|
??? info "`traefik/tcp/routers/<router_name>/tls/domains/<n>/main`"
|
||
|
|
|
||
|
|
See [domains](../routers/index.md#domains_1) for more information.
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|------------------------------------------------------|--------------|
|
||
|
|
| `traefik/tcp/routers/mytcprouter/tls/domains/0/main` | `foobar.com` |
|
||
|
|
|
||
|
|
??? info "`traefik/tcp/routers/<router_name>/tls/domains/<n>/sans`"
|
||
|
|
|
||
|
|
See [domains](../routers/index.md#domains_1) for more information.
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|--------------------------------------------------------|-------------------|
|
||
|
|
| `traefik/tcp/routers/mytcprouter/tls/domains/0/sans/0` | `test.foobar.com` |
|
||
|
|
| `traefik/tcp/routers/mytcprouter/tls/domains/0/sans/1` | `dev.foobar.com` |
|
||
|
|
|
||
|
|
??? info "`traefik/tcp/routers/<router_name>/tls/options`"
|
||
|
|
|
||
|
|
See [options](../routers/index.md#options_1) for more information.
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|-----------------------------------------------|----------|
|
||
|
|
| `traefik/tcp/routers/mytcprouter/tls/options` | `foobar` |
|
||
|
|
|
||
|
|
|
||
|
|
??? info "`traefik/tcp/routers/<router_name>/tls/passthrough`"
|
||
|
|
|
||
|
|
See [TLS](../routers/index.md#tls_1) for more information.
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|---------------------------------------------------|--------|
|
||
|
|
| `traefik/tcp/routers/mytcprouter/tls/passthrough` | `true` |
|
||
|
|
|
||
|
|
#### TCP Services
|
||
|
|
|
||
|
|
??? info "`traefik/tcp/services/<service_name>/loadbalancer/servers/<n>/url`"
|
||
|
|
|
||
|
|
See [servers](../services/index.md#servers) for more information.
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|-------------------------------------------------------------------|--------|
|
||
|
|
| `traefik/tcp/services/mytcpservice/loadbalancer/servers/0/scheme` | `http` |
|
||
|
|
|
||
|
|
??? info "`traefik/tcp/services/<service_name>/loadbalancer/terminationdelay`"
|
||
|
|
|
||
|
|
See [termination delay](../services/index.md#termination-delay) for more information.
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|-------------------------------------------------------------------|-------|
|
||
|
|
| `traefik/tcp/services/mytcpservice/loadbalancer/terminationdelay` | `100` |
|
||
|
|
|
||
|
|
??? info "`traefik/tcp/services/<service_name>/weighted/services/<n>/name`"
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|---------------------------------------------------------------------|----------|
|
||
|
|
| `traefik/tcp/services/<service_name>/weighted/services/0/name` | `foobar` |
|
||
|
|
|
||
|
|
??? info "`traefik/tcp/services/<service_name>/weighted/services/<n>/weight`"
|
||
|
|
|
||
|
|
| Key (Path) | Value |
|
||
|
|
|------------------------------------------------------------------|-------|
|
||
|
|
| `traefik/tcp/services/<service_name>/weighted/services/0/weight` | `42` |
|