k3s-playbook

Prerequisites

Environment

• Operating System:
  • RHEL-based systems (Currently tested on Rocky 9.6 systems)
  • (in progress*) Debian-based systems
  • (in progress*) Raspberry Pi systems
• Infrastructure:
  • Local or bare-metal
  • (in progress*) Cloud providers like Hetzner, AWS, etc.
• Python: Compatible Python version installed on managed nodes.

NOTE: While some components may work on other Linux distributions, support is only guaranteed for Rocky Linux (for now...).

Packages

These are the tools that are required to be installed on you control node (the machine you use for deployment).

• Ansible - Red Hat's node orchestration and deployment automation tool.

Soft requirements

• Taskfile - Build tool inspired by GNU Make. Will allow you to use provided commands (use task --list-all).

Usage

TODO: add contents here.

Environment variables

Copy example.env to .env and change the variables to suit your needs.

cp example.env .env

nano .env

Required:

Name	Description
TARGET_ENV
K3S_TOKEN
K3S_DATABASE_TYPE
K3S_DATABASE_PASSWORD
ANSIBLE_INVENTORY_TYPE

Optional:

Name	Description
ANSIBLE_SUDO_PASSWORD
ANSIBLE_CONNECTION_PASSWORD

TODO: add contents here.