# kubernetes-sigs/kubespray

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/kubernetes-sigs-kubespray).**

18,576 stars · 6,911 forks · Jinja · Apache-2.0

## Links

- GitHub: https://github.com/kubernetes-sigs/kubespray
- awesome-repositories: https://awesome-repositories.com/repository/kubernetes-sigs-kubespray.md

## Topics

`ansible` `aws` `bare-metal` `gce` `hacktoberfest` `high-availability` `k8s-sig-cluster-lifecycle` `kubernetes` `kubernetes-cluster` `kubespray`

## Description

Kubespray is an Ansible-based tool for deploying production-ready Kubernetes clusters on physical or virtual machines across various environments. It serves as an infrastructure provisioner and cluster deployer that automates the installation and configuration of cluster nodes.

The project functions as a bare metal cluster orchestrator, allowing for the setup of Kubernetes on physical hardware without relying on a managed cloud provider. It includes specialized installers for configuring networking fabrics, pod communication plugins, and routing policies.

The framework also manages the installation of essential cluster add-ons, such as ingress controllers and storage provisioners, to extend the functional capabilities of the environment.

## Tags

### DevOps & Infrastructure

- [Kubernetes Cluster Management](https://awesome-repositories.com/f/devops-infrastructure/kubernetes-cluster-management.md) — Automates the provisioning, configuration, and lifecycle management of production-ready Kubernetes clusters. ([source](https://cdn.jsdelivr.net/gh/kubernetes-sigs/kubespray@master/README.md))
- [Ansible Playbooks](https://awesome-repositories.com/f/devops-infrastructure/ansible-playbooks.md) — Provides declarative Ansible playbooks to automate the installation and configuration of Kubernetes clusters across remote servers.
- [SSH-Based Remote Execution](https://awesome-repositories.com/f/devops-infrastructure/execution-environments/remote-workspace-command-execution/ssh-based-remote-execution.md) — Executes deployment tasks and pushes configurations to target nodes via secure shell connections without requiring persistent agents.
- [Bare Metal Orchestration](https://awesome-repositories.com/f/devops-infrastructure/infrastructure/private-enterprise-management/virtualization-bare-metal/bare-metal-orchestration.md) — Provides automated provisioning and management of Kubernetes clusters on physical bare metal hardware.
- [Kubernetes Deployments](https://awesome-repositories.com/f/devops-infrastructure/kubernetes-deployments.md) — Provides a comprehensive toolkit for deploying production-ready Kubernetes clusters across various environments.
- [Ansible Provisioners](https://awesome-repositories.com/f/devops-infrastructure/kubernetes-deployments/ansible-provisioners.md) — Uses Ansible-based provisioning to configure and install Kubernetes components on Linux nodes.
- [Kubernetes Network Operators](https://awesome-repositories.com/f/devops-infrastructure/kubernetes-network-operators.md) — Automates the configuration of networking fabrics, pod communication plugins, and service exposure within the cluster.
- [Addons Management](https://awesome-repositories.com/f/devops-infrastructure/cluster-configuration-management/addons-management.md) — Enables the modular installation of specialized system components and add-ons to extend cluster functionality.
- [Cluster Configuration Templates](https://awesome-repositories.com/f/devops-infrastructure/configuration-management/template-and-generation-engines/configuration-driven-templating-engines/system-configuration-templates/cluster-configuration-templates.md) — Generates cluster-specific hardware and network settings using templates populated with dynamic variables.
- [Cluster Component Addons](https://awesome-repositories.com/f/devops-infrastructure/infrastructure-add-ons/pricing-add-on-management/cluster-component-addons.md) — Provides a system for installing and managing essential cluster add-ons like ingress controllers and storage provisioners. ([source](https://cdn.jsdelivr.net/gh/kubernetes-sigs/kubespray@master/README.md))

### Networking & Communication

- [Cluster Network Orchestration](https://awesome-repositories.com/f/networking-communication/cluster-network-orchestration.md) — Orchestrates cluster-wide network settings, including pod communication plugins and routing policies. ([source](https://cdn.jsdelivr.net/gh/kubernetes-sigs/kubespray@master/README.md))
- [Network Plugin Installers](https://awesome-repositories.com/f/networking-communication/proxy-installers/network-plugin-installers.md) — Installs and configures networking plugins and daemonsets to manage pod communication and transparent networking.

### Security & Cryptography

- [Deployment Target Mapping](https://awesome-repositories.com/f/security-cryptography/role-based-access-control/role-based-server-targeting/deployment-target-mapping.md) — Maps logical Kubernetes cluster roles to specific physical server IP addresses for targeted orchestration.

### Software Engineering & Architecture

- [Distributed Role Separation](https://awesome-repositories.com/f/software-engineering-architecture/distributed-role-separation.md) — Decouples infrastructure responsibilities by using modular roles for master, worker, and etcd nodes.
- [System State Idempotency](https://awesome-repositories.com/f/software-engineering-architecture/idempotency-mechanisms/system-state-idempotency.md) — Implements system state idempotency to ensure cluster configurations remain consistent across repeated deployment executions.