Octostar Ansible RKE2

Octostar RKE2 K8s cluster installer with Ansible, based on the RKE2 Ansible Role by Labyrinth Labs.

Requirements

• The only supported OS on cluster nodes is Ubuntu 24.04.

• Make sure to also follow the RKE2 Requirements before you start.

• The RKE2 control plane nodes need ports 6443 and 9345 to be accessible by other nodes in the cluster.

1. Add SSH Private Key

1. Have an SSH key pair and have the public key added to the authorized_keys file on all the cluster nodes.

2. Have your SSH private key stored somewhere on your machine (e.g. in /path/to/key) and make sure it is readable only by the current user:

   chmod 600 /path/to/key
   

3. Edit ansible.cfg and set the path to your SSH private key:

   private_key_file = /path/to/key
   

2. Setup your environment

1. Install Ansible (see Ansible docs for more information)

2. Add Ansible role:

   ansible-galaxy install -r requirements.yml
   

Usage

1. Create a copy of the inventory template.ini, name it <env>.ini (e.g. test.ini), and edit the file filling in the correct values (make sure to go through every section):

   cp inventories/template.ini inventories/test.ini
   

2. Run the playbook

   ./deploy.sh test.ini
   

3. If you have kubectl installed on your machine, you can use the kubeconfig file in kubeconfs/test.yaml to connect to the cluster. Otherwise, you can use the kubectl command from any of the control plane nodes.

   kubectl --kubeconfig kubeconfs/test.yaml get nodes