Skip to main content

Hybrid Setup

Connect multiple Kubernetes clusters across different cloud providers using Cilium Cluster Mesh for seamless cross-cluster workload communication.

Cilium Cluster Mesh​

Cilium Cluster Mesh provides:

  • Cross-cluster service discovery
  • Shared service load balancing
  • Network policy enforcement across clusters
  • Transparent encryption

Use Cases​

Use CaseDescription
Multi-cloud resilienceRun workloads across Hetzner + Azure for redundancy
Geographic distributionPlace clusters close to users in different regions
Cost optimizationUse cheaper providers for burst capacity
Hybrid cloudConnect on-premises with cloud providers
MigrationGradually move workloads between clusters

Example: Hetzner + Azure​

┌─────────────────┐         ┌─────────────────┐
│  Hetzner Cluster │◄──────►│  Azure Cluster  │
│                 │ Cilium  │                 │
│  Control Plane  │ Cluster │  Control Plane  │
│  Worker Nodes   │  Mesh   │  Worker Nodes   │
└─────────────────┘         └─────────────────┘

Prerequisites​

  1. Multiple KubeAid clusters deployed (see Cloud Providers)
  2. Network connectivity between clusters (routable IPs or VPN)
  3. Cilium installed on all clusters (included by default)
  4. Compatible Cilium versions across clusters
  5. Unique cluster names in the mesh

Setup Steps​

  1. Enable Cluster Mesh:
cilium clustermesh enable --context <cluster1-context>
cilium clustermesh enable --context <cluster2-context>
  1. Connect clusters:
cilium clustermesh connect \
  --context <cluster1-context> \
  --destination-context <cluster2-context>
  1. Verify connectivity:
cilium clustermesh status --context <cluster1-context>

For detailed configuration, see the Cilium Cluster Mesh documentation.

Hetzner Hybrid Mode​

note

This is different from Cilium Cluster Mesh.

Hetzner's built-in hybrid mode creates a single cluster with mixed node types:

  • Control plane in HCloud (VMs)
  • Worker nodes in HCloud and/or Bare Metal

See Cloud Providers - Hetzner Hybrid for setup instructions.

See Also​