kubernetes/docs/projects/ansible/collection/kubernetes/index.md

title, description, date, template, about

title	description	date	template	about
Kubernetes	No Fuss Computings Ansible Collection Kubernetes	2024-03-13	project.html	https://gitlab.com/nofusscomputing/projects/ansible/collections/kubernetes

This Ansible Collection is for installing a K3s Kubernetes cluster, both single and multi-node cluster deployments are supported. In addition to installing and configuring the firewall for the node. for further information on the firewall config please see the firewall docs

Installation

To install this collection use ansible-galaxy collection install nofusscomputing.kubernetes

Features

Most of the features of this collection are from the included role nfc_kubernetes, please view its page for feature details.

Using this collection

This collection has been designed to be a complete and self-contained management tool for a K3s kubernetes cluster.

K3s Kubernetes Installation

By default the install playbook will install to localhost.

ansible-playbook nofusscomputing.kubernetes.install

The install playbook has a dynamic hosts key. This has been done to specifically support running the playbook from AWX and being able to populate the field from the survey feature. Order of precedence for the host variable is as follows:

• nfc_pb_host set to any valid value that a playbook hosts key can accept

• nfc_pb_kubernetes_cluster_name with the name of the cluster. This variable is appended to string kubernetes_cluster_ to serve as a group name for the cluster to be installed. i.e. for a cluster called prime, the group name would be set to kubernetes_cluster_prime

• --limit specified at runtime

• localhost

For the available variables please view the nfc_kubernetes role docs