Instructions for setting up a Kubernetes cluster.

Documentation for Kubernetes v1.6 is no longer actively maintained. The version you are currently viewing is a static snapshot. For up-to-date documentation, see the latest version.

Edit This Page

Installing Kubernetes On-premise/Cloud Providers with Kubespray


This quickstart helps to install a Kubernetes cluster hosted on GCE, Azure, OpenStack, AWS or Baremetal with Kubespray tool.

Kubespray is a composition of Ansible playbooks, inventory generation CLI tools and domain knowledge for generic OS/Kubernetes clusters configuration management tasks. It provides:

To choose a tool which fits your use case the best, you may want to read this comparison to kubeadm and kops.

Creating a cluster

(1/4) Ensure the underlay requirements are met


(2/4) Compose the deployment


(3/4) Run the deployment


(4/4) (Optional) verify inter-pods connectivity and DNS resolve with Netchecker


Explore contributed add-ons

See the list of contributed playbooks to explore other deployment options.

What’s next

Kubespray has quite a few marks on the radar.


To delete your scratch cluster, you can apply the reset role with the manual ansible-playbook command.

Note, that it is highly unrecommended to delete production clusters with the reset playbook!



Create an Issue Edit this Page