viyancs / rke2-ansible

Installing RKE2 Server on Ubuntu using Ansible

This documentation outlines the steps to install RKE2 server (Rancher Kubernetes Engine 2) on Ubuntu using Ansible. RKE2 is a lightweight Kubernetes distribution developed by Rancher Labs. Prerequisites

Before proceeding, ensure that you have the following prerequisites in place:

Ansible: Make sure Ansible is installed on your local machine.
SSH Access: Ensure you have SSH access to the target hosts where you want to install RKE2.
Sudo or Root Access: Make sure you have sudo or root access on the target hosts.

Step 1: Create an Ansible Playbook

Create a new Ansible playbook (e.g., rke-server) with the following content:

---
- name: Install RKE2 server on Ubuntu
  hosts: rke2_master
  become: true
  tasks:
    - name: Add RKE2 repository GPG key
      apt_key:
        url: https://download.opensuse.org/repositories/devel:kubic:libcontainers:stable/xUbuntu_{{ ansible_distribution_release }}/Release.key
        state: present

    - name: Add RKE2 APT repository
      apt_repository:
        repo: deb https://download.opensuse.org/repositories/devel:/kubic:/libcontainers:/stable/xUbuntu_{{ ansible_distribution_release }}/
        state: present
        filename: rke2

    - name: Update APT cache
      apt:
        update_cache: yes

    - name: Install RKE2 server package
      apt:
        name: rke2-server
        state: latest

    - name: Start RKE2 service
      service:
        name: rke2-server
        state: started

    - name: Enable RKE2 service on boot
      service:
        name: rke2-server
        enabled: yes

Step 2: Create an Inventory File

Create an Ansible inventory file (e.g., inventory.ini) containing the target hosts' information:

ini

[rke2_master]
192.168.1.70
[rke2_master:vars]
ansible_user='admin'
ansible_password='password'
ansible_become_password='password'
# Add more hosts if needed

Replace your_target_host1, your_target_host2, etc., in the inventory file with the actual IP addresses or hostnames of the target hosts where you want to install RKE2 server. Step 3: Run the Ansible Playbook

Execute the Ansible playbook to install RKE2 server:

bash

ansible-playbook -i host.ini rke-server.yml

The playbook will add the RKE2 repository's GPG key, add the RKE2 APT repository, update the APT cache, install the RKE2 server package, start the RKE2 service, and enable it to start on boot on the target hosts specified in the inventory file. Conclusion

After completing the above steps, you should have RKE2 server installed and running on your Ubuntu target hosts. You can now use RKE2 to manage Kubernetes clusters and deploy containerized applications.

Always ensure to review the playbook and customize it based on your specific requirements and environment. Additionally, make sure you have proper SSH access and permissions to execute the tasks on the target hosts.