Workspace Platform Services

How workspace platform services work

When attaching a cluster, Kommander federates certain platform services on the newly attached cluster. Operators can use the Kommander UI to customize which platform services to deploy to the attached clusters in a given workspace.

On attachment, three factors impact successfully deploying a platform service on the attached cluster:

  1. Is the attached cluster a Konvoy cluster or not? For example, a cluster deployed using AWS EKS.
  2. Is the platform service enabled in the Workspace Platform Services settings?
  3. Does the platform service support the version of Kubernetes running on the cluster?

The following tables describe the list of platform services that are federated on attachment, along with the versions of Kubernetes that they support. If the cluster is running a version of Kubernetes that is not in the supported list, the platform service is not federated to that cluster. If the platform service description indicates only federated on non-Konvoy clusters, the platform service is not installed into Konvoy clusters, since it is by default installed with Konvoy using Kubernetes Base Addons.

Currently, the monitoring stack is federated by default and the logging stack is not.

Review the workspace platform service resource requirements to ensure that the attached clusters have sufficient resources.

Customize a workspace’s platform services

If you have access to edit a workspace, you can customize the platform services that are federated to a workspace’s clusters using the Kommander UI. Access the settings page by going to the specific workspace’s Dashboard page, locating the Workspace card, selecting the Actions drop-down button and selecting Edit Workspace Platform Services. You can also go to the Workspace Dashboard’s Actions menu button to access the settings page.

This takes you to the settings page which provides lists of platform services that you can enable or disable along with descriptions of the services.

IMPORTANT: There may be dependencies between the platform services, which are listed here. Review them carefully prior to customizing to ensure that the platform services are deployed successfully.

Platform services support a specific set of Kubernetes versions running on the attached cluster. See the column Kubernetes Versions Supported in the below chart for supported Kubernetes versions per platform service. Platform services will not be deployed to clusters running Kubernetes versions outside of those listed.

If desired, the Kubeaddons Controller can also be disabled, though it is highly discouraged. All platform services require the controller in order to be installed properly. You can find the setting to turn the controller off at the bottom of the page underneath the Foundational Components header. Disabling the controller will automatically disable all platform services.

Workspace platform services

Name Federated by default Supported Kubernetes Versions Only federated on non-Konvoy clusters
cert-manager True 1.16 - 1.19 True
elasticsearch False 1.16 - 1.19 True
elasticsearch-curator False 1.16 - 1.19 True
elasticsearchexporter False 1.16 - 1.19 True
fluentbit False 1.16 - 1.19 True
kibana False 1.16 - 1.19 True
kube-oidc-proxy-kommander True 1.16 - 1.19 False
kubecost True 1.16 - 1.19 False
prometheus True 1.16 - 1.19 True
prometheusadapter True 1.16 - 1.19 True
reloader True 1.16 - 1.19 True
traefik True 1.16 - 1.19 True
traefik-forward-auth-kommander True 1.16 - 1.19 False