From 9a278bae00f163a1161e8f3a0dc99f230ea51696 Mon Sep 17 00:00:00 2001
From: Smaine Kahlouch <smaine.kahlouch@arkena.com>
Date: Sun, 22 Nov 2015 13:34:29 +0100
Subject: [PATCH] Update README with the latest version and simply inventory
---
README.md | 64 ++++++++++++++++++++-----------------------------------
1 file changed, 23 insertions(+), 41 deletions(-)
diff --git a/README.md b/README.md
index d5f16d930..9b6674297 100644
--- a/README.md
+++ b/README.md
@@ -12,17 +12,17 @@ The firewalls are not managed, you'll need to implement your own rules the way y
Ansible v1.9.x
### Components
-* [kubernetes](https://github.com/kubernetes/kubernetes/releases) v1.0.6
-* [etcd](https://github.com/coreos/etcd/releases) v2.2.0
+* [kubernetes](https://github.com/kubernetes/kubernetes/releases) v1.1.2
+* [etcd](https://github.com/coreos/etcd/releases) v2.2.2
* [calicoctl](https://github.com/projectcalico/calico-docker/releases) v0.5.1
-* [flanneld](https://github.com/coreos/flannel/releases) v0.5.3
+* [flanneld](https://github.com/coreos/flannel/releases) v0.5.5
* [docker](https://www.docker.com/) v1.8.3
Ansible
-------------------------
### Download binaries
-A role allows to download required binaries which will be stored in a directory defined by the variable
+A role allows to download required binaries. They will be stored in a directory defined by the variable
**'local_release_dir'** (by default /tmp).
Please ensure that you have enough disk space there (about **1G**).
@@ -34,8 +34,8 @@ The main variables to change are located in the directory ```environments/[env_n
### 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.
+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.
```
@@ -43,9 +43,7 @@ In node-mesh mode the nodes peers with all the nodes in order to exchange routes
10.99.0.26
[kube-master]
-# NB : the br_addr must be in the {{ calico_pool }} subnet
-# it will assign a /24 subnet per node
-10.99.0.26 br_addr=10.99.64.1
+10.99.0.26
[etcd]
10.99.0.26
@@ -58,14 +56,14 @@ In node-mesh mode the nodes peers with all the nodes in order to exchange routes
10.99.0.37
[itx2]
-10.99.0.26 br_addr=10.99.16.1
-10.99.0.4 br_addr=10.99.65.1 local_as=xxxxxxxx
-10.99.0.5 br_addr=10.99.66.1 local_as=xxxxxxxx
-10.99.0.6 br_addr=10.99.69.1 local_as=xxxxxxxx
+10.99.0.26
+10.99.0.4 local_as=xxxxxxxx
+10.99.0.5 local_as=xxxxxxxx
+10.99.0.6 local_as=xxxxxxxx
[rmv]
-10.99.0.36 br_addr=10.99.67.1 local_as=xxxxxxxx
-10.99.0.37 br_addr=10.99.68.1 local_as=xxxxxxxx
+10.99.0.36 local_as=xxxxxxxx
+10.99.0.37 local_as=xxxxxxxx
[k8s-cluster:children]
kube-node
@@ -100,11 +98,6 @@ peers=[{"router_id": "10.99.0.34", "as": "65xxx"}, {"router_id": "10.99.0.35", "
- hosts: kube-node
roles:
- { role: kubernetes/node, tags: node }
-
-- hosts: kube-master
- roles:
- - { role: apps/k8s-kubedns, tags: ['kubedns', 'apps'] }
- - { role: apps/k8s-fabric8, tags: ['fabric8', 'apps'] }
```
### Run
@@ -170,8 +163,9 @@ Additionnal apps can be installed with ```ansible-galaxy```.
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)
-For instance if you will probably want to install a [dns server](https://github.com/kubernetes/kubernetes/tree/master/cluster/addons/dns) as it is **strongly recommanded**.
+For instance it is **strongly recommanded** to install a dns server which resolves kubernetes service names.
In order to use this role you'll need the following entries in the file '*requirements.yml*'
+Please refer to the [k8s-kubdns readme](https://github.com/ansibl8s/k8s-kubedns) for additionnal info.
```
- src: https://github.com/ansibl8s/k8s-common.git
path: roles/apps
@@ -202,14 +196,13 @@ You can list available submodules with the following command:
grep path .gitmodules | sed 's/.*= //'
```
-For instance if you will probably want to install a [dns server](https://github.com/kubernetes/kubernetes/tree/master/cluster/addons/dns) as it is **strongly recommanded**.
-In order to use this role you'll need to follow these steps
+In order to install the dns addon you'll need to follow these steps
```
git submodule init roles/apps/k8s-common roles/apps/k8s-kubedns
git submodule update
```
-Finally update your playbook with the chosen role, and run it
+Finally update the playbook ```apps.yml``` with the chosen roles, and run it
```
...
- hosts: kube-master
@@ -217,7 +210,11 @@ Finally update your playbook with the chosen role, and run it
- { role: apps/k8s-kubedns, tags: ['kubedns', 'apps'] }
...
```
-Please refer to the [k8s-kubdns readme](https://github.com/ansibl8s/k8s-kubedns) for additionnal info.
+
+```
+ansible-playbook -i environments/dev/inventory apps.yml -u root
+```
+
#### Calico networking
Check if the calico-node container is running
@@ -242,19 +239,4 @@ calicoctl endpoint show --detail
```
#### Flannel networking
-Congrats ! now you can walk through [kubernetes basics](http://kubernetes.io/v1.0/basicstutorials.html)
-
-Known issues
--------------
-### Node reboot and Calico
-There is a major issue with calico-kubernetes version 0.5.1 and kubernetes prior to 1.1 :
-After host reboot, the pods networking are not configured again, they are started without any network configuration.
-This issue will be fixed when kubernetes 1.1 will be released as described in this [issue](https://github.com/projectcalico/calico-kubernetes/issues/34)
-
-### Monitoring addon
-Until now i didn't managed to get the monitoring addon working.
-
-### Apiserver listen on secure port only
-Currently the api-server listens on both secure and insecure ports.
-The insecure port is mainly used for calico.
-Will be fixed soon.
+Congrats ! now you can walk through [kubernetes basics](http://kubernetes.io/v1.1/basicstutorials.html)
--
GitLab