initial commit

README.md

@@ -0,0 +1,93 @@
+# Build a Kubernetes HA-cluster using k3s & kube-vip & metal-lb via Ansible
+
+Based on <https://github.com/k3s-io/k3s-ansible>
+
+Forked from <https://github.com/212850a/k3s-ansible>
+
+Kube-vip Control Plane is described -> <https://kube-vip.io/control-plane/>
+
+Video here <https://www.youtube.com/watch?v=CbkEWcUZ7zM>
+
+More docs here <https://docs.technotim.live/posts/k3s-etcd-ansible/>
+
+## K3s Ansible Playbook
+
+Build a Kubernetes cluster using Ansible with k3s. The goal is easily install a Kubernetes cluster on machines running:
+
+- [X] Debian
+- [X] Ubuntu
+- [X] CentOS
+
+on processor architecture:
+
+- [X] x64
+- [X] arm64
+- [X] armhf
+
+## System requirements
+
+Deployment environment must have Ansible 2.4.0+
+Master and nodes must have passwordless SSH access
+
+## Usage
+
+First create a new directory based on the `sample` directory within the `inventory` directory:
+
+```bash
+cp -R inventory/sample inventory/my-cluster
+```
+
+Second, edit `inventory/my-cluster/hosts.ini` to match the system information gathered above. For example:
+
+```ini
+[master]
+192.168.30.38
+192.168.30.39
+192.168.30.40
+
+[node]
+192.168.30.41
+192.168.30.42
+
+[k3s_cluster:children]
+master
+node
+```
+
+If multiple hosts are in the master group, the playbook will automatically setup k3s in HA mode with etcd.
+<https://rancher.com/docs/k3s/latest/en/installation/ha-embedded/>
+This requires at least k3s version 1.19.1
+
+If needed, you can also edit `inventory/my-cluster/group_vars/all.yml` to match your environment.
+
+Start provisioning of the cluster using the following command:
+
+```bash
+ansible-playbook site.yml -i inventory/my-cluster/hosts.ini
+```
+
+After deployment control plane will be accessible via virtual ip-address which is defined in inventory/group_vars/all.yml as apiserver_endpoint
+
+Remove k3s cluster
+
+```bash
+ansible-playbook reset.yml -i inventory/my-cluster/hosts.ini
+```
+
+**Note: add --ask-pass --ask-become-pass if you are using password logins over ssh**
+
+## Kubeconfig
+
+To get access to your **Kubernetes** cluster just
+
+```bash
+scp debian@master_ip:~/.kube/config ~/.kube/config
+```
+
+## kube-vip
+
+See <https://kube-vip.chipzoller.dev/>
+
+## MetalLB
+
+see <https://metallb.universe.tf/installation/>