# Set up a multi-zone deployment
# Multi-Zone Mode
This is a more advanced deployment mode for Kuma that allow us to support service meshes that are running on many zones, including hybrid deployments on both Kubernetes and VMs.
- Control plane: There is one
globalcontrol plane, and many
zonecontrol planes. A global control plane only accepts connections from zone control planes.
- Data plane proxies: The data plane proxies connect to the closest
zonecontrol plane in the same zone. Additionally, we need to start a
zone-ingressproxy on every zone to have cross-zone communication between data plane proxies in different zones.
- Service Connectivity: Automatically resolved via the built-in DNS resolver that ships with Kuma. When a service wants to consume another service, it will resolve the DNS address of the desired service with Kuma, and Kuma will respond with a Virtual IP address, that corresponds to that service in the Kuma service domain.
We can support multiple isolated service meshes thanks to Kuma's multi-tenancy support, and workloads from both Kubernetes or any other supported Universal environment can participate in the Service Mesh across different regions, clouds, and datacenters while not compromising the ease of use and still allowing for end-to-end service connectivity.
When running in multi-zone mode, we introduce the notion of a
zone control planes for Kuma:
- Global: this control plane will be used to configure the global Service Mesh policies that we want to apply to our data plane proxies. Data plane proxies cannot connect directly to a global control plane, but can connect to
zonecontrol planes that are being deployed on each underlying zone that we want to include as part of the Service Mesh (can be a Kubernetes cluster, or VM based). Only one deployment of the global control plane is required, and it can be scaled horizontally.
- Zone: we are going to have as many zone control planes as the number of underlying Kubernetes or VM zones that we want to include in a Kuma mesh. Zone control planes accept connections from data plane proxies that are started in the same underlying zone, and they connect to the
globalcontrol plane to fetch their service mesh policies. Zone control plane policy APIs are read-only and cannot accept Service Mesh policies to be directly configured on them. They can be scaled horizontally within their zone.
In this deployment, a Kuma cluster is made of one global control plane and as many zone control planes as the number of zones that we want to support:
- Zone: A zone identifies a Kubernetes cluster, a VPC, or any other cluster that we want to include in a Kuma service mesh.
In a multi-zone deployment mode, services will be running on multiple platforms, clouds, or Kubernetes clusters (which are identifies as
zones in Kuma). While all of them will be part of a Kuma mesh by connecting their data plane proxies to the local
zone control plane in the same zone, implementing service to service connectivity would be tricky since a source service may not know where a destination service is being hosted at (for instance, in another zone).
To implement easy service connectivity, Kuma ships with:
- DNS Resolver: Kuma provides an out of the box DNS server on every
zonecontrol plane that will be used to resolve service addresses when estabilishing any service-to-service communication. It scales horizontally as we scale the
- Zone Ingress Proxy: Kuma provides an out of the box
zone-ingressproxy mode that will be used to enable traffic to enter a zone from another zone. It can be scaled horizontally. Each zone must have a
zone-ingress proxy is specific to internal communication within a mesh and it is not to be considered an API gateway. API gateways are supported via Kuma's gateway mode which can be deployed in addition to
The global control plane and the zone control planes communicate with each other via xDS in order to synchronize the resources that are being created to configure Kuma, like policies.
For Kubernetes: The global control plane on Kubernetes must reside on its own Kubernetes cluster, in order to keep the CRDs separate from the ones that the zone control planes will create during the synchronization process.
In order to deploy Kuma in a multi-zone deployment, we must start a
global and as many
zone control planes as the number of zones that we want to support.
# Global control plane
First we start the
global control plane and configure the
zone control planes connectivity.
# Zone control plane
zone control planes in each zone that will be part of the multi-zone Kuma deployment.
zone control plane, you need to assign the zone name for each of them and point it to the Global CP.
# Verify control plane connectivity
When a zone control plane connects to the global control plane, the
Zone resource is created automatically in the global control plane.
You can verify if a zone control plane is connected to the global control plane by inspecting the list of zones in the global control plane GUI (
:5681/gui/#/zones) or by using
kumactl get zones.
Additionally, if you deployed zone control plane with Zone Ingress, it should be visible in the Zone Ingress tab of the GUI. Cross-zone communication between services is only available if Zone Ingress has a public address and public port. Note that on Kubernetes, Kuma automatically tries to pick up the public address and port. Depending on the LB implementation of your Kubernetes provider, you may need to wait a couple of minutes to receive the address.
# Enable mTLS
# Using the multi-zone deployment
To utilize the multi-zone Kuma deployment follow the steps below
The Kuma DNS service format (e.g.
echo-server_kuma-test_svc_1010.mesh) is a composition of Kubernetes Service Name (
kuma-test), a fixed string (
svc), the service port (
1010). The service is resolvable in the DNS zone
the Kuma DNS service is hooked.
# Deleting a Zone
To delete a
Zone we must first shut down the corresponding Kuma Zone CP instances. As long as the Zone CP is running this will not be possible, and Kuma will return a validation error like:
zone: unable to delete Zone, Zone CP is still connected, please shut it down first
When the Zone CP is fully disconnected and shut down, then the
Zone can be deleted. All corresponding resources (like
DataplaneInsight) will be deleted automatically as well.
# Disabling zone
In order to disable routing traffic to a specific
Zone, we can disable the
Zone via the
type: Zone name: zone-1 spec: enabled: true
Changing this value to
enabled: false will allow the user to exclude the
Zone Ingress from all other zones - and by doing so - preventing traffic from being able to enter the
Zone that has been disabled will show up as "Offline" in the GUI and CLI