Kommander DocumentationKommander allows you to monitor and manage very large numbers of clusters. Use the features described in this area to connect existing clusters, or to create new clusters whose lifecycle is managed by Konvoy. You can view clusters from the Clusters tab in the navigation pane on the left. You can see the details for a cluster by selecting the View Details link at the bottom of the cluster card or the cluster name in either the card or the table view.
Types
There are several types of clusters that display in the Clusters tab. The cluster type appears in the cluster card just under the cluster name.
The type values include:
- Attached: An Attached cluster is one that was not created with Kommander. You cannot manage an Attached cluster’s lifecycle, but you can monitor it.
- Management: This is the Konvoy cluster that hosts Kommander.
Statuses
A cluster card’s status line displays both the current status and the version of Kubernetes running in the cluster.
The status list includes these values:
| Status | Description |
|---|---|
| Pending | This is the initial state when a cluster is created or connected. |
| Pending Setup | The cluster has networking restrictions that require additional setup, and is not yet connected or attached. |
| Loading Data | The cluster has been added to Kommander and we are fetching details about the cluster. This is the status before Active. |
| Active | The cluster is connected to API server. |
| Joining | The cluster is being joined to the management cluster for federation. |
| Joined | The join process is done, and waiting for the first data from the cluster to arrive. |
| Error | There has been an error connecting to the cluster or retrieving data from the cluster. |
| Join Failed | This status can appear when kubefed does not have permission to create entities in the target cluster. |
| Unjoining | Kubefed is cleaning up after itself, removing all installed resources on the target cluster. |
| Unjoined | The cluster has been disconnected from the management cluster. |
| Unjoin Failed | The Unjoin from kubefed failed or there is some other error with deleting or disconnecting. |
NOTE: These statuses only appear on Managed clusters.
Resources
The Resources graphs on a cluster card show you a cluster’s resource requests, limits, and usage. This allows a quick, visual scan of cluster health. Hover over each resource to get specific details for that specific cluster resource.
| Resource | Description |
|---|---|
| CPU Requests | The requested portion of the total allocatable CPU resource for the cluster, measured in number of cores, such 0.5 cores. |
| CPU Limits | The portion of the total allocatable CPU resource to which the cluster is limited, measured in number of cores, such as 0.5 cores. |
| CPU Usage | The amount of the allocatable CPU resource being consumed. Cannot be higher than the configured CPU limit. Measured in number of cores, such as 0.5 cores) |
| Memory Requests | The requested portion of the total allocatable memory resource for the cluster, measured in bytes, such as 64 GiB. |
| Memory Limits | The portion of the allocatable memory resource to which the cluster is limited, measured in bytes, such as 64 GiB. |
| Memory Usage | The amount of the allocatable memory resource being consumed. Cannot be higher than the configured memory limit. Measured in bytes, such as 64 GiB. |
| Disk Requests | The requested portion of the allocatable ephemeral storage resource for the cluster, measured in bytes, such as 64 GiB. |
| Disk Limits | The portion of the allocatable ephemeral storage resource to which the cluster is limited, measured in bytes, such as 64 GiB. |
For more detailed information, see the Kubernetes documentation about resources.
Edit a cluster
Edit an attached cluster
For an attached cluster, you can only edit labels assigned to that cluster.
Attach Cluster using tunnel
Using the CLI to attach a Kubernetes Cluster using a Tunnel…Read More
Management Cluster
A guide to the Management Cluster…Read More
Cluster Applications
A guide for applications installed on your cluster…Read More
Attach an Existing Kubernetes Cluster
A guide for attaching an existing Kubernetes cluster using kubeconfig…Read More
Provision a Konvoy Cluster
Use the CLI to provision a Konvoy cluster…Read More