kubernetes-sigs
/
kubespray
mirror of https://github.com/kubernetes-sigs/kubespray.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #110 from Smana/updatedoc 

update submodules and documentation
pull/111/head
Antoine Legrand 2016-01-27 17:42:52 +01:00
parent cf472a6b4c 8d71d56809
commit f15dda0248
13 changed files with 57 additions and 64 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

87
README.md
View File

@ -16,8 +16,8 @@ Linux distributions tested:
### Requirements ### Requirements
* The target servers must have **access to the Internet** in order to pull docker imaqes. * The target servers must have **access to the Internet** in order to pull docker imaqes.
* The firewalls are not managed, you'll need to implement your own rules the way you used to. * The **firewalls are not managed**, you'll need to implement your own rules the way you used to.
in order to avoid any issue during deployment you should **disable your firewall** in order to avoid any issue during deployment you should disable your firewall
* **Copy your ssh keys** to all the servers part of your inventory. * **Copy your ssh keys** to all the servers part of your inventory.
* **Ansible v2.x and python-netaddr** * **Ansible v2.x and python-netaddr**
* Base knowledge on Ansible. Please refer to [Ansible documentation](http://www.ansible.com/how-ansible-works) * Base knowledge on Ansible. Please refer to [Ansible documentation](http://www.ansible.com/how-ansible-works)
@ -37,16 +37,20 @@ These defaults are good for tests purposes.
Edit the inventory according to the number of servers Edit the inventory according to the number of servers
``` ```
[kube-master] [kube-master]
10.115.99.31 node1
node2
[etcd] [etcd]
10.115.99.31 node1
10.115.99.32 node2
10.115.99.33 node3
[kube-node] [kube-node]
10.115.99.32 node2
10.115.99.33 node3
node4
node5
node6
[k8s-cluster:children] [k8s-cluster:children]
kube-node kube-node
@ -68,37 +72,32 @@ The main variables to change are located in the directory ```inventory/group_var
### Inventory ### Inventory
Below is an example of an inventory. Below is an example of an inventory.
Note : The bgp vars local_as and peers are not mandatory if the var **'peer_with_router'** is set to false
By default this variable is set to false and therefore all the nodes are configure in **'node-mesh'** mode.
In node-mesh mode the nodes peers with all the nodes in order to exchange routes.
``` ```
## Configure 'ip' variable to bind kubernetes services on a
## different ip than the default iface
node1 ansible_ssh_host=95.54.0.12 # ip=10.3.0.1
node2 ansible_ssh_host=95.54.0.13 # ip=10.3.0.2
node3 ansible_ssh_host=95.54.0.14 # ip=10.3.0.3
node4 ansible_ssh_host=95.54.0.15 # ip=10.3.0.4
node5 ansible_ssh_host=95.54.0.16 # ip=10.3.0.5
node6 ansible_ssh_host=95.54.0.17 # ip=10.3.0.6
[kube-master] [kube-master]
node1 ansible_ssh_host=10.99.0.26 node1
node2 ansible_ssh_host=10.99.0.27 node2
[etcd] [etcd]
node1 ansible_ssh_host=10.99.0.26 node1
node2 ansible_ssh_host=10.99.0.27 node2
node3 ansible_ssh_host=10.99.0.4 node3
[kube-node] [kube-node]
node2 ansible_ssh_host=10.99.0.27 node2
node3 ansible_ssh_host=10.99.0.4 node3
node4 ansible_ssh_host=10.99.0.5 node4
node5 ansible_ssh_host=10.99.0.36 node5
node6 ansible_ssh_host=10.99.0.37 node6
[paris]
node1 ansible_ssh_host=10.99.0.26
node3 ansible_ssh_host=10.99.0.4 local_as=xxxxxxxx
node4 ansible_ssh_host=10.99.0.5 local_as=xxxxxxxx
[new-york]
node2 ansible_ssh_host=10.99.0.27
node5 ansible_ssh_host=10.99.0.36 local_as=xxxxxxxx
node6 ansible_ssh_host=10.99.0.37 local_as=xxxxxxxx
[k8s-cluster:children] [k8s-cluster:children]
kube-node kube-node
@ -138,8 +137,6 @@ Kubernetes
* You can choose where to install the master components. If you want your master node to act both as master (api,scheduler,controller) and node (e.g. accept workloads, create pods ...), * You can choose where to install the master components. If you want your master node to act both as master (api,scheduler,controller) and node (e.g. accept workloads, create pods ...),
the server address has to be present on both groups 'kube-master' and 'kube-node'. the server address has to be present on both groups 'kube-master' and 'kube-node'.
* Almost all kubernetes components are running into pods except *kubelet*. These pods are managed by kubelet which ensure they're always running
* For safety reasons, you should have at least two master nodes and 3 etcd servers * For safety reasons, you should have at least two master nodes and 3 etcd servers
* Kube-proxy doesn't support multiple apiservers on startup ([Issue 18174](https://github.com/kubernetes/kubernetes/issues/18174)). An external loadbalancer needs to be configured. * Kube-proxy doesn't support multiple apiservers on startup ([Issue 18174](https://github.com/kubernetes/kubernetes/issues/18174)). An external loadbalancer needs to be configured.
@ -155,16 +152,6 @@ You can choose between 2 network plugins. Only one must be chosen.
The choice is defined with the variable '**kube_network_plugin**' The choice is defined with the variable '**kube_network_plugin**'
### Expose a service
There are several loadbalancing solutions.
The one i found suitable for kubernetes are [Vulcand](http://vulcand.io/) and [Haproxy](http://www.haproxy.org/)
My cluster is working with haproxy and kubernetes services are configured with the loadbalancing type '**nodePort**'.
eg: each node opens the same tcp port and forwards the traffic to the target pod wherever it is located.
Then Haproxy can be configured to request kubernetes's api in order to loadbalance on the proper tcp port on the nodes.
Please refer to the proper kubernetes documentation on [Services](https://github.com/kubernetes/kubernetes/blob/release-1.0/docs/user-guide/services.md)
### Check cluster status ### Check cluster status
@ -199,7 +186,7 @@ There are two ways of installing new apps
Additionnal apps can be installed with ```ansible-galaxy```. Additionnal apps can be installed with ```ansible-galaxy```.
ou'll need to edit the file '*requirements.yml*' in order to chose needed apps. you'll need to edit the file '*requirements.yml*' in order to chose needed apps.
The list of available apps are available [there](https://github.com/ansibl8s) The list of available apps are available [there](https://github.com/ansibl8s)
For instance it is **strongly recommanded** to install a dns server which resolves kubernetes service names. For instance it is **strongly recommanded** to install a dns server which resolves kubernetes service names.
@ -268,6 +255,18 @@ calicoctl pool show
calicoctl endpoint show --detail calicoctl endpoint show --detail
``` ```
##### Optionnal : BGP Peering with border routers
In some cases you may want to route the pods subnet and so NAT is not needed on the nodes.
For instance if you have a cluster spread on different locations and you want your pods to talk each other no matter where they are located.
The following variables need to be set:
**peer_with_router** enable the peering with border router of the datacenter (default value: false).
you'll need to edit the inventory and add a and a hostvar **local_as** by node.
```
node1 ansible_ssh_host=95.54.0.12 local_as=xxxxxx
```
#### Flannel #### Flannel
* Flannel configuration file should have been created there * Flannel configuration file should have been created there

12
requirements.yml
View File

@ -1,39 +1,30 @@
--- ---
- src: https://github.com/ansibl8s/k8s-common.git - src: https://github.com/ansibl8s/k8s-common.git
path: roles/apps path: roles/apps
version: v1.0
- src: https://github.com/ansibl8s/k8s-kubedns.git - src: https://github.com/ansibl8s/k8s-kubedns.git
path: roles/apps path: roles/apps
version: v1.0
#- src: https://github.com/ansibl8s/k8s-kube-ui.git #- src: https://github.com/ansibl8s/k8s-kube-ui.git
# path: roles/apps # path: roles/apps
# version: v1.0
# #
#- src: https://github.com/ansibl8s/k8s-fabric8.git #- src: https://github.com/ansibl8s/k8s-fabric8.git
# path: roles/apps # path: roles/apps
# version: v1.0
# #
#- src: https://github.com/ansibl8s/k8s-elasticsearch.git #- src: https://github.com/ansibl8s/k8s-elasticsearch.git
# path: roles/apps # path: roles/apps
# # version: v1.0
# #
#- src: https://github.com/ansibl8s/k8s-redis.git #- src: https://github.com/ansibl8s/k8s-redis.git
# path: roles/apps # path: roles/apps
# # version: v1.0
# #
#- src: https://github.com/ansibl8s/k8s-memcached.git #- src: https://github.com/ansibl8s/k8s-memcached.git
# path: roles/apps # path: roles/apps
# version: v1.0
# #
#- src: https://github.com/ansibl8s/k8s-postgres.git #- src: https://github.com/ansibl8s/k8s-postgres.git
# path: roles/apps # path: roles/apps
# version: v1.0
# #
#- src: https://github.com/ansibl8s/k8s-pgbouncer.git #- src: https://github.com/ansibl8s/k8s-pgbouncer.git
# path: roles/apps # path: roles/apps
# version: v1.0
# #
#- src: https://github.com/ansibl8s/k8s-heapster.git #- src: https://github.com/ansibl8s/k8s-heapster.git
# path: roles/apps # path: roles/apps
@ -43,3 +34,6 @@
# #
#- src: https://github.com/ansibl8s/k8s-kubedash.git #- src: https://github.com/ansibl8s/k8s-kubedash.git
# path: roles/apps # path: roles/apps
#
#- src: https://github.com/ansibl8s/k8s-kube-logstash.git
# path: roles/apps

2
roles/apps/k8s-elasticsearch

@ -1 +1 @@
Subproject commit 3d74c70a4a2d294ec86528468efa2c10ece7bd7b Subproject commit f089f60fb1102378b6def3972b50644deff96484

2
roles/apps/k8s-fabric8

@ -1 +1 @@
Subproject commit 82ca8293b091a3e6141f435eb1186bdd7b912bf2 Subproject commit 702923e2000d07bb95044c747c499bb04c3d16bf

2
roles/apps/k8s-heapster

@ -1 +1 @@
Subproject commit 44a6519bf8957bff316d3e3bc857d554f69c4016 Subproject commit 5442209acd072d170f9d24e2bbd00b95af737d7d

2
roles/apps/k8s-influxdb

@ -1 +1 @@
Subproject commit 38d54c48e76df2951d60a6e17a40d5a3d69a1e81 Subproject commit b892974d5b8bc624ac742e8a6fb7737db8a96a32

2
roles/apps/k8s-kube-logstash

@ -1 +1 @@
Subproject commit 256fa156e46d623ab0a7a60efdc7bac535cea8d7 Subproject commit c1c0ce8e27b430cff8e5b0f1519707eb892f5e67

2
roles/apps/k8s-kube-ui

@ -1 +1 @@
Subproject commit b81a2848d9e0be5f65c61dcb902b63fc60475633 Subproject commit 0b5be08de2b3f373146a36aef88be3d4e5565dc2

2
roles/apps/k8s-kubedash

@ -1 +1 @@
Subproject commit 64385696a907f8052cd455b85302fbd2d0bab129 Subproject commit 21544cc2a908b1578409c5eaca7ee2771b3b9811

2
roles/apps/k8s-kubedns

@ -1 +1 @@
Subproject commit d6df09a89721d98e2969a8abf29b4eb5e787fca6 Subproject commit 82b75f84129189fcfb08adfeb6ed6114c68dde3e

2
roles/apps/k8s-memcached

@ -1 +1 @@
Subproject commit a5bdd1d7141af57074e76878323a27410fc449ce Subproject commit 60a66ca0ae4dc9a7e29b9b9619134adada53e1a4

2
roles/apps/k8s-pgbouncer

@ -1 +1 @@
Subproject commit 22f9618b3209538e64fb2d8f030b45119bc5a9f2 Subproject commit 79961d1df223dd1563e41a1df109c4cffa8801ed

2
roles/apps/k8s-rabbitmq

@ -1 +1 @@
Subproject commit b91f96bb9cff2dbd1614a090263893b35862f3d1 Subproject commit 2b538e243a3230c97591a28ac438619ebd555e4c