Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

What should I test?

Here are a few suggestions for what you can try out and experience in the hands-on part of the workshop.
In any case, if you want to interact with or join the workshop cluster, you should join the OpenWrt network. Wwe have set it up especially for this workshop and in which the cluster/realm we have provided is also accessible.

Experiment with a local cluster on your laptop

This needs internet connection and [docker|podman] compose installed as you will download all needed containers to set up locally on your computer an Aruna cluster with 3 instances.
You'll find the Docker Compose file here. Just download it and run docker compose -f /path/to/the/compose.yaml up to explore the Aruna ecosystem via the
Swagger UIs of the spawned nodes.
This compose file spawns the following containers:

  • A Keycloak which provides authentication
  • A Minio which is used as ephemeral backend storage
  • 3 Aruna instances whose API endpoints are available under the following links after started:

Join the workshop Realm as User and distribute data

After joining the workshop network OpenWrt you can register yourself at http://192.168.1.210:3000 with any user data you like.
After registering, you will immediately receive your OIDC token. You can use this to authorize yourself in the Swagger UI of a node in order to register your user in the realm as a first step.
In the API response to the user's registration in Aruna, you will receive an Aruna token that can be used for authorization in the same way, but is valid for a longer period of time.
From here on you can create your own Group or ask others that they will add your user to their already existing Group to collaborate together.
Feel free to explore the API documentation and test other requests.
The dummy cluster contains the following accessible endpoints:


Join the workshop Realm as Node and be a vital part of the federated network

This is already advanced behavior, which requires a deeper understanding of how federated systems and Aruna v3 in particular work. Talk to the workshop leaders to get more information on the easiest way to deploy a node on your device and become an infrastructural part of the workshop realm.
If you feel confident, you can of course take a closer look at the Docker Compose file mentioned above and try it out for yourself.