About

A docker image with simple Flask application to test Kubernetes cluster.

For example, one can simulate network failure scenarios (via toggling liveness probe) or app failure (using readiness probe programmable logic). The app contains in-built version and generates a unique UUID on startup

Business logic is simple - the main endpoint returns random number

Installation

python3 -m venv venv
source ./venv/bin/activate
pip install -r requirements.txt

Running

To start local server

# export PORT=8080 - optional
python3 app.py

(default port is 8080, since 80 is usually taken by other processes)

Building image

Test and dev built:

sudo docker build -t randomizer:1.0 .
sudo docker run randomizer:1.0

Note, docker runs images in isolation mode by default and hence you cannot connect to localhost:8080. Use mapping instead:

docker run -d -p 8080:8080 randomizer:1.0
docker kill <container_id>

Production built:

docker login -u <user_name>
docker tag randomizer:1.0 <user_name>/randomizer:1.0
docker push <user_name>/randomizer:1.0

API

endpoint	action
/	returns random number
/memory-loader?mb=3	allocates memory buffer in 3 MB
/toggle-live	toggles liveness probe
/toggle-ready	toggles readiness probe
/health	returns 200 OK or 500 Error
/info	returns insights about server env