5b3e2a5db6
- Inital server starts first so it can grab the token for other servers and copy the config to localhost - More cleanup of agent/server naming scheme Signed-off-by: Derek Nola <derek.nola@suse.com> |
||
|---|---|---|
| .github/workflows | ||
| collections | ||
| playbook | ||
| roles | ||
| .gitignore | ||
| .yamllint | ||
| ansible.cfg | ||
| inventory-sample.yml | ||
| LICENSE | ||
| 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 get access to your Kubernetes cluster just
scp debian@server_ip:~/.kube/config ~/.kube/config