Skip to main content

Deploy Traefik Hub Gateway & API Management on Linode Kubernetes Engine (LKE)

Traefik Hub is built to work seamlessly on Linode Kubernetes Engine (LKE). In this guide, you'll learn how to deploy Traefik Hub API Gateway and API Management on your LKE cluster using Helm. The integration is designed to work out of the box, so you can deploy Traefik Hub in your cluster and immediately start taking advantage of advanced API gateway and management features.

Prerequisites​

Step 1: Generate the Traefik Hub Gateway Token​

First, contact the Traefik Sales Team for access, and then log in to the Traefik Hub Dashboard at https://hub.traefik.io. Next, Create a new gateway and copy its token.

Create New Gateway in Traefik Hub

Step 2: Create a New Cluster on LKE​

  • Navigate to the Linode Kubernetes Engine page in the Akamai cloud console (either from the top menu or in the Kubernetes menu)

Navigation to Kubernetes Section

  • Click on the Create Cluster button in the top right corner of the console to create a new LKE cluster.

create new cluster

Step 3: Configure the Cluster​

Next, select a region, desired node size, node count, and specific features you need.

Configure Cluster

Step 4: Download the New Cluster Kubeconfig file​

After the cluster has been created, download the cluster kubeconfig file to access the LKE cluster locally.

Download KUBECONFIG

tip

You will not be able to download the cluster kubeconfig file until all cluster resources have all been created.

Step 5: Access the Cluster Locally​

Next, in your terminal shell, save your kubeconfig file's path to the $KUBECONFIG environment variable. In the example below, the kubeconfig file is located in the Downloads folder, but you should alter this line with the folder's location on your computer that holds your cluster kubeconfig:

export KUBECONFIG=~/Downloads/gw-demo-kubeconfig.yaml
tip

Make sure to set appropriate permissions for your kubeconfig file to avoid unwanted access.

After setting your kubeconfig path, verify that you can access your cluster by running the following command:

kubectl get nodes

The output of the above command should be similar to this:

NAME                            STATUS   ROLES    AGE     VERSION
lke370867-575522-6562ca230000   Ready    <none>   2m54s   v1.32.1

Step 6: Install Traefik Hub​

Now that you have access to your LKE cluster locally, you can install Traefik Hub API Gateway & Management with Helm by following the instructions on the Traefik Hub Kubernetes installation page.

tip

You can configure your installation according to your needs by setting the appropriate Helm values

After installation, verify that your Traefik Hub deploymemt is running by running the following command:

kubectl get pods -n traefik

The output of the above command should be similar to this:

NAMESPACE     NAME                                       READY   STATUS    RESTARTS      AGE
traefik       traefik-86458b5d9b-6h9gp                   1/1     Running   0             3m42s

Step 7: Verify Your Traefik Hub Installation via the Online Dashboard​

Navigate to the Gateways page on the Traefik Hub Online Dashboard and verify your Gateway is online

Verify Installation on Traefik Hub Online Dashboard

That's it! We've successfully deployed Traefik Hub in a Linode Kubernetes Engine cluster.

Conclusion​

In this guide, we’ve successfully:

  • Deployed Traefik Hub: Created a new LKE cluster and deployed Traefik Hub API Gateway.
  • Verified the Installation: Accessed the Traefik Hub dashboard to confirm our Gateway is online & running correctly.