Kubespray is an Ansible-based deployment tool for provisioning production-ready Kubernetes clusters across multiple infrastructure platforms and operating systems. The project is maintained under the Kubernetes SIGs organization and serves as a comprehensive solution for automating cluster deployment and configuration management at scale.
The repository supports deployment on a wide range of cloud providers and infrastructure types including AWS, Google Compute Engine, Azure, OpenStack, vSphere, Equinix Metal bare metal, and Oracle Cloud Infrastructure. It enables highly available cluster configurations with composable architecture, allowing users to select from multiple network plugins and container runtimes based on their specific requirements. The primary language used is Jinja, with Ansible serving as the orchestration framework for deployment automation.
Kubespray supports an extensive list of Linux distributions spanning Debian variants like Bookworm and Bullseye, Ubuntu 22.04 and 24.04, CentOS Stream and RHEL versions 9 and 10, Fedora releases 39 through 42, Fedora CoreOS, openSUSE Leap and Tumbleweed, Oracle Linux, Alma Linux, Rocky Linux, and several experimental distributions including Kylin Linux, Amazon Linux 2, UOS Linux, and openEuler. The tool maintains compatibility with Kubernetes 1.30 and later versions, supporting multiple container runtimes including Docker, containerd, and CRI-O.
The project offers significant flexibility in networking through ten available CNI plugins including Calico as the default option, Cilium, Flannel, Kube-OVN, Kube-Router, Macvlan, and Multus for multi-interface support. It includes support for various storage solutions via CSI plugins for AWS EBS, Azure Disk, GCP Persistent Disk, and Cinder, alongside local storage provisioners. Additional components supported include Cert-Manager, CoreDNS, ArgoCD, Helm, MetalLB, and a Docker registry.
According to GitGenius activity tracking, the repository has experienced substantial community engagement with 860 tracked issues and pull requests. The median response latency for issues and PRs is 0.0 hours, though the mean latency of 3840.4 hours reflects occasional delays on older items. The most active issue categories are kind/bug with 419 items, kind/feature with 270 items, and lifecycle/rotten with 216 items. Primary contributors tracked by GitGenius include tico88612 with 648 events, VannTen with 547 events, and yankay with 189 events, indicating sustained community involvement in maintenance and development.
The repository is classified across multiple domains including cluster deployment, container orchestration, infrastructure management, configuration management, and provisioning. It provides comprehensive documentation covering deployment scenarios from basic setup to advanced operations including high-availability configurations, air-gap installations, cluster upgrades, node management, and hardening procedures. The tool is designed to handle large-scale deployments with documented support for production environments requiring robust, scalable Kubernetes infrastructure.
