Documentation

Multicluster mode on Kubeapps

Kubeapps is a tool for managing applications in Kubernetes clusters. Initially it was possible to work only in a single cluster, but with the implementation of the proposal for multicluster support in Kubeapps , this is possible also in additional clusters.

As a global overview, multicluster mode is based on a default cluster (the one acting as orchestrator, with Kubeapps installed on it) and additional clusters (target clusters without Kubeapps, where apps will be installed). Actions are performed by users in the default cluster but results are applied in a chosen additional cluster.

Requirements for multiclustering

The main requirement for working in multicluster mode is that users can be authenticated with multiple clusters using the same credentials. This is usually achieved by sharing the same OIDC client, or having the OIDC provider configured so that tokens in one cluster are allowed to include the client-ids used by the other clusters. OIDC setup can be done directly in K8s API server (with --oidc* flags) or using an OIDC provider with Pinniped .

For more information on requirements and how to get Kubeapps working in multicluster mode, read the how-to Configuring Kubeapps for multiple clusters .

Features

Kubeapps offers many features, but not all are available in the multicluster mode. In the following table there is the breakdown of features for single and additional clusters.

Feature groupKubeapps runtime featureDefault clusterAdditional clustersComments
GlobalList namespacesYesYes
Create namespaceYesYes
Change contextYesYes
RepositoriesList package repositoriesYesNo
Add/Update/Delete package repository - GlobalYesNoSource of truth for package repositories is the default cluster
Add/Update/Delete package repository - NamespacedYesNoSource of truth for package repositories is the default cluster
ClustersAdd/Update/Delete clusterNoNoClusters can only be defined at deployment time through input values
PackagesHELM - List available packages from global public repositoryYesYes
HELM - List available packages from namespaced public repositoryYesNo
HELM - List available packages from global private repositoryYesYes
HELM - List available packages from namespaced private repositoryYesNo
CARVEL - List available packages from global repositoryYesNo** It could be done if kubeconfig provided to Kapp
CARVEL - List available packages from namespaced repositoryYesNo** It could be done if kubeconfig provided to Kapp
FLUX - List available packagesYesNo** Throws error message not supported yet: request.Context.Cluster: \[%v\]
HELM - List installed packages in namespaceYesYes
CARVEL - List installed packages in namespaceYesNo** It could be done if kubeconfig provided to Kapp
FLUX - List installed packages in namespaceYesNo** Throws error message not supported yet: request.Context.Cluster: \[%v\]
HELM - Get installed package detailsYesYes
CARVEL - Get installed package detailsYesNo** It could be done if kubeconfig provided to Kapp
FLUX - Get installed package detailsYesNo
HELM - Package management (install, delete, etc.) without imagePullSecretsYesYesIn additional clusters, only possible from Global repositories
HELM - Package management (install, delete, etc.) with imagePullSecretsYesNo
CARVEL - Package management (install, delete, etc.)YesNo** Throws error message installing packages in other clusters in not supported yet
FLUX - Package management (install, delete, etc.)YesNo** Throws error message not supported yet: request.AvailablePackageRef.Context.Cluster: \[%v\]

Limitations

As it can be seen in the table of features, Kubeapps can work in multicluster mode only by using Helm plugin together with global repositories. At the moment, dynamically managing additional clusters, Carvel and Flux operations, or namespaced repositories are not supported.

Getting started

Discover how to deploy Kubeapps in your cluster, add some package repositories and start managing your applications!