Overview

In a multi-cluster setup, one cluster is designated as primary, while all others are designated as secondaries. All primary and secondary clusters must have K10 installed. See Installing K10 for instructions.

Primary

The cluster from which the K10 Multi-Cluster Manager will be accessed is designated as primary.

The primary cluster defines policies and other configuration centrally. Centrally defined policies and configuration can then be distributed to designated clusters to be enacted.

The primary cluster also aggregates metrics so that they may be reported centrally.

This provides a single pane of glass through which all clusters in the system are managed.

Secondary

Non-primary clusters are designated as secondaries.

The secondary clusters receive policies and other configuration from the primary cluster. Once policies are distributed to a secondary, the local K10 installation enacts the policy. This ensures that the policy will continue to be enforced, even if disconnected from the primary.

Requirements

Network

  • Primary Cluster's K10's ingress must be accessible by secondary clusters.

  • Secondary Dashboard Access via Multi-Cluster Dashboard (Optional)

    • Secondary Cluster's API Server must be accessible by the primary cluster.

    • Secondary Cluster's K10's ingress must be accessible by the primary cluster.

Clock Synchronization

  • Primary and secondary clusters must have less than 5 minute clock skew for multi-cluster metrics functionality.