Skip to content
README.md 1.17 KiB
Newer Older
# 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:

David Putzolu's avatar
David Putzolu committed
- [X] Ubuntu

on processor architecture:

- [X] x64
- [X] arm64
- [X] armhf


Deployment environment must have Ansible 2.4.0+
Master and nodes must have passwordless SSH access

## Usage

Zaher Ghaibeh's avatar
Zaher Ghaibeh committed
First create a new dirctory 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 mactch the system information gathered above. For example:
[master]
192.16.35.12

[node]
192.16.35.[10:11]

master
node
```

Zaher Ghaibeh's avatar
Zaher Ghaibeh committed
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:

Zaher Ghaibeh's avatar
Zaher Ghaibeh committed
ansible-playbook site.yml -i inventory/my-cluster/hosts.ini
To get access to your **Kubernetes** cluster just

```bash
Ahmed Sallam's avatar
Ahmed Sallam committed
scp debian@master_ip:~/.kube/config ~/.kube/config