uds-rke2-demo

This repo provides configuration and automation for deploying UDS Core on RKE2 with an emphasis on on-prem installations.

Note

The docs in this repo are used in the official UDS docs.

Table of Contents

• Quickstart (using Lima)
• Quickstart (RKE2 already running)
• Further Reading

Quickstart (using Lima)

This quickstart is for users who want to deploy UDS RKE2 on a local Ubuntu VM using Lima.

Host System requirements

The following requirements assume you will be running a VM locally using Lima

• 32GB RAM
• 14 CPU cores

Prerequisites

• Lima
• UDS CLI

The following command runs the default task in the tasks.yaml file in this repo to create a Lima Ubuntu VM with an RKE2 cluster, and installs UDS Core:

uds run

Quickstart (RKE2 already running)

This quickstart assumes an RKE2 cluster is running and is accessible via the CLI.

System Requirements

The following are recommended compute requirements for the system that RKE2 is running on:

• 20GB RAM
• 10 CPU cores

Prerequisites

• UDS CLI

Assuming you are connected to the RKE2 cluster, the following command will install UDS Core and and its prerequisites

uds run install

Further reading

More details regarding running UDS on RKE2 can be found in the official tutorial.