baalajimaestro/traefik
1
0
Fork 0
Code Issues Pull requests Packages Projects Releases Wiki Activity

Update traefik install documentation

Browse source
This commit is contained in:
Michael 2020-03-11 18:28:05 +01:00 committed by GitHub
parent d67e06037e
commit 4280af4844
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 20 additions and 16 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

36
docs/content/getting-started/install-traefik.md
View file

@ -3,7 +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 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)
@ -27,48 +27,52 @@ For more details, go to the [Docker provider documentation](../providers/docker.
## Use the Helm Chart ## Use the Helm Chart
!!! warning "Experimental Helm Chart" !!! warning
Please note that the Helm Chart for Traefik v2 is still experimental. The Traefik Chart from
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). [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>. Traefik can be installed in Kubernetes using the Helm chart from <https://github.com/containous/traefik-helm-chart>.
Ensure that the following requirements are met: Ensure that the following requirements are met:
* Kubernetes 1.14+ * Kubernetes 1.14+
* Helm version 2.x is [installed](https://v2.helm.sh/docs/using_helm/) and initialized with Tiller * Helm version 3.x is [installed](https://helm.sh/docs/intro/install/)
Retrieve the latest chart version from the repository: Add Traefik's chart repository to Helm:
```bash ```bash
# Retrieve Chart from the repository helm repo add traefik https://containous.github.io/traefik-helm-chart
git clone https://github.com/containous/traefik-helm-chart ```
You can update the chart repository by running:
```bash
helm repo update
``` ```
And install it with the `helm` command line: And install it with the `helm` command line:
```bash ```bash
helm install ./traefik-helm-chart helm install traefik traefik/traefik
``` ```
!!! tip "Helm Features" !!! tip "Helm Features"
All [Helm features](https://v2.helm.sh/docs/using_helm/#using-helm) are supported. All [Helm features](https://helm.sh/docs/intro/using_helm/) are supported.
For instance, installing the chart in a dedicated namespace: For instance, installing the chart in a dedicated namespace:
```bash tab="Install in a Dedicated Namespace" ```bash tab="Install in a Dedicated Namespace"
kubectl create ns traefik-v2
# Install in the namespace "traefik-v2" # Install in the namespace "traefik-v2"
helm install --namespace=traefik-v2 \ helm install --namespace=traefik-v2 \
./traefik-helm-chart traefik traefik/traefik
``` ```
??? example "Installing with Custom Values" ??? example "Installing with Custom Values"
You can customize the installation by specifying 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). as with [any helm chart](https://helm.sh/docs/intro/using_helm/#customizing-the-chart-before-installing).
{: #helm-custom-values } {: #helm-custom-values }
The values are not (yet) documented, but are self-explanatory: The values are not (yet) documented, but are self-explanatory:
@ -79,12 +83,12 @@ helm install ./traefik-helm-chart
```bash tab="Using Helm CLI" ```bash tab="Using Helm CLI"
helm install --namespace=traefik-v2 \ helm install --namespace=traefik-v2 \
--set="logs.loglevel=DEBUG" \ --set="logs.loglevel=DEBUG" \
./traefik-helm-chart traefik traefik/traefik
``` ```
```yml tab="With a custom values file" ```yml tab="With a custom values file"
# File custom-values.yml # File custom-values.yml
## Install with "helm install --values=./custom-values.yml ./traefik-helm-chart ## Install with "helm install --values=./custom-values.yml traefik traefik/traefik
logs: logs:
loglevel: DEBUG loglevel: DEBUG
``` ```