Attach an Existing Kubernetes Cluster

A guide for attaching an existing Kubernetes cluster using kubeconfig

Using Kommander with an existing Kubernetes cluster

You can attach an existing Kubernetes cluster directly to Kommander. During the attachment process, certain namespaces are created on the cluster, and workspace platform services are deployed automatically into the newly-created namespaces. Review the workspace platform service resource requirements to ensure the attached cluster has sufficient resources before you begin. For more information on platform services and customizing them, see workspace platform services.

If the cluster you want to attach was created using Amazon EKS, Azure AKS, or Google GKE, you will need to create a service account as part of generating a kubeconfig file. If you are attaching an Amazon EKS cluster to Kommander, use these detailed instructions.

Before you begin

You must have a kubeconfig file to attach a cluster. The kubeconfig file contains a YAML manifest that provides the required context and authentication tokens to allow Kommander to manage an existing cluster.

If you already have a kubeconfig file, skip this procedure and go to the next section, Attaching a Cluster.

If you do not want to add the cluster to the Default Workspace, create a new Workspace before proceeding.

Attaching a Cluster

Using the Add Cluster option, you can attach an existing Kubernetes or Konvoy cluster directly to Kommander. Attaching a cluster allows you to access the multi-cluster management and monitoring benefits that Kommander provides, while keeping your existing cluster on its current provider and infrastructure.

You have these security options when attaching a cluster: