You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

87 lines
4.3 KiB

  1. ![Kubespray Logo](http://s9.postimg.org/md5dyjl67/kubespray_logoandkubespray_small.png)
  2. ##Deploy a production ready kubernetes cluster
  3. If you have questions, you can [invite yourself](https://slack.kubespray.io/) to **chat** with us on Slack! [![SlackStatus](https://slack.kubespray.io/badge.svg)](https://kubespray.slack.com)
  4. - Can be deployed on **AWS, GCE, OpenStack or Baremetal**
  5. - **High available** cluster
  6. - **Composable** (Choice of the network plugin for instance)
  7. - Support most popular **Linux distributions**
  8. - **Continuous integration tests**
  9. To deploy the cluster you can use :
  10. [**kargo-cli**](https://github.com/kubespray/kargo-cli) (deprecated, a newer [go](https://github.com/Smana/kargo-cli/tree/kargogo) version soon)<br>
  11. **Ansible** usual commands <br>
  12. **vagrant** by simply running `vagrant up` (for tests purposes) <br>
  13. * [Requirements](#requirements)
  14. * [Getting started](docs/getting-started.md)
  15. * [Vagrant install](docs/vagrant.md)
  16. * [CoreOS bootstrap](docs/coreos.md)
  17. * [Ansible variables](docs/ansible.md)
  18. * [Cloud providers](docs/cloud.md)
  19. * [OpenStack](docs/openstack.md)
  20. * [AWS](docs/aws.md)
  21. * [Network plugins](#network-plugins)
  22. * [Roadmap](docs/roadmap.md)
  23. Supported Linux distributions
  24. ===============
  25. * **CoreOS**
  26. * **Debian** Wheezy, Jessie
  27. * **Ubuntu** 14.10, 15.04, 15.10, 16.04
  28. * **Fedora** 23
  29. * **CentOS/RHEL** 7
  30. Versions
  31. --------------
  32. [kubernetes](https://github.com/kubernetes/kubernetes/releases) v1.4.0 <br>
  33. [etcd](https://github.com/coreos/etcd/releases) v3.0.1 <br>
  34. [calicoctl](https://github.com/projectcalico/calico-docker/releases) v0.20.0 <br>
  35. [flanneld](https://github.com/coreos/flannel/releases) v0.5.5 <br>
  36. [weave](http://weave.works/) v1.6.1 <br>
  37. [docker](https://www.docker.com/) v1.10.3 <br>
  38. Requirements
  39. --------------
  40. * The target servers must have **access to the Internet** in order to pull docker images.
  41. * The **firewalls are not managed**, you'll need to implement your own rules the way you used to.
  42. in order to avoid any issue during deployment you should disable your firewall
  43. * **Copy your ssh keys** to all the servers part of your inventory.
  44. * **Ansible v2.x and python-netaddr**
  45. ## Network plugins
  46. You can choose between 3 network plugins. (default: `flannel` with vxlan backend)
  47. * [**flannel**](docs/flannel.md): gre/vxlan (layer 2) networking.
  48. * [**calico**](docs/calico.md): bgp (layer 3) networking.
  49. * **weave**: Weave is a lightweight container overlay network that doesn't require an external K/V database cluster. <br>
  50. (Please refer to `weave` [troubleshooting documentation](http://docs.weave.works/weave/latest_release/troubleshooting.html))
  51. The choice is defined with the variable `kube_network_plugin`
  52. ## CI Tests
  53. [![Build Status](https://travis-ci.org/kubespray/kargo.svg)](https://travis-ci.org/kubespray/kargo) </br>
  54. ### Google Compute Engine
  55. | Calico | Flannel | Weave |
  56. ------------- | ------------- | ------------- | ------------- |
  57. Ubuntu Xenial |[![Build Status](https://ci.kubespray.io/job/kargo-gce-xenial-calico/badge/icon)](https://ci.kubespray.io/job/kargo-gce-xenial-calico/)|[![Build Status](https://ci.kubespray.io/job/kargo-gce-xenial-flannel/badge/icon)](https://ci.kubespray.io/job/kargo-gce-xenial-flannel/)|[![Build Status](https://ci.kubespray.io/job/kargo-gce-xenial-weave/badge/icon)](https://ci.kubespray.io/job/kargo-gce-xenial-weave)|
  58. CentOS 7 |[![Build Status](https://ci.kubespray.io/job/kargo-gce-centos7-calico/badge/icon)](https://ci.kubespray.io/job/kargo-gce-centos7-calico/)|[![Build Status](https://ci.kubespray.io/job/kargo-gce-centos7-flannel/badge/icon)](https://ci.kubespray.io/job/kargo-gce-centos7-flannel/)|[![Build Status](https://ci.kubespray.io/job/kargo-gce-centos7-weave/badge/icon)](https://ci.kubespray.io/job/kargo-gce-centos7-weave/)|
  59. CoreOS (stable) |[![Build Status](https://ci.kubespray.io/job/kargo-gce-coreos-calico/badge/icon)](https://ci.kubespray.io/job/kargo-gce-coreos-calico/)|[![Build Status](https://ci.kubespray.io/job/kargo-gce-coreos-flannel/badge/icon)](https://ci.kubespray.io/job/kargo-gce-coreos-flannel/)|[![Build Status](https://ci.kubespray.io/job/kargo-gce-coreos-weave/badge/icon)](https://ci.kubespray.io/job/kargo-gce-coreos-weave/)|
  60. CI tests sponsored by Google (GCE), and [teuto.net](https://teuto.net/) for OpenStack.