davoszabo / k3s-ansible

Build a k3s Kubernetes cluster using Ansible. The goal is to install a HA Kubernetes cluster easily with a base Traefik Ingress Controller with cert-manager, storage provisioning with Longhorn, and setting up SSO with Authentik.

Automated build of HA k3s Cluster with kube-vip, basic Traefik ingress deployment, Longhorn and more.

🙌 This project was based on the following excellent repositories:

• techno-tim/k3s-ansible
• ...

Huge thanks to them!

📖 Overview

Build a Kubernetes cluster using Ansible with k3s. The goal is easily install a HA Kubernetes cluster with a base Traefik Ingress Controller with cert-manager, storage provisioning with Longhorn, and setting up SSO with Authentik.

✅ System requirements

• Control Node (the machine you are running ansible commands) must have Ansible 2.11+ If you need a quick primer on Ansible you can check out my docs and setting up Ansible.

• You will also need to install collections that this playbook uses by running ansible-galaxy collection install -r ./collections/requirements.yml ( important❗)

• netaddr package must be available to Ansible. If you have installed Ansible via apt, this is already taken care of. If you have installed Ansible via pip, make sure to install netaddr into the respective virtual environment.

• server and worker nodes should have passwordless SSH access, if not you can supply arguments to provide credentials --ask-pass --ask-become-pass to each command.

🚀 Getting Started

🍴 Preparation

COMING SOON

☸️ Create Cluster

Start provisioning of the cluster using the following command:

COMING SOON

🔨 Testing

COMING SOON