k10multicluster Tool

Note

Only use the k10multicluster tool if ingress access to secondary is required. For all other use-cases, please use Getting Started.

With K10 already installed in each cluster, a simple bootstrapping process enables the K10 multi-cluster manager. Through the bootstrapping process, one cluster will be setup as the primary. Additional clusters are then bootstrapped as secondaries.

The bootstrapping process is accomplished via the k10multicluster tool on a system having access to the Kubernetes clusters being bootstrapped.

Tip

To get started, just setting up a primary can be a great way to go! Secondaries can be added at any time.

Bootstrapping Clusters

The k10multicluster tool is used to setup primary cluster as a K10 Multi-Cluster Manager, and to add or remove secondary clusters. Additional information, including how to download the tool, can be found on the Bootstrapping Commands Reference page.

Note

The tool will use default values for things such as the K10 namespace, release name, and current Kubernetes context. These can be changed with additional flags.

The complete command reference can be found on the Bootstrapping Commands Reference page.

Tip

The k10multicluster tool uses Kubernetes contexts available on the local system. To see the contexts available, use the following command:

$ kubectl config get-contexts

Setup Primary

To setup the primary cluster, use the setup-primary command:

$ k10multicluster setup-primary \
    --context=<primary_cluster_context_name> \
    --name=<primary_cluster_name> \
    --ingress=<primary_cluster_ingress>/<k10_endpoint>

Note

Clusters can be given any name, but names must be unique to a cluster and be a valid Kubernetes name. Follow Kubernetes naming conventions while naming clusters.

At this point, the K10 Multi-Cluster Manager has been setup and can be accessed through the primary's K10 dashboard. See Dashboard Access for additional details.

Additional clusters may be added by following the bootstrapping directions for secondaries described below.

Bootstrap Secondary Cluster

To add a secondary cluster to the K10 Multi-Cluster Manager, use the bootstrap command.

$ k10multicluster bootstrap \
    --primary-context=<primary_cluster_context_name> \
    --primary-name=<primary_cluster_name> \
    --secondary-context=<secondary_cluster_context_name> \
    --secondary-name=<secondary_cluster_name> \
    --secondary-cluster-ingress=<secondary_cluster_ingress>/<k10_endpoint>

Note

Clusters can be given any name, but names must be unique to a cluster and be a valid Kubernetes name. Follow Kubernetes naming conventions while naming clusters.

Note

The secondary ingress must be a full URL for the ingress. For example: https://my-cluster.example.com/k10/

Disconnect Secondary Cluster

To remove a secondary cluster from K10 Multi-Cluster Manager, use the disconnect command.

$ k10multicluster disconnect \
    --primary-context=<primary_cluster_context_name> \
    --primary-name=<primary_cluster_name> \
    --secondary-context=<secondary_cluster_context_name> \
    --secondary-name=<secondary_cluster_name>

Disconnect Primary Cluster

After disconnecting all the secondary clusters, you can disconnect a primary cluster, by simply deleting the primary cluster object.

$ kubectl delete cluster <primary_cluster_name> --namespace=kasten-io-mc