chaos-dispensary

A web service that dispenses random numbers built from

• redis
• CHAOSgen

Base Docker Image

Debian bullseye-slim (x64)

Get the image from Docker Hub or build it yourself

docker pull fullaxx/chaos-dispensary
docker build -t="fullaxx/chaos-dispensary" github.com/Fullaxx/chaos-dispensary

Configuration Options

Adjust chaos2redis to pin long_spin() and time_spin() to the same thread
Default: long_spin() and time_spin() will each spin their own thread

-e SAVEACORE=1

Adjust chaos2redis to acquire 6 blocks of chaos per thread before transmutation
Default: 4 blocks of chaos per thread

-e CHAOS=6

Adjust chaos2redis to use 2 hashing cores for chaos transmutation
Default: 1 hashing core

-e CORES=2

Adjust chaos2redis to keep 25 lists of 999999 random numbers in redis
Default: 10 lists of 100000 random numbers each

-e LISTS=25 -e LSIZE=999999

Launch chaos-dispensary docker container

Run chaos-dispensary binding to 172.17.0.1:80 using default configuration

docker run -d -p 172.17.0.1:80:8080 fullaxx/chaos-dispensary

Run chaos-dispensary binding to 172.17.0.1:80 using a conservative configuration

docker run -d -e SAVEACORE=1 -e CHAOS=2 -p 172.17.0.1:80:8080 fullaxx/chaos-dispensary

Run chaos-dispensary binding to 172.17.0.1:80 using a multi-core configuration

docker run -d -e CORES=4 -p 172.17.0.1:80:8080 fullaxx/chaos-dispensary

Using curl to retrieve random numbers

By default the output will be a space delimited string of numbers.
If the header Accept: application/json is sent, the output will be json.
Get 1 number from the dispensary:

curl http://172.17.0.1:8080/chaos/1
curl -H "Accept: application/json" http://172.17.0.1:8080/chaos/1

Get 10 numbers from the dispensary:

curl http://172.17.0.1:8080/chaos/10
curl -H "Accept: application/json" http://172.17.0.1:8080/chaos/10

Get 99999 numbers from the dispensary:

curl http://172.17.0.1:8080/chaos/99999
curl -H "Accept: application/json" http://172.17.0.1:8080/chaos/99999

Using curl to check status

The status node consists of two values.
Chaos/s is the amount of chaos pouches that we're processing per second.
Numbers/s is the amount of random numbers we're generating per second.

curl http://172.17.0.1:8080/status/
curl -H "Accept: application/json" http://172.17.0.1:8080/status/