mirror of
https://github.com/k3s-io/k3s-ansible.git
synced 2025-12-25 00:12:37 +01:00
0a0d265c0e
There are some issues and quirks in the markdown documentation files suggested by the markdownlint project checker that might benefit from being fixed, which this patch does. Change-Id: I33245825e5bb543b5ce1732204984d4a0b169668 Signed-off-by: Joakim Roubert <joakimr@axis.com>
55 lines
912 B
Markdown
55 lines
912 B
Markdown
# 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:
|
||
|
||
- [X] Debian
|
||
- [ ] 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
|
||
|
||
Add the system information gathered above into a file called hosts.ini. For example:
|
||
|
||
```bash
|
||
[master]
|
||
192.16.35.12
|
||
|
||
[node]
|
||
192.16.35.[10:11]
|
||
|
||
[k3s-cluster:children]
|
||
master
|
||
node
|
||
|
||
```
|
||
|
||
Start provisioning of the cluster using the following command:
|
||
|
||
```bash
|
||
ansible-playbook site.yml -i inventory/hosts.ini
|
||
```
|
||
|
||
## Kubeconfig
|
||
|
||
To get access to your **Kubernetes** cluster just
|
||
|
||
```bash
|
||
scp debian@master_pi:~/kube/config ~/.kube/config
|
||
```
|
||
|