lightbend / Pi Akka Cluster
Programming Languages
Raspberry Pi - Kubernetes Cluster
Description
This code is used on a Raspberry-Pi based Akka Cluster to visually demonstrate cluster formation, split-brain occurrence and Split Brain Resolver.
Each node is equipped with an 10-LED RGB strip where different LED's are used to show each node's state (Joining
, Up
, Weakly-up
, Unreachable
, Leaving
, Exiting
and Down
/Removed
). In addition, it shows if a node has a so-called leader role and whether a node is running an Akka Cluster Singleton (if one is created on the cluster).
In addition to 10-LED Cluster there is also OLED display based cluster. Instructions for display assembly can be found here
In the last series of exercises, we deploy an actor based application (a Sudoku Solver) on the cluster and add monitoring (Cinnamon
/Prometheus
/Grafana
) and tracing to the set-up (Open-tracing
/Zipkin
).
Maintainers & Changelog
Removed the changelog & list of maintainers. Git history contains this information.
Instructions
- Make sure you completed the installation of
- Java 11 SDK.
- Some terminal (iTerm-2 on Mac, Terminator on Linux style OS-es, Powershell or ConEmu on Windows).
- curl.
- Clone this project on your laptop.
Preparing your laptop for a Raspberry-Pi based Akka Cluster workshop
Detailed instructions can be found here.
Building your own 5-node Raspberry-Pi based Akka Cluster
If you want to build your own physical cluster, you may want to have a look at the BOM here.
Pi-Hypriot installation instructions
The easiest and fastest way to flash a Hypriot OS instance that is ready to use for the Akka Cluster software can be found here.
Display version instructions are a little different and available here
Travel router configuration
In some cases it can be handy to use a so-called travel router which allows you to connect to a Wifi network on location, and still get access to a physical network with a fixed IP network address. This is because, currently, all nodes have statically configured IP addresses.
Details on how to configure such a (TP-Link TL-WR802N) router can be found here.
Build your own Akka-Cluster on Raspberry Pi
- A bill of material can be found here
- A custom 10-LED strip that can be directly plugged on a Raspberry Pi board's GPIO connector can now be bought from Lightbend! You can buy them in a pack of 5 here.
- A schematic of the LED strip can be found here
Instructions for Display assembly are available here