Skip to content

One-Line Installation of Traefik Enterprise Edition on Kubernetes

This page guides you through the installation of TraefikEE (Traefik Enterprise Edition) as a Kubernetes Ingress Controller.

Kubernetes Knowledge

Assistance with configuring or setting up a Kubernetes cluster are not included in this guide. If you need more information about Kubernetes, start with the following resources:

Requirements

  • The traefikeectl tool installed

  • A Kubernetes cluster:

    • Supported versions: 1.10, 1.11, 1.12 and 1.13
    • RBAC enabled (recommended),
    • Access to the Kubernetes API with kubectl, with the ability to create and manage namespaces and their resources.
  • Helm:

    • Supported versions: 2.9, 2.10, 2.11, 2.12
    • If a supported version is found, traefikeectl will use your helm binary.
    • If no helm installation is found, traefikeectl will download helm in a temporary folder.
    • If an unsupported version of helm is found, traefikeectl will not be able to work properly. You will have to upgrade/downgrade your helm installation to be able to use it.

One-Line Installation

To install TraefikEE in Kubernetes, use the same traefikeectl install command line as described in the Getting Started with Installation page, and adds the option --kubernetes:

traefikeectl install \
  --licensekey="XXXXXXXXX" \
  --dashboard \
  --kubernetes

The previous command installs TraefikEE on your Kubernetes infrastructure, with the following elements:

  • A Control Plane with 3 nodes for high availability
  • A Data Plane with 1 node per Kubernetes' node
  • An Ingress Controller of type traefik is available, for an easy integration in your existing Kubernetes applications with on Ingress Rules
  • A routing configuration watching for Kubernetes API for ingress rules

All the available installation options are listed on the traefikeectl Reference Page.

Validate Installation

Validate that the TraefikEE cluster is installed correctly:

traefikeectl list-nodes
Name                                            Role
----                                            ----
bootstrap-traefikee-bootstrap-647965c6b5-xfktd  CONTROL NODE (Current Leader)
traefikee-control-node-1                        CONTROL NODE
data-node-traefikee-data-node-68d856488c-5vx5n  DATA NODE
data-node-traefikee-data-node-68d856488c-stgns  DATA NODE
traefikee-control-node-2                        CONTROL NODE
traefikee-control-node-0                        CONTROL NODE

Your TraefikEE for Kubernetes cluster is ready.

Uninstall

The cluster can be easily uninstalled by running traefikeectl uninstall:

traefikeectl uninstall

If you would like to purge the release entirely, and free up the namespace for future use, you can use:

traefikeectl uninstall --kubernetes.deletenamespace

Important

By default, traefikeectl will use your kubeconfig file in the $KUBECONFIG environment variable or in ~/.kube/config. You can override those values using the --kubernetes.configpath argument in the command line.

More information about the uninstall options can be found on the traefikeectl Reference Page.