baalajimaestro/traefik
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
traefik/docs/configuration/backends/kubernetes.md

362 lines
26 KiB
Markdown
Raw Normal View History

Update docs to reflect Provider wording
2018-05-16 17:48:03 +00:00
# Kubernetes Ingress Provider
Refactor doc pages
2017-08-25 19:32:33 +00:00
Update docs to reflect Provider wording
2018-05-16 17:48:03 +00:00
Træfik can be configured to use Kubernetes Ingress as a provider.
Enhance documentation readability.
2017-09-11 17:10:04 +00:00
Kubernetes security header annotations
2017-11-28 12:36:03 +00:00
See also [Kubernetes user guide](/user-guide/kubernetes).
Enhance documentation readability.
2017-09-11 17:10:04 +00:00
## Configuration
Refactor doc pages
2017-08-25 19:32:33 +00:00
```toml
################################################################
Update docs to reflect Provider wording
2018-05-16 17:48:03 +00:00
# Kubernetes Ingress Provider
Refactor doc pages
2017-08-25 19:32:33 +00:00
################################################################
Enhance documentation readability.
2017-09-11 17:10:04 +00:00
Update docs to reflect Provider wording
2018-05-16 17:48:03 +00:00
# Enable Kubernetes Ingress Provider.
Refactor doc pages
2017-08-25 19:32:33 +00:00
[kubernetes]
Enhance documentation readability.
2017-09-11 17:10:04 +00:00
# Kubernetes server endpoint.
Refactor doc pages
2017-08-25 19:32:33 +00:00
#
Enhance documentation readability.
2017-09-11 17:10:04 +00:00
# Optional for in-cluster configuration, required otherwise.
Refactor doc pages
2017-08-25 19:32:33 +00:00
# Default: empty
#
# endpoint = "http://localhost:8080"
# Bearer token used for the Kubernetes client configuration.
#
# Optional
# Default: empty
#
# token = "my token"
Enhance documentation readability.
2017-09-11 17:10:04 +00:00
# Path to the certificate authority file.
# Used for the Kubernetes client configuration.
Refactor doc pages
2017-08-25 19:32:33 +00:00
#
# Optional
# Default: empty
#
# certAuthFilePath = "/my/ca.crt"
# Array of namespaces to watch.
#
# Optional
# Default: all namespaces (empty array).
#
# namespaces = ["default", "production"]
Apply various contentual and stylish improvements to the k8s docs.
2018-01-15 08:40:05 +00:00
# Ingress label selector to filter Ingress objects that should be processed.
Refactor doc pages
2017-08-25 19:32:33 +00:00
#
# Optional
# Default: empty (process all Ingresses)
#
# labelselector = "A and not B"
Enhance documentation readability.
2017-09-11 17:10:04 +00:00
Allow custom value for kubernetes.io/ingress.class annotation
2018-02-01 18:04:04 +00:00
# Value of `kubernetes.io/ingress.class` annotation that identifies Ingress objects to be processed.
# If the parameter is non-empty, only Ingresses containing an annotation with the same value are processed.
# Otherwise, Ingresses missing the annotation, having an empty value, or the value `traefik` are processed.
#
# Optional
# Default: empty
#
# ingressClass = "traefik-internal"
Enhance documentation readability.
2017-09-11 17:10:04 +00:00
# Disable PassHost Headers.
#
# Optional
# Default: false
#
# disablePassHostHeaders = true
Add labels for `traefik.frontend.entryPoints` & `PassTLSCert` to Kubernetes
2017-11-20 01:12:03 +00:00
# Enable PassTLSCert Headers.
#
# Optional
# Default: false
#
# enablePassTLSCert = true
Document filename parameter for Kubernetes.
2017-11-26 00:02:03 +00:00
# Override default configuration template.
#
# Optional
# Default: <built-in template>
#
# filename = "kubernetes.tmpl"
Enable Ingress Status updates
2018-05-18 12:12:03 +00:00
# Enable IngressEndpoint configuration.
# This will allow Traefik to update the status section of ingress objects, if desired.
#
# Optional
#
# [kubernetes.ingressEndpoint]
#
# At least one must be configured.
# `publishedservice` will override the `hostname` and `ip` settings if configured.
#
# hostname = "localhost"
# ip = "127.0.0.1"
# publishedService = "namespace/servicename"
Refactor doc pages
2017-08-25 19:32:33 +00:00
```
Enhance documentation readability.
2017-09-11 17:10:04 +00:00
### `endpoint`
Apply various contentual and stylish improvements to the k8s docs.
2018-01-15 08:40:05 +00:00
The Kubernetes server endpoint as URL.
Enhance documentation readability.
2017-09-11 17:10:04 +00:00
Apply various contentual and stylish improvements to the k8s docs.
2018-01-15 08:40:05 +00:00
When deployed into Kubernetes, Traefik will read the environment variables `KUBERNETES_SERVICE_HOST` and `KUBERNETES_SERVICE_PORT` to construct the endpoint.
Enhance documentation readability.
2017-09-11 17:10:04 +00:00
Apply various contentual and stylish improvements to the k8s docs.
2018-01-15 08:40:05 +00:00
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 provided mounted automatically when deployed inside Kubernetes.
Enhance documentation readability.
2017-09-11 17:10:04 +00:00
Apply various contentual and stylish improvements to the k8s docs.
2018-01-15 08:40:05 +00:00
The endpoint may be specified to override the environment variable values inside a cluster.
Enhance documentation readability.
2017-09-11 17:10:04 +00:00
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.
Update kubernetes.md
2018-08-03 08:00:03 +00:00
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.
Enhance documentation readability.
2017-09-11 17:10:04 +00:00
### `labelselector`
Apply various contentual and stylish improvements to the k8s docs.
2018-01-15 08:40:05 +00:00
By default, Traefik processes all Ingress objects in the configured namespaces.
A label selector can be defined to filter on specific Ingress objects only.
Enhance documentation readability.
2017-09-11 17:10:04 +00:00
See [label-selectors](https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors) for details.
Enable Ingress Status updates
2018-05-18 12:12:03 +00:00
### `ingressEndpoint`
You can configure a static hostname or IP address that Traefik will add to the status section of Ingress objects that it manages.
If you prefer, you can provide a service, which traefik will copy the status spec from.
This will give more flexibility in cloud/dynamic environments.
Merge v1.5.4 into master
2018-03-15 21:22:03 +00:00
### TLS communication between Traefik and backend pods
Traefik automatically requests endpoint information based on the service provided in the ingress spec.
Although traefik will connect directly to the endpoints (pods), it still checks the service port to see if TLS communication is required.
Update kubernetes docs to reflect https options
2018-08-23 06:52:02 +00:00
There are 2 ways to configure Traefik to use https to communicate with backend pods:
1. If the service port defined in the ingress spec is 443 (note that you can still use `targetPort` to use a different port on your pod).
2. If the service port defined in the ingress spec has a name that starts with `https` (such as `https-api`, `https-web` or just `https`).
If either of those configuration options exist, then the backend communication protocol is assumed to be TLS, and will connect via TLS automatically.
Merge v1.5.4 into master
2018-03-15 21:22:03 +00:00
!!! note
Add Documentation update for Kubernetes Ingress
2018-05-11 10:52:03 +00:00
Please note that by enabling TLS communication between traefik and your pods, you will have to have trusted certificates that have the proper trust chain and IP subject name.
Merge v1.5.4 into master
2018-03-15 21:22:03 +00:00
If this is not an option, you may need to skip TLS certificate verification.
Normalize parameter names in configs
2018-04-06 07:38:03 +00:00
See the [insecureSkipVerify](/configuration/commons/#main-section) setting for more details.
Merge branch 'v1.5' into master
2018-03-21 21:43:15 +00:00
Enhance documentation readability.
2017-09-11 17:10:04 +00:00
## Annotations
Apply various contentual and stylish improvements to the k8s docs.
2018-01-15 08:40:05 +00:00
### General annotations
The following general annotations are applicable on the Ingress object:
Refactor doc pages
2017-08-25 19:32:33 +00:00
Move buffering annotation documentation to service
2018-10-09 16:44:03 +00:00
| Annotation | Description |
|---------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `traefik.ingress.kubernetes.io/error-pages: <YML>` | (1) See [custom error pages](/configuration/commons/#custom-error-pages) section. |
| `traefik.ingress.kubernetes.io/frontend-entry-points: http,https` | Override the default frontend endpoints. |
| `traefik.ingress.kubernetes.io/pass-tls-cert: "true"` | Override the default frontend PassTLSCert value. Default: `false`. |
| `traefik.ingress.kubernetes.io/preserve-host: "true"` | Forward client `Host` header to the backend. |
| `traefik.ingress.kubernetes.io/priority: "3"` | Override the default frontend rule priority. |
| `traefik.ingress.kubernetes.io/rate-limit: <YML>` | (2) See [rate limiting](/configuration/commons/#rate-limiting) section. |
| `traefik.ingress.kubernetes.io/redirect-entry-point: https` | Enables Redirect to another entryPoint for that frontend (e.g. HTTPS). |
| `traefik.ingress.kubernetes.io/redirect-permanent: "true"` | Return 301 instead of 302. |
| `traefik.ingress.kubernetes.io/redirect-regex: ^http://localhost/(.*)` | Redirect to another URL for that frontend. Must be set with `traefik.ingress.kubernetes.io/redirect-replacement`. |
| `traefik.ingress.kubernetes.io/redirect-replacement: http://mydomain/$1` | Redirect to another URL for that frontend. Must be set with `traefik.ingress.kubernetes.io/redirect-regex`. |
| `traefik.ingress.kubernetes.io/rewrite-target: /users` | Replaces each matched Ingress path with the specified one, and adds the old path to the `X-Replaced-Path` header. |
| `traefik.ingress.kubernetes.io/rule-type: PathPrefixStrip` | Overrides the default frontend rule type. Only path-related matchers can be specified [(`Path`, `PathPrefix`, `PathStrip`, `PathPrefixStrip`)](/basics/#path-matcher-usage-guidelines). |
| `traefik.ingress.kubernetes.io/request-modifier: AddPrefix: /users` | Adds a [request modifier](/basics/#modifiers) to the backend request. |
| `traefik.ingress.kubernetes.io/whitelist-source-range: "1.2.3.0/24, fe80::/16"` | A comma-separated list of IP ranges permitted for access (6). |
| `ingress.kubernetes.io/whitelist-x-forwarded-for: "true"` | Use `X-Forwarded-For` header as valid source of IP for the white list. |
| `traefik.ingress.kubernetes.io/app-root: "/index.html"` | Redirects all requests for `/` to the defined path. (4) |
Add possibility to set a protocol
2018-07-31 15:12:03 +00:00
| `traefik.ingress.kubernetes.io/service-weights: <YML>` | Set ingress backend weights specified as percentage or decimal numbers in YAML. (5)
| `ingress.kubernetes.io/protocol: <NAME>` | Set the protocol Traefik will use to communicate with pods.
Specify backend servers' weight via annotation for kubernetes
2018-07-01 09:26:03 +00:00
doc(k8s): add documentation.
2018-01-26 12:34:14 +00:00
<1> `traefik.ingress.kubernetes.io/error-pages` example:
```yaml
foo:
status:
- "404"
backend: bar
query: /bar
fii:
status:
- "503"
- "500"
backend: bar
query: /bir
```
<2> `traefik.ingress.kubernetes.io/rate-limit` example:
```yaml
extractorfunc: client.ip
rateset:
bar:
period: 3s
average: 6
burst: 9
foo:
period: 6s
average: 12
burst: 18
```
Move buffering annotation documentation to service
2018-10-09 16:44:03 +00:00
<3> `traefik.ingress.kubernetes.io/rule-type`
Note: `ReplacePath` is deprecated in this annotation, use the `traefik.ingress.kubernetes.io/request-modifier` annotation instead. Default: `PathPrefix`.
Refactor doc pages
2017-08-25 19:32:33 +00:00
Missing annotation prefix support.
2018-02-23 17:36:03 +00:00
<4> `traefik.ingress.kubernetes.io/app-root`:
Non-root paths will not be affected by this annotation and handled normally.
Correct App-Root kubernetes behavior
2018-07-12 13:20:04 +00:00
This annotation may not be combined with other redirect annotations.
Trying to do so will result in the other redirects being ignored.
This annotation can be used in combination with `traefik.ingress.kubernetes.io/redirect-permanent` to configure whether the `app-root` redirect is a 301 or a 302.
Missing annotation prefix support.
2018-02-23 17:36:03 +00:00
Specify backend servers' weight via annotation for kubernetes
2018-07-01 09:26:03 +00:00
<5> `traefik.ingress.kubernetes.io/service-weights`:
Service weights enable to split traffic across multiple backing services in a fine-grained manner.
Example:
```yaml
service_backend1: 12.50%
service_backend2: 12.50%
service_backend3: 75 # Same as 75%, the percentage sign is optional
```
A single service backend definition may be omitted; in this case, Traefik auto-completes that service backend to 100% automatically.
Conveniently, users need not bother to compute the percentage remainder for a main service backend.
For instance, in the example above `service_backend3` does not need to be specified to be assigned 75%.
!!! note
For each service weight given, the Ingress specification must include a backend item with the corresponding `serviceName` and (if given) matching path.
Currently, 3 decimal places for the weight are supported.
An attempt to exceed the precision should be avoided as it may lead to percentage computation flaws and, in consequence, Ingress parsing errors.
For each path definition, this annotation will fail if:
- the sum of backend weights exceeds 100% or
- the sum of backend weights is less than 100% without one or more omitted backends
Add a k8s guide section on traffic splitting via service weights.
2018-07-03 14:50:06 +00:00
See also the [user guide section traffic splitting](/user-guide/kubernetes/#traffic-splitting).
Specify backend servers' weight via annotation for kubernetes
2018-07-01 09:26:03 +00:00
<6> `traefik.ingress.kubernetes.io/whitelist-source-range`:
All source IPs are permitted if the list is empty or a single range is ill-formatted.
Please note, you may have to set `service.spec.externalTrafficPolicy` to the value `Local` to preserve the source IP of the request for filtering.
Please see [this link](https://kubernetes.io/docs/tutorials/services/source-ip/) for more information.
Support regex redirect by frontend
2017-12-15 10:48:03 +00:00
!!! note
doc(k8s): add documentation.
2018-01-26 12:34:14 +00:00
Please note that `traefik.ingress.kubernetes.io/redirect-regex` and `traefik.ingress.kubernetes.io/redirect-replacement` do not have to be set if `traefik.ingress.kubernetes.io/redirect-entry-point` is defined for the redirection (they will not be used in this case).
Support regex redirect by frontend
2017-12-15 10:48:03 +00:00
Apply various contentual and stylish improvements to the k8s docs.
2018-01-15 08:40:05 +00:00
The following annotations are applicable on the Service object associated with a particular Ingress object:
Support regex redirect by frontend
2017-12-15 10:48:03 +00:00
doc(k8s): add documentation.
2018-01-26 12:34:14 +00:00
| Annotation | Description |
|--------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
Move buffering annotation documentation to service
2018-10-09 16:44:03 +00:00
| `traefik.ingress.kubernetes.io/buffering: <YML>` | (1) See the [buffering](/configuration/commons/#buffering) section. |
Change boolean annotation values to string
2018-02-16 11:20:04 +00:00
| `traefik.backend.loadbalancer.sticky: "true"` | Enable backend sticky sessions (DEPRECATED). |
| `traefik.ingress.kubernetes.io/affinity: "true"` | Enable backend sticky sessions. |
doc(k8s): add documentation.
2018-01-26 12:34:14 +00:00
| `traefik.ingress.kubernetes.io/circuit-breaker-expression: <expression>` | Set the circuit breaker expression for the backend. |
| `traefik.ingress.kubernetes.io/load-balancer-method: drr` | Override the default `wrr` load balancer algorithm. |
Move buffering annotation documentation to service
2018-10-09 16:44:03 +00:00
| `traefik.ingress.kubernetes.io/max-conn-amount: "10"` | Sets the maximum number of simultaneous connections to the backend.<br>Must be used in conjunction with the label below to take effect. |
doc(k8s): add documentation.
2018-01-26 12:34:14 +00:00
| `traefik.ingress.kubernetes.io/max-conn-extractor-func: client.ip` | Set the function to be used against the request to determine what to limit maximum connections to the backend by.<br>Must be used in conjunction with the above label to take effect. |
| `traefik.ingress.kubernetes.io/session-cookie-name: <NAME>` | Manually set the cookie name for sticky sessions. |
Move buffering annotation documentation to service
2018-10-09 16:44:03 +00:00
<1> `traefik.ingress.kubernetes.io/buffering` example:
```yaml
maxrequestbodybytes: 10485760
memrequestbodybytes: 2097153
maxresponsebodybytes: 10485761
memresponsebodybytes: 2097152
retryexpression: IsNetworkError() && Attempts() <= 2
```
doc(k8s): add documentation.
2018-01-26 12:34:14 +00:00
!!! note
`traefik.ingress.kubernetes.io/` and `ingress.kubernetes.io/` are supported prefixes.
Refactor doc pages
2017-08-25 19:32:33 +00:00
Split security labels and custom labels documentation.
2018-02-16 15:04:05 +00:00
### Custom Headers Annotations
| Annotation | Description |
| ------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `ingress.kubernetes.io/custom-request-headers: EXPR` | Provides the container with custom request headers that will be appended to each request forwarded to the container. Format: <code>HEADER:value&vert;&vert;HEADER2:value2</code> |
| `ingress.kubernetes.io/custom-response-headers: EXPR` | Appends the headers to each response returned by the container, before forwarding the response to the client. Format: <code>HEADER:value&vert;&vert;HEADER2:value2</code> |
### Security Headers Annotations
Kubernetes security header annotations
2017-11-28 12:36:03 +00:00
Apply various contentual and stylish improvements to the k8s docs.
2018-01-15 08:40:05 +00:00
The following security annotations are applicable on the Ingress object:
Kubernetes security header annotations
2017-11-28 12:36:03 +00:00
Split security labels and custom labels documentation.
2018-02-16 15:04:05 +00:00
| Annotation | Description |
| ----------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
Change boolean annotation values to string
2018-02-16 11:20:04 +00:00
| `ingress.kubernetes.io/allowed-hosts: EXPR` | Provides a list of allowed hosts that requests will be processed. Format: `Host1,Host2` |
Cleaning labels/annotations documentation.
2018-04-30 10:08:03 +00:00
| `ingress.kubernetes.io/browser-xss-filter: "true"` | Adds the X-XSS-Protection header with the value `1; mode=block`. |
| `ingress.kubernetes.io/content-security-policy: VALUE` | Adds CSP Header with the custom value. |
| `ingress.kubernetes.io/content-type-nosniff: "true"` | Adds the `X-Content-Type-Options` header with the value `nosniff`. |
| `ingress.kubernetes.io/custom-browser-xss-value: VALUE` | Set custom value for X-XSS-Protection header. This overrides the BrowserXssFilter option. |
| `ingress.kubernetes.io/custom-frame-options-value: VALUE` | Overrides the `X-Frame-Options` header with the custom value. |
| `ingress.kubernetes.io/force-hsts: "false"` | Adds the STS header to non-SSL requests. |
| `ingress.kubernetes.io/frame-deny: "false"` | Adds the `X-Frame-Options` header with the value of `DENY`. |
Change boolean annotation values to string
2018-02-16 11:20:04 +00:00
| `ingress.kubernetes.io/hsts-max-age: "315360000"` | Sets the max-age of the HSTS header. |
| `ingress.kubernetes.io/hsts-include-subdomains: "true"` | Adds the IncludeSubdomains section of the STS header. |
| `ingress.kubernetes.io/hsts-preload: "true"` | Adds the preload flag to the HSTS header. |
Cleaning labels/annotations documentation.
2018-04-30 10:08:03 +00:00
| `ingress.kubernetes.io/is-development: "false"` | This will cause the `AllowedHosts`, `SSLRedirect`, and `STSSeconds`/`STSIncludeSubdomains` options to be ignored during development.<br>When deploying to production, be sure to set this to false. |
| `ingress.kubernetes.io/proxy-headers: EXPR` | Provides a list of headers that the proxied hostname may be stored. Format: `HEADER1,HEADER2` |
Change boolean annotation values to string
2018-02-16 11:20:04 +00:00
| `ingress.kubernetes.io/public-key: VALUE` | Adds pinned HTST public key header. |
| `ingress.kubernetes.io/referrer-policy: VALUE` | Adds referrer policy header. |
Cleaning labels/annotations documentation.
2018-04-30 10:08:03 +00:00
| `ingress.kubernetes.io/ssl-redirect: "true"` | Forces the frontend to redirect to SSL if a non-SSL request is sent. |
| `ingress.kubernetes.io/ssl-temporary-redirect: "true"` | Forces the frontend to redirect to SSL if a non-SSL request is sent, but by sending a 302 instead of a 301. |
| `ingress.kubernetes.io/ssl-host: HOST` | This setting configures the hostname that redirects will be based on. Default is "", which is the same host as the request. |
Add SSLForceHost support.
2018-05-14 09:44:03 +00:00
| `ingress.kubernetes.io/ssl-force-host: "true"` | If `SSLForceHost` is `true` and `SSLHost` is set, requests will be forced to use `SSLHost` even the ones that are already using SSL. Default is false. |
Cleaning labels/annotations documentation.
2018-04-30 10:08:03 +00:00
| `ingress.kubernetes.io/ssl-proxy-headers: EXPR` | Header combinations that would signify a proper SSL Request (Such as `X-Forwarded-For:https`). Format: <code>HEADER:value&vert;&vert;HEADER2:value2</code> |
Refactor doc pages
2017-08-25 19:32:33 +00:00
### Authentication
Add documentation about Templating in backend file
2018-04-24 16:58:03 +00:00
Additional authentication annotations can be added to the Ingress object.
Apply various contentual and stylish improvements to the k8s docs.
2018-01-15 08:40:05 +00:00
The source of the authentication is a Secret object that contains the credentials.
Refactor doc pages
2017-08-25 19:32:33 +00:00
Auth support in frontends for k8s and file
2018-07-02 09:52:04 +00:00
| Annotation | basic | digest | forward | Description |
|----------------------------------------------------------------------|-------|--------|---------|-------------------------------------------------------------------------------------------------------------|
| `ingress.kubernetes.io/auth-type: basic` | x | x | x | Contains the authentication type: `basic`, `digest`, `forward`. |
| `ingress.kubernetes.io/auth-secret: mysecret` | x | x | | Name of Secret containing the username and password with access to the paths defined in the Ingress object. |
Don't pass the Authorization header to the backends
2018-07-16 11:52:03 +00:00
| `ingress.kubernetes.io/auth-remove-header: true` | x | x | | If set to `true` removes the `Authorization` header. |
Auth support in frontends for k8s and file
2018-07-02 09:52:04 +00:00
| `ingress.kubernetes.io/auth-header-field: X-WebAuth-User` | x | x | | Pass Authenticated user to application via headers. |
Auth support in frontends
2018-07-06 14:52:04 +00:00
| `ingress.kubernetes.io/auth-url: https://example.com` | | | x | [The URL of the authentication server](/configuration/entrypoints/#forward-authentication). |
Auth support in frontends for k8s and file
2018-07-02 09:52:04 +00:00
| `ingress.kubernetes.io/auth-trust-headers: false` | | | x | Trust `X-Forwarded-*` headers. |
| `ingress.kubernetes.io/auth-response-headers: X-Auth-User, X-Secret` | | | x | Copy headers from the authentication server to the request. |
| `ingress.kubernetes.io/auth-tls-secret: secret` | | | x | Name of Secret containing the certificate and key for the forward auth. |
| `ingress.kubernetes.io/auth-tls-insecure` | | | x | If set to `true` invalid SSL certificates are accepted. |
Refactor doc pages
2017-08-25 19:32:33 +00:00
Apply various contentual and stylish improvements to the k8s docs.
2018-01-15 08:40:05 +00:00
The secret must be created in the same namespace as the Ingress object.
Refactor doc pages
2017-08-25 19:32:33 +00:00
Auth support in frontends for k8s and file
2018-07-02 09:52:04 +00:00
The following limitations hold for basic/digest auth:
Refactor doc pages
2017-08-25 19:32:33 +00:00
Apply various contentual and stylish improvements to the k8s docs.
2018-01-15 08:40:05 +00:00
- The realm is not configurable; the only supported (and default) value is `traefik`.
- The Secret must contain a single file only.
Add documentation about Templating in backend file
2018-04-24 16:58:03 +00:00
### TLS certificates management
TLS certificates can be managed in Secrets objects.
More information are available in the [User Guide](/user-guide/kubernetes/#add-a-tls-certificate-to-the-ingress).
!!! note
Only TLS certificates provided by users can be stored in Kubernetes Secrets.
Add Documentation update for Kubernetes Ingress
2018-05-11 10:52:03 +00:00
[Let's Encrypt](https://letsencrypt.org) certificates cannot be managed in Kubernets Secrets yet.
Create Global Backend Ingress
2018-07-03 16:58:03 +00:00
### Global Default Backend Ingresses
Ingresses can be created that look like the following:
```yaml
apiVersion: extensions/v1beta1
kind: Ingress
metadata:
name: cheese
spec:
backend:
serviceName: stilton
servicePort: 80
```
This ingress follows the [Global Default Backend](https://kubernetes.io/docs/concepts/services-networking/ingress/#the-ingress-resource) property of ingresses.
This will allow users to create a "default backend" that will match all unmatched requests.
!!! note
Due to Træfik's use of priorities, you may have to set this ingress priority lower than other ingresses in your environment, to avoid this global ingress from satisfying requests that _could_ match other ingresses.
To do this, use the `traefik.ingress.kubernetes.io/priority` annotation (as seen in [General Annotations](/configuration/backends/kubernetes/#general-annotations)) on your ingresses accordingly.
Reference in a new issue Copy permalink