kubespray-ha-configuration

Configure and verify Kubernetes HA with Kubespray etcd and load balancers.

6|2|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/sigridjineth/kubespray-skills --skill kubespray-ha-configuration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kubespray-ha-configuration
Source: https://github.com/sigridjineth/kubespray-skills/tree/main/kubespray-ha-configuration
Command: npx skills add https://github.com/sigridjineth/kubespray-skills --skill kubespray-ha-configuration

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses the critical need for continuous availability in Kubernetes clusters by guiding users through the setup and verification of High Availability (HA) configurations for control plane nodes and etcd.

Core Features & Use Cases

  • HA Architecture Explanation: Understands the roles of API servers, controller managers, schedulers, and etcd in an HA setup.
  • etcd Quorum Sizing: Provides guidance on selecting the correct number of etcd members for fault tolerance.
  • Load Balancing Strategies: Details three distinct approaches for load balancing API server traffic (client-side NGINX, external HAProxy, or a combined approach), including configuration examples and failure simulations.
  • Inventory and Configuration: Shows how to configure the Ansible inventory and group_vars for HA deployments.
  • Verification and Troubleshooting: Offers commands to check etcd health, leader election, and common error scenarios.

Quick Start

Configure a Kubernetes cluster for high availability by setting up multiple control plane nodes and etcd members, ensuring continuous operation even if some nodes fail.

Frequently Asked Questions about kubespray-ha-configuration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure high availability for a Kubernetes cluster using Kubespray?

To configure high availability with Kubespray, set up multiple control plane nodes and etcd members in your Ansible inventory, choose between stacked or external etcd, and configure API server load balancing using client-side NGINX, external HAProxy, or a combined approach.

What is the difference between stacked and external etcd in a Kubernetes HA setup?

Stacked etcd runs the etcd members on the same nodes as the Kubernetes control plane components, while external etcd hosts the etcd cluster on dedicated machines. Kubespray supports both topologies, requiring proper quorum sizing for fault tolerance.

What's the best way to load balance Kubernetes API server traffic in Kubespray?

Kubespray supports three API server load balancing strategies: client-side NGINX, external HAProxy, or a combined approach. You can configure these strategies through Ansible group_vars, with detailed inventory examples and failure simulations provided.

How do I verify etcd health and leader election after setting up Kubernetes HA?

Verify Kubernetes HA by running specific commands to check etcd cluster health, confirm leader election, and simulate node failures. These verification steps ensure your control plane maintains continuous operation during node outages.

How many etcd members do I need for fault tolerance in a Kubernetes HA cluster?

Etcd quorum sizing requires an odd number of members to maintain fault tolerance. Kubespray provides guidance on selecting the correct number of etcd members, ensuring your cluster can withstand node failures without losing data consistency.

Why does my Kubernetes HA control plane fail when a master node goes down?

HA control plane failures during node outages often indicate incorrect etcd quorum sizing, load balancer misconfiguration, or improper leader election. Kubespray's troubleshooting commands help identify common error scenarios and verify component health.