Skip to content

Commit 2bda934

Browse files
Update README.md
1 parent df11b5b commit 2bda934

File tree

1 file changed

+2
-60
lines changed

1 file changed

+2
-60
lines changed

README.md

Lines changed: 2 additions & 60 deletions
Original file line numberDiff line numberDiff line change
@@ -1,57 +1,7 @@
11
# kubernetes-in-FiwareLab
22
This repository has set of ansible playbooks created to setup a kubernetes cluster fully automated with one master and multiple worker nodes. This will work on Fiware-Lab VMs. This has been tested and verified on Centos 7.9 64 bit operating systems with Kernel 5.12.10-1.el7.elrepo.x86_64 and Ubuntu 16.04 64 bit operating systems with Kernel Linux 4.4.0-210-generic.
3-
4-
# Prerequisites
5-
1. At least three VMs are required for K8s deployment.
6-
2. Servers required:
7-
8-
a. Ansible Host
9-
10-
b. Master Node
11-
12-
c. Worker Nodes
13-
14-
3. Ansible should be installed on Ansible Host. For installation steps, follow [install-ansible.md](https://github.com/Fiware-Community/kubernetes-in-FiwareLab/blob/main/docs/install-ansible.md).
15-
16-
# How to use this (Setup Instructions)
17-
1. Make servers ready (Ansible Host, one master node and multiple worker nodes) by creating new VMs on Fiware-Lab.
18-
2. Update the Kernel if it is lower than 5.x (for CentOS). Steps are added in [update-kernel.md](https://github.com/Fiware-Community/kubernetes-in-FiwareLab/blob/main/docs/update-kernel.md).
19-
3. Install firewall (if not installed). Steps are added in [setup-firewalld.md](https://github.com/Fiware-Community/kubernetes-in-FiwareLab/blob/main/docs/setup-firewalld.md).
20-
4. Make an entry of each hosts in /etc/hosts file for name resolution in Master and Worker VM as:
21-
22-
On Master: 127.0.0.1 <master-vm-name>.novalocal
23-
24-
On Worker: 127.0.0.1 <worker-vm-name>.novalocal
25-
26-
5. Make sure kubernetes master node and other worker nodes are reachable between each other.
27-
6. Internet connection must be enabled in all nodes, required packages will be downloaded from kubernetes official yum repository.
28-
7. Copy the script and ansible playbooks on Ansible Host VM.
29-
8. There is a file ```hosts``` in this folder, make entries of all kubernetes nodes.
30-
9. Provide server details in ```playbooks/env_variables```.
31-
10. Deploy the ssh key from Ansible Host to nodes for password less authentication. Steps are added in [passwordless-ssh.md](https://github.com/Fiware-Community/kubernetes-in-FiwareLab/blob/main/docs/passwordless-ssh.md).
32-
11. Provide root level privilege to centos or ubuntu user. Steps are added in [root-access.md](https://github.com/Fiware-Community/kubernetes-in-FiwareLab/blob/main/docs/root-access.md).
33-
12. Run ```settingup_kubernetes_cluster.yml``` playbook to setup all nodes and kubernetes master configuration.
34-
35-
```ansible-playbook settingup_kubernetes_cluster.yml```
36-
37-
13. Run ```join_kubernetes_workers_nodes.yml``` playbook to join the worker nodes with kubernetes master node once ```settingup_kubernetes_cluster.yml``` playbook tasks are completed.
38-
39-
```ansible-playbook join_kubernetes_workers_nodes.yml```
40-
41-
14. Verify the configuration from master node.
42-
```
43-
kubectl get nodes
44-
kubectl get pods --all-namespaces
45-
```
46-
47-
# Troubleshooting
48-
In case settingup_kubernetes_cluster playbook fails due to some system errors. Then reset the cluster otherwise it will show different errors like **PORT IN USE** and **CERTIFICATES ALREADY EXIST**
49-
To fix these errors run below commands on master node:
50-
51-
Kubeadm reset
52-
iptables -F && iptables -t nat -F && iptables -t mangle -F && iptables -X
533

54-
# Files in this repository
4+
# Files in this repository under centos and ubuntu folders
555
1. **ansible.cfg** - Ansible configuration file created locally.
566
2. **hosts** - Ansible Inventory File
577
3. **env_variables** - Main environment variable file where we have to specify based on our environment.
@@ -60,14 +10,6 @@ To fix these errors run below commands on master node:
6010
6. **clear_k8s_setup.yml** - Ansible Playbook helps to delete entire configurations from all nodes.
6111
7. **playbooks** – It’s a directory holds all playbooks.
6212

63-
# Deploy Fiware GEs using HELM
64-
1. To make use of the charts, you may add the repository:
65-
66-
helm repo add fiware https://fiware.github.io/helm-charts
67-
2. After the repo is added all charts can be installed via:
68-
69-
```helm install <RELEASE_NAME> fiware/<CHART_NAME>```
70-
7113
# Limitations
72-
1. Ansible script would deploy bare minimum K8s. User can configure K8s like persistent storage etc.
14+
1. Ansible script would deploy bare minimum K8s. User can configure K8s like persistent storage etc.
7315
2. At least three VMs are required for K8s deployment.

0 commit comments

Comments
 (0)