Getting Started

Kontena Lens is designed to work with any Kubernetes cluster that will meet the cluster requirements.

Get started with Kontena Lens by following these steps:

  1. Deploy Kontena Lens installer
  2. Login to Kontena Lens

Deploy Kontena Lens Installer

Kontena Lens is installed using kubectl. Make sure that kubectl context is pointing to a right cluster before executing following commands.

Installation starts 14-day evaluation period. You can subscribe to a license from Kontena Account. See pricing for more details.

Amazon EKS

Download the Kontena Lens installer manifest for EKS from https://lens-installer.kontena.io/latest/eks.yaml and tweak the kontena-lens-installer ConfigMap to your liking. Then apply the modified installer manifest to your cluster using kubectl:

$ kubectl apply -f ./eks.yaml

Google GKE

NOTE: Remember to add your GKE user to cluster-admin role.

Download the Kontena Lens installer manifest for GKE from https://lens-installer.kontena.io/latest/gke.yaml and tweak the kontena-lens-installer ConfigMap to your liking. Then apply the modified installer manifest to your cluster using kubectl:

$ kubectl apply -f ./gke.yaml

Kontena Pharos

NOTE: Kontena Pharos PRO users need to disable kontena-lens and kontena-stats addons before install.

Download the Kontena Lens installer manifest for GKE from https://lens-installer.kontena.io/latest/pharos.yaml and tweak the kontena-lens-installer ConfigMap to your liking. Then apply the modified installer manifest to your cluster using kubectl:

$ kubectl apply -f ./pharos.yaml

Other / Custom

Download the Kontena Lens installer manifest from https://lens-installer.kontena.io/latest/custom.yaml and tweak the kontena-lens-installer ConfigMap to your liking. Then apply the modified installer manifest to your cluster using kubectl:

$ kubectl apply -f ./custom.yml

NOTE: You can use specific version of the installer by replacing latest in the manifest URL.

Login to Kontena Lens

Installer will create lens-admin ServiceAccount that has admin rights to the cluster. To fetch lens-admin user token, see the installer logs:

$ kubectl logs -n kube-system -l k8s-app=kontena-lens-installer

Logs should end with instructions how to access the Kontena Lens UI.

Example log output:

    Post-install message from kontena-lens:
      Kontena Lens UI is configured to respond at: https://lens.mydomain.com
      Starting up Kontena Lens the first time might take couple of minutes, until that you'll see 503 with the address given above.
    You can login to Kontena Lens as admin with a ServiceAccount token that can be fetched with the following command:
      kubectl -n kube-system get secrets lens-admin-token-bh94m -o jsonpath="{.data.token}" | base64 --decode

Next Steps

results matching ""

    No results matching ""