k3s/contrib/ansible/README.md
2020-05-01 23:02:08 -05:00

55 lines
913 B
Markdown
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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
```