Skip to main content

Install Traefik Hub Gateway & API Management on Nutanix Kubernetes Platform (NKP)

Traefik Proxy is the default ingress controller for the Nutanix Kubernetes Platform. You can now upgrade your NKP cluster to use the Traefik Hub API Gateway and API Management solutions. In this guide, you’ll learn how to install these in your NKP cluster.

Prequisites​

  • Access to an NKP cluster.
  • A Traefik Hub Gateway token (TRAEFIK_HUB_TOKEN)

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: Make Sure Traefik is Deployed​

In your NKP dashboard, navigate to Management cluster > Applications and ensure that Traefik is marked as deployed. Traefik proxy is automatically deployed when you create a new NKP cluster. However, verifying that Traefik has been successfully deployed before starting the upgrade is still important.

Traefik Deployed on NKP

Step 3: Create a New Catalog Entry in your NKP Cluster​

Run the following command to create a new catalog entry in your NKP cluster:

kubectl apply -k https://github.com/traefik/nkp-traefiklabs-catalog/hub

Create a New Catalog Entry

Step 4: Create a New Kubernetes Secret​

Next, create a new kubernetes secret to store the token we created in Step 1:

TRAEFIK_HUB_TOKEN=<your-token-goes-here>
kubectl create secret generic license --namespace kommander --from-literal=token=$TRAEFIK_HUB_TOKEN

The above command will create a new secret called license and it will hold your Traefik hub gateway token.

Step 5: Enable the Traefik Hub Catalog Entry in NKP​

Next, enable the Traefik Hub catalog entry to complete the process. This step integrates Traefik Hub within your NKP cluster, providing advanced API management capabilities.

Enable Traefik Hub on NKP Dashboard

info

This step can take anywhere from 1 to 5 minutes

Step 6: Verify the Installation​

Finally, log back in to Traefik Hub Online Dashboard, and verify that your Traefik Hub API Gateway is online.

NKP Gateway Online on Traefik Hub Dashboard

Conclusion​

In this guide, we’ve successfully:

  • Deployed Traefik Hub: Upgraded the exisiting Traefik Proxy deployment to Traefik Hub API Gateway & Management.
  • Verified the Installation: Accessed the Traefik Hub dashboard to confirm our Gateway is online & running correctly.