2020-03-04 10:47:40 +01:00
# Build a Kubernetes cluster using k3s via Ansible
2019-04-26 21:10:27 +02:00
2020-03-04 10:47:40 +01:00
Author: < https: / / github . com / itwars >
2019-05-18 19:58:25 +02:00
2019-04-26 21:10:27 +02:00
## K3s Ansible Playbook
Build a Kubernetes cluster using Ansible with k3s. The goal is easily install a Kubernetes cluster on machines running:
2020-03-04 10:47:40 +01:00
- [X] Debian
2020-05-22 18:01:03 +02:00
- [X] Ubuntu
2020-03-04 10:47:40 +01:00
- [X] CentOS
2019-04-26 21:10:27 +02:00
on processor architecture:
- [X] x64
- [X] arm64
- [X] armhf
2020-03-04 10:47:40 +01:00
## System requirements
2019-04-26 21:10:27 +02:00
Deployment environment must have Ansible 2.4.0+
Master and nodes must have passwordless SSH access
## Usage
2020-05-18 05:35:01 +02:00
Add the system information gathered above into a file called `hosts.ini` in the same directory as this README file. There is a template in the `inventory` directory. For example:
2019-04-26 21:10:27 +02:00
2020-03-04 10:47:40 +01:00
```bash
2019-04-26 21:10:27 +02:00
[master]
192.16.35.12
[node]
192.16.35.[10:11]
2020-05-12 22:21:00 +02:00
[k3s_cluster:children]
2019-04-26 21:10:27 +02:00
master
node
```
Start provisioning of the cluster using the following command:
2020-03-04 10:47:40 +01:00
```bash
2020-05-18 05:35:01 +02:00
ansible-playbook site.yml
2019-04-26 21:10:27 +02:00
```
2019-05-18 19:58:25 +02:00
## Kubeconfig
2020-03-04 10:47:40 +01:00
To get access to your **Kubernetes** cluster just
```bash
2020-05-12 23:41:24 +02:00
scp debian@master_ip:~/.kube/config ~/.kube/config
2020-03-04 10:47:40 +01:00
```