Version 1.1. This version is not fully supported. For the latest patches and updates for security vulnerabilities, exposures, and issues impacting GKE On-Prem, upgrade to a fully supported version. You can find the most recent version here.

High availability

This page describes your high availability (HA) options in GKE On-Prem.

HA for user clusters

GKE On-Prem architecture with highly-available user clusters
GKE On-Prem architecture with highly-available user clusters (Click to enlarge)

GKE On-Prem supports HA user control planes. During cluster creation, you can choose to create three user control planes. To do so, specify usercluster.masternode.replicas: 3 in the GKE On-Prem configuration file you're using to create the user cluster.

To create a HA user cluster, GKE On-Prem creates three user control plane VMs (or master nodes) within the admin cluster. Each control plane VM runs the same Kubernetes control plane components. GKE On-Prem uses leader election to


Currently, you cannot resume cluster creation for a HA user cluster.

HA for admin clusters

GKE On-Prem does not currently support HA admin control planes. You can prevent a single point of failure in the admin cluster by enabling vSphere High Availability for your vSphere cluster.

vSphere High Availability protects GKE On-Prem admin clusters from going down in the event of an underlying host failure.

To learn more, see Create a vSphere HA Cluster.