Ansible¶

I use Ansible to setup the nodes and deploy K3s to my cluster.

Inventory¶

The inventory hosts and variables need to be updated to your environment.

# ./server/ansible/inventory/cluster/hosts.yaml
---
all:
  children:
    main:
      hosts:
        turing-main:
          ansible_host: 192.168.1.201
    node:
      hosts:
        worker-02:
          ansible_host: 192.168.1.202
        worker-03:
          ansible_host: 192.168.1.203
...

Be sure to set the ansible version and the user name on the nodes to the group_vars.

# ./server/ansible/inventory/cluster/group_vars/all.yaml
...
k3s_version: v1.18.16+k3s1
ansible_user: pi
...

Playbooks¶

All commands below are executed from the ./server/ansible directory except for the Task commands.

Prepare¶

Prepare the nodes for the K3s installation by changing certain settings and removing crufty packages.

ansible-playbook ./playbook/prepare.yaml

Install¶

Install K3s

ansible-playbook ./playbook/install.yaml

Nuke¶

Uninstall K3s from the cluster.

ansible-playbook ./playbook/nuke.yaml

Upgrade¶

Perform an upgrade to the operatring system, not K3s.

ansible-playbook ./playbook/upgrade.yaml

Other Commands¶

Other Ansible related commands can be found by running the following from the root of the repository:

task -l