Mention the experimental Helm Chart in the installation section of documentation
This commit is contained in:
parent
407eda0ba0
commit
ba49012447
1 changed files with 65 additions and 0 deletions
|
@ -3,6 +3,7 @@
|
||||||
You can install Traefik with the following flavors:
|
You can install Traefik with the following flavors:
|
||||||
|
|
||||||
* [Use the official Docker image](./#use-the-official-docker-image)
|
* [Use the official Docker image](./#use-the-official-docker-image)
|
||||||
|
* [(Experimental) Use the Helm Chart](./#use-the-helm-chart)
|
||||||
* [Use the binary distribution](./#use-the-binary-distribution)
|
* [Use the binary distribution](./#use-the-binary-distribution)
|
||||||
* [Compile your binary from the sources](./#compile-your-binary-from-the-sources)
|
* [Compile your binary from the sources](./#compile-your-binary-from-the-sources)
|
||||||
|
|
||||||
|
@ -24,6 +25,70 @@ For more details, go to the [Docker provider documentation](../providers/docker.
|
||||||
* Docker images are based from the [Alpine Linux Official image](https://hub.docker.com/_/alpine).
|
* Docker images are based from the [Alpine Linux Official image](https://hub.docker.com/_/alpine).
|
||||||
* All the orchestrator using docker images could fetch the official Traefik docker image.
|
* All the orchestrator using docker images could fetch the official Traefik docker image.
|
||||||
|
|
||||||
|
## Use the Helm Chart
|
||||||
|
|
||||||
|
!!! warning "Experimental Helm Chart"
|
||||||
|
|
||||||
|
Please note that the Helm Chart for Traefik v2 is still experimental.
|
||||||
|
|
||||||
|
The Traefik Stable Chart from
|
||||||
|
[Helm's default charts repository](https://github.com/helm/charts/tree/master/stable/traefik) is still using [Traefik v1.7](https://docs.traefik.io/v1.7).
|
||||||
|
|
||||||
|
Traefik can be installed in Kubernetes using the v2.0 Helm chart from <https://github.com/containous/traefik-helm-chart>.
|
||||||
|
|
||||||
|
Ensure that the following requirements are met:
|
||||||
|
|
||||||
|
* Kubernetes 1.14+
|
||||||
|
* Helm version 2.x is [installed](https://v2.helm.sh/docs/using_helm/) and initialized with Tiller
|
||||||
|
|
||||||
|
Retrieve the latest chart version from the repository:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Retrieve Chart from the repository
|
||||||
|
git clone https://github.com/containous/traefik-helm-chart
|
||||||
|
```
|
||||||
|
|
||||||
|
And install it with the `helm` command line:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
helm install ./traefik-helm-chart
|
||||||
|
```
|
||||||
|
|
||||||
|
!!! tip "Helm Features"
|
||||||
|
|
||||||
|
All [Helm features](https://v2.helm.sh/docs/using_helm/#using-helm) are supported.
|
||||||
|
For instance, installing the chart in a dedicated namespace:
|
||||||
|
|
||||||
|
```bash tab="Install in a Dedicated Namespace"
|
||||||
|
# Install in the namespace "traefik-v2"
|
||||||
|
helm install --namespace=traefik-v2 \
|
||||||
|
./traefik-helm-chart
|
||||||
|
```
|
||||||
|
|
||||||
|
??? example "Installing with Custom Values"
|
||||||
|
|
||||||
|
You can customize the installation by specifying custom values,
|
||||||
|
as with [any helm chart](https://v2.helm.sh/docs/using_helm/#customizing-the-chart-before-installing).
|
||||||
|
{: #helm-custom-values }
|
||||||
|
|
||||||
|
The values are not (yet) documented, but are self-explanatory:
|
||||||
|
you can look at the [default `values.yaml`](https://github.com/containous/traefik-helm-chart/blob/master/values.yaml) file to explore possibilities.
|
||||||
|
|
||||||
|
Example of installation with logging set to `DEBUG`:
|
||||||
|
|
||||||
|
```bash tab="Using Helm CLI"
|
||||||
|
helm install --namespace=traefik-v2 \
|
||||||
|
--set="logs.loglevel=DEBUG" \
|
||||||
|
./traefik-helm-chart
|
||||||
|
```
|
||||||
|
|
||||||
|
```yml tab="With a custom values file"
|
||||||
|
# File custom-values.yml
|
||||||
|
## Install with "helm install --values=./custom-values.yml ./traefik-helm-chart
|
||||||
|
logs:
|
||||||
|
loglevel: DEBUG
|
||||||
|
```
|
||||||
|
|
||||||
## Use the Binary Distribution
|
## Use the Binary Distribution
|
||||||
|
|
||||||
Grab the latest binary from the [releases](https://github.com/containous/traefik/releases) page.
|
Grab the latest binary from the [releases](https://github.com/containous/traefik/releases) page.
|
||||||
|
|
Loading…
Reference in a new issue