2015-10-03 20:49:48 +00:00
|
|
|
|
2016-05-12 15:22:36 +00:00
|
|
|
|
2016-03-07 15:07:00 +00:00
|
|
|
![Kubespray Logo](http://s9.postimg.org/md5dyjl67/kubespray_logoandkubespray_small.png)
|
2015-10-03 20:49:48 +00:00
|
|
|
|
2016-05-18 02:52:57 +00:00
|
|
|
# Deploy a production ready kubernetes cluster
|
2016-03-21 21:25:09 +00:00
|
|
|
|
2016-04-04 08:11:10 +00:00
|
|
|
- Can be deployed on **AWS, GCE, OpenStack or Baremetal**
|
|
|
|
- **High available** cluster
|
|
|
|
- **Composable** (Choice of the network plugin for instance)
|
|
|
|
- Support most popular **Linux distributions**
|
|
|
|
- **Continuous integration tests**
|
|
|
|
|
2016-05-18 02:52:57 +00:00
|
|
|
# Getting Started
|
2016-05-08 15:11:09 +00:00
|
|
|
|
2016-05-11 15:37:15 +00:00
|
|
|
To deploy the cluster you can use :
|
|
|
|
|
2016-05-18 02:52:57 +00:00
|
|
|
## kargo-cli
|
|
|
|
|
|
|
|
[**kargo-cli**](https://github.com/kubespray/kargo-cli)
|
|
|
|
|
|
|
|
## Vagrant
|
|
|
|
|
|
|
|
Assuming you have Vagrant (1.8+) installed with virtualbox (it may work
|
|
|
|
with vmware, but is untested) you should be able to launch a 3 node
|
|
|
|
Kubernetes cluster by simply running `$ vagrant up`.
|
|
|
|
|
|
|
|
This will spin up 3 VMs and install kubernetes on them. Once they are
|
|
|
|
completed you can connect to any of them by running
|
|
|
|
`$ vagrant ssh k8s-0[1..3]`.
|
|
|
|
|
|
|
|
```
|
|
|
|
$ vagrant up
|
|
|
|
Bringing machine 'k8s-01' up with 'virtualbox' provider...
|
|
|
|
Bringing machine 'k8s-02' up with 'virtualbox' provider...
|
|
|
|
Bringing machine 'k8s-03' up with 'virtualbox' provider...
|
|
|
|
==> k8s-01: Box 'bento/ubuntu-14.04' could not be found. Attempting to find and install...
|
|
|
|
...
|
|
|
|
...
|
|
|
|
k8s-03: Running ansible-playbook...
|
|
|
|
|
|
|
|
PLAY [k8s-cluster] *************************************************************
|
|
|
|
|
|
|
|
TASK [setup] *******************************************************************
|
|
|
|
ok: [k8s-03]
|
|
|
|
ok: [k8s-01]
|
|
|
|
ok: [k8s-02]
|
|
|
|
...
|
|
|
|
...
|
|
|
|
PLAY RECAP *********************************************************************
|
|
|
|
k8s-01 : ok=157 changed=66 unreachable=0 failed=0
|
|
|
|
k8s-02 : ok=137 changed=59 unreachable=0 failed=0
|
|
|
|
k8s-03 : ok=86 changed=51 unreachable=0 failed=0
|
|
|
|
|
|
|
|
$ vagrant ssh k8s-01
|
|
|
|
vagrant@k8s-01:~$ kubectl get nodes
|
|
|
|
NAME STATUS AGE
|
|
|
|
k8s-01 Ready 45s
|
|
|
|
k8s-02 Ready 45s
|
|
|
|
k8s-03 Ready 45s
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
## Ansible
|
|
|
|
|
|
|
|
**Ansible** usual commands
|
|
|
|
|
|
|
|
# Further Reading
|
2016-05-11 15:37:15 +00:00
|
|
|
|
2016-04-07 15:08:39 +00:00
|
|
|
A complete **documentation** can be found [**here**](https://docs.kubespray.io)
|
2016-04-04 08:11:10 +00:00
|
|
|
|
2016-05-12 15:22:36 +00:00
|
|
|
if you have any question you can **chat** with us [![SlackStatus](https://slack.kubespray.io/badge.svg)](https://kubespray.slack.com)
|
2016-05-11 15:37:15 +00:00
|
|
|
|
|
|
|
[![Build Status](https://travis-ci.org/kubespray/kargo.svg)](https://travis-ci.org/kubespray/kargo) </br>
|
2016-05-18 10:14:07 +00:00
|
|
|
CI tests sponsored by Google (GCE), and [teuto.net](https://teuto.net/) for OpenStack.
|