Setup

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

Picking the Right Solution

Kubernetes can run on various platforms: from your laptop, to VMs on a cloud provider, to rack of bare metal servers. The effort required to set up a cluster varies from running a single command to crafting your own customized cluster. Use this guide to choose a solution that fits your needs.

If you just want to “kick the tires” on Kubernetes, use the local Docker-based solution using MiniKube.

When you are ready to scale up to more machines and higher availability, a hosted solution is the easiest to create and maintain.

Turnkey cloud solutions require only a few commands to create and cover a wide range of cloud providers.

If you already have a way to configure hosting resources, use kubeadm to easily bring up a cluster with a single command per machine.

Custom solutions vary from step-by-step instructions to general advice for setting up a Kubernetes cluster from scratch.

Local-machine Solutions

Hosted Solutions

Turnkey Cloud Solutions

These solutions allow you to create Kubernetes clusters on a range of Cloud IaaS providers with only a few commands. These solutions are actively developed and have active community support.

Custom Solutions

Kubernetes can run on a wide range of Cloud providers and bare-metal environments, and with many base operating systems.

If you can find a guide below that matches your needs, use it. It may be a little out of date, but it will be easier than starting from scratch. If you do want to start from scratch, either because you have special requirements, or just because you want to understand what is underneath a Kubernetes cluster, try the Getting Started from Scratch guide.

If you are interested in supporting Kubernetes on a new platform, see Writing a Getting Started Guide.

Universal

If you already have a way to configure hosting resources, use kubeadm to easily bring up a cluster with a single command per machine.

Cloud

These solutions are combinations of cloud providers and operating systems not covered by the above solutions.

On-Premises VMs

Bare Metal

Integrations

These solutions provide integration with third-party schedulers, resource managers, and/or lower level platforms.

Table of Solutions

Below is a table of all of the solutions listed above.

IaaS Provider Config. Mgmt. OS Networking Docs Support Level
any any multi-support any CNI docs Project (SIG-cluster-lifecycle)
GKE     GCE docs Commercial
Stackpoint.io   multi-support multi-support docs Commercial
AppsCode.com Saltstack Debian multi-support docs Commercial
KCluster.io   multi-support multi-support docs Commercial
KUBE2GO.io   multi-support multi-support docs Commercial
Madcore.Ai Jenkins DSL Ubuntu flannel docs Community (@madcore-ai)
Platform9   multi-support multi-support docs Commercial
Giant Swarm   CoreOS flannel and/or Calico docs Commercial
GCE Saltstack Debian GCE docs Project
Azure Container Service   Ubuntu Azure docs Commercial
Azure (IaaS)   Ubuntu Azure docs Community (Microsoft)
Bare-metal Ansible Fedora flannel docs Project
Bare-metal custom Fedora none docs Project
Bare-metal custom Fedora flannel docs Community (@aveshagarwal)
libvirt custom Fedora flannel docs Community (@aveshagarwal)
KVM custom Fedora flannel docs Community (@aveshagarwal)
Mesos/Docker custom Ubuntu Docker docs Community (Kubernetes-Mesos Authors)
Mesos/GCE       docs Community (Kubernetes-Mesos Authors)
DCOS Marathon CoreOS/Alpine custom docs Community (Kubernetes-Mesos Authors)
AWS CoreOS CoreOS flannel docs Community
GCE CoreOS CoreOS flannel docs Community (@pires)
Vagrant CoreOS CoreOS flannel docs Community (@pires, @AntonioMeireles)
Bare-metal (Offline) CoreOS CoreOS flannel docs Community (@jeffbean)
CloudStack Ansible CoreOS flannel docs Community (@sebgoa)
Vmware vSphere Saltstack Debian OVS docs Community (@imkin)
Vmware Photon Saltstack Debian OVS docs Community (@alainroy)
Bare-metal custom CentOS flannel docs Community (@coolsvap)
AWS Juju Ubuntu flannel docs Commercial and Community ( @matt, @chuck )
GCE Juju Ubuntu flannel docs Commercial and Community ( @matt, @chuck )
Bare Metal Juju Ubuntu flannel docs Commercial and Community ( @matt, @chuck )
Rackspace Juju Ubuntu flannel docs Commercial and Community ( @matt, @chuck )
Vmware vSphere Juju Ubuntu flannel docs Commercial and Community ( @matt, @chuck )
AWS Saltstack Debian AWS docs Community (@justinsb)
AWS kops Debian AWS docs Community (@justinsb)
Bare-metal custom Ubuntu flannel docs Community (@resouer, @WIZARD-CXY)
libvirt/KVM CoreOS CoreOS libvirt/KVM docs Community (@lhuard1A)
oVirt       docs Community (@simon3z)
OpenStack Heat Saltstack CentOS Neutron + flannel hostgw docs Community (@FujitsuEnablingSoftwareTechnologyGmbH)
any any any any docs Community (@erictune)
any any any any docs Commercial and Community

Note: The above table is ordered by version test/used in nodes, followed by support level.

Definition of columns

Analytics

Create an Issue Edit this Page