8484c015d6
- K3s has some absolute paths set in various places which cannot be changed. Using a symbolic link was the easiest fix. This is nice for running K3S on SBC that must boot to SD but K3S data should be stored on a faster drive. - Other changes are for making the site playbook replayable without resetting the cluster. Ideally you can rerun it to check existing nodes or to add new ones. Signed-off-by: Derek Nola <derek.nola@suse.com> |
||
|---|---|---|
| .github/workflows | ||
| collections | ||
| playbook | ||
| roles | ||
| .gitignore | ||
| .yamllint | ||
| LICENSE | ||
| README.md | ||
| ansible.cfg | ||
| inventory-sample.yml | ||
README.md
Build a Kubernetes cluster using k3s via Ansible
Author: https://github.com/itwars
K3s Ansible Playbook
Build a Kubernetes cluster using Ansible with k3s. The goal is easily install a Kubernetes cluster on machines running:
- Debian
- Ubuntu
- CentOS
on processor architecture:
- x64
- arm64
- armhf
System requirements
Deployment environment must have Ansible 2.4.0+ Master and nodes must have passwordless SSH access
Usage
First copy the sample inventory to inventory.yml.
cp inventory-sample.yml inventory.yml
Second edit the inventory file to match your cluster setup. For example:
k3s_cluster:
children:
server:
hosts:
192.16.35.11
agent:
hosts:
192.16.35.12
192.16.35.13
If needed, you can also edit vars section at the bottom to match your environment.
If multiple hosts are in the server group the playbook will automatically setup k3s in HA mode with embedded etcd. An odd number of server nodes is recommended (3,5,7). Read the offical documentation below for more information and options. https://rancher.com/docs/k3s/latest/en/installation/ha-embedded/ Using a loadbalancer or VIP as the API endpoint is preferred but not covered here.
Start provisioning of the cluster using the following command:
ansible-playbook playbook/site.yml -i inventory.yml
Kubeconfig
To confirm access to your Kubernetes cluster use the following:
kubectl get nodes