summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/InstallGuide.rst95
1 files changed, 55 insertions, 40 deletions
diff --git a/docs/InstallGuide.rst b/docs/InstallGuide.rst
index 95b5749f..7e8ebf04 100644
--- a/docs/InstallGuide.rst
+++ b/docs/InstallGuide.rst
@@ -168,20 +168,29 @@ We need to setup the ``'hosts.yml'`` first, the template looks like this::
# This is group of hosts which are/will be part of Kubernetes cluster.
kubernetes:
- hosts:
- kubernetes-node-1:
- ansible_host: 10.8.8.19
- #ip of the node that it uses for communication with k8s cluster.
- cluster_ip: 10.8.8.19
-
- # This is a group of hosts that are to be used as kubernetes control plane nodes.
- # This means they host kubernetes api server, controller manager and scheduler.
- # This example uses infra for this purpose, however note that any
- # other host could be used including kubernetes nodes.
- # cluster_ip needs to be set for hosts used as control planes.
- kubernetes-control-plane:
- hosts:
- infrastructure-server
+ children:
+ # This is a group of hosts containing kubernetes worker nodes.
+ kubernetes-node:
+ hosts:
+ kubernetes-node-1:
+ ansible_host: 10.8.8.19
+ #ip of the node that it uses for communication with k8s cluster.
+ cluster_ip: 10.8.8.19
+
+ # Group of hosts containing etcd cluster nodes.
+ # Defaults to infra.
+ kubernetes-etcd:
+ hosts:
+ infrastructure-server
+
+ # This is a group of hosts that are to be used as kubernetes control plane nodes.
+ # This means they host kubernetes api server, controller manager and scheduler.
+ # This example uses infra for this purpose, however note that any
+ # other host could be used including kubernetes nodes.
+ # cluster_ip needs to be set for hosts used as control planes.
+ kubernetes-control-plane:
+ hosts:
+ infrastructure-server
nfs-server:
hosts:
@@ -222,37 +231,43 @@ After all the changes, the ``'hosts.yml'`` should look similar to this::
infrastructure:
hosts:
infrastructure-server:
- ansible_host: 10.8.8.100
+ ansible_host: 10.8.8.13
#IP used for communication between infra and kubernetes nodes, must be specified.
cluster_ip: 10.8.8.100
# This is group of hosts which are/will be part of Kubernetes cluster.
kubernetes:
- hosts:
- kubernetes-node-1:
- ansible_host: 10.8.8.101
- #ip of the node that it uses for communication with k8s cluster.
- cluster_ip: 10.8.8.101
- kubernetes-node-2:
- ansible_host: 10.8.8.102
- #ip of the node that it uses for communication with k8s cluster.
- cluster_ip: 10.8.8.102
- kubernetes-node-3:
- ansible_host: 10.8.8.103
- #ip of the node that it uses for communication with k8s cluster.
- cluster_ip: 10.8.8.103
-
- # This is a group of hosts that are to be used as kubernetes control plane nodes.
- # This means they host kubernetes api server, controller manager and scheduler.
- # This example uses infra for this purpose, however note that any
- # other host could be used including kubernetes nodes.
- # cluster_ip needs to be set for hosts used as control planes.
- kubernetes-control-plane:
- hosts:
- infrastructure-server
- ansible_host: 10.8.8.100
- #IP used for communication between infra and kubernetes nodes, must be specified.
- cluster_ip: 10.8.8.100
+ children:
+ # This is a group of hosts containing kubernetes worker nodes.
+ kubernetes-node:
+ hosts:
+ kubernetes-node-1:
+ ansible_host: 10.8.8.101
+ #ip of the node that it uses for communication with k8s cluster.
+ cluster_ip: 10.8.8.101
+ kubernetes-node-2:
+ ansible_host: 10.8.8.102
+ #ip of the node that it uses for communication with k8s cluster.
+ cluster_ip: 10.8.8.102
+ kubernetes-node-3:
+ ansible_host: 10.8.8.103
+ #ip of the node that it uses for communication with k8s cluster.
+ cluster_ip: 10.8.8.103
+
+ # Group of hosts containing etcd cluster nodes.
+ # Defaults to infra.
+ kubernetes-etcd:
+ hosts:
+ infrastructure-server
+
+ # This is a group of hosts that are to be used as kubernetes control plane nodes.
+ # This means they host kubernetes api server, controller manager and scheduler.
+ # This example uses infra for this purpose, however note that any
+ # other host could be used including kubernetes nodes.
+ # cluster_ip needs to be set for hosts used as control planes.
+ kubernetes-control-plane:
+ hosts:
+ infrastructure-server
nfs-server:
hosts: