hseeberger / akkluster

Demo application to visualize the status of the member nodes

Akka Cluster up and running

Demo application to visualize the status (up, unreachable, etc.) of the member nodes of an Akka cluster.

Running locally in sbt

First add an additional loopback address:

sudo ifconfig lo0 127.0.0.2 add

Then run an sbt session and execute the command alias (see build.sbt) r0. Point your browser to 127.0.0.1:8080. Optionally run r1 in another sbt session.

How to make nodes unavailable in Docker

To make a node unavailable, first run the containers with NET_ADMIN capabilities:

docker run --detach --cap-add NET_ADMIN ...

Then connect to a running container and block traffic:

docker exec -i -t ... bash
iptables -A INPUT -p tcp -j DROP

To make a node available again:

iptables -D INPUT -p tcp -j DROP

On Minikube

minikube start

# Start with 1 dynamic replica
kubectl apply -f k8s.yml
minikube service --namespace akkluster akkluster-http

# Scale up to two replicas, down to one again and up to two again
kubectl patch --namespace akkluster deployment akkluster-dynamic -p '{"spec": {"replicas": 2}}'
kubectl patch --namespace akkluster deployment akkluster-dynamic -p '{"spec": {"replicas": 1}}'
kubectl patch --namespace akkluster deployment akkluster-dynamic -p '{"spec": {"replicas": 2}}'

# Make one dynamic replica unreachable
kubectl exec --namespace akkluster -i -t akkluster-dynamic-... -- bash
iptables -A INPUT -p tcp -j DROP

# Scale up to three replicas and see what happens ...
kubectl patch --namespace akkluster deployment akkluster-dynamic -p '{"spec": {"replicas": 3}}'

# Make one dynamic replica leave
http --form PUT $(minikube service --url akkluster-management)/cluster/members/akka://[email protected].???:25520 'operation=Leave'

# Make unreachable dynamic replica reachable again
iptables -D INPUT -p tcp -j DROP

Contribution policy

Contributions via GitHub pull requests are gladly accepted from their original author. Along with any pull requests, please state that the contribution is your original work and that you license the work to the project under the project's open source license. Whether or not you state this explicitly, by submitting any copyrighted material via pull request, email, or other means you agree to license the material under the project's open source license and warrant that you have the legal authority to do so.

License

This code is open source software licensed under the Apache-2.0 license.

akkluster's Issues

Should outbound traffic also be blocked to make a node unavailable?

I open the issue just in order to understand why or why not.

iptables -A OUTPUT -p tcp — dport 25520 -j DROP
iptables -A INPUT -p tcp — dport 25520 -j DROP

A great example of Akka Cluster :)