getting-started.md

Getting started

The easiest way to run the deployement is to use the kubespray-cli tool. A complete documentation can be found in its github repository.

Here is a simple example on AWS:

• Create instances and generate the inventory

kubespray aws --instances 3

• Run the deployment

kubespray deploy --aws -u centos -n calico

Building your own inventory

Ansible inventory can be stored in 3 formats: YAML, JSON, or INI-like. There is an example inventory located here.

You can use an inventory generator to create or modify an Ansible inventory. Currently, it is limited in functionality and is only use for making a basic Kubespray cluster, but it does support creating large clusters. It now supports separated ETCD and Kubernetes master roles from node role if the size exceeds a certain threshold. Run inventory.py help for more information.