Managing Multiple Clusters

teectl can be used to manage multiple Traefik Enterprise clusters simultaneously. When setting up a cluster with teectl setup a cluster name can be given using the --cluster option. To run commands on a named cluster, the --cluster option can be used on all applicable commands:

teectl get nodes --cluster=$CLUSTER_NAME

Cluster Management

teectl comes with additional commands to help manage multiple clusters. They are grouped under the cluster command.

use

Instead of specifying the --cluster option on each applicable teectl command, the cluster use command can be used to set the cluster context to use for all subsequent commands.

Command

teectl cluster use --name=some-cluster

Result

Cluster context has been set to "some-cluster"

In the example above all management commands will be run on a cluster named some-cluster.

get

To see available clusters configured in teectl, the cluster get command can be used. The current cluster context will be indicated with a *.

Command

teectl cluster get

Result

default
some-cluster*

import

For teectl to manage an existing cluster, the cluster configuration must first be imported using the cluster import command. This will make a copy of the given cluster configuration in the correct location.

Command

teectl cluster import --file=test.yaml

Cluster Configuration Location

By default, teectl stores its configuration files in the $HOME/.config/traefikee/ folder. Should this need to be customized, the environment variable TRAEFIKEE_HOME can be set to instruct teectl where to look for configuration files.