caturday icon indicating copy to clipboard operation
caturday copied to clipboard

☁️ Cloud native cats with prometheus metrics, kubernetes ready and cute as hell 🐈

Caturday

A lightweight web application I use to test container networking

caturday.png

Endpoints

endpoint method purpose
/* GET giving you all cats HTML and network info
/metrics GET basic prometheus metrics endpoint
/raw GET giving you a cat in plain text and network info
/health GET health handler for your liveness or readiness, not normally the same endpoint but hey cats are simple and cute :heart_eyes_cat :

Usage with Kubernetes

As you can see in the following example, I provide a simple example using caturday behind the kubernetes NGINX ingress and using kube-lego to obtain automatically Let's Encrypt certificates.

I suggest you to edit the file if you want to use a custom domain (default: kittens.local) or if your ingress is not nginx or you don'w want to automatically get certificates.

kubectl apply -f https://raw.githubusercontent.com/fntlnz/caturday/master/caturday.yml

Usage with Red Hat OpenShift

First, create a new OpenShift project:

oc new-project caturday

I provide an example set of OpenShift definitions that uses openshift-acme to automatically secure the route for the application. Edit it as needed, then run:

oc create -f caturday-openshift.yml

Usage with Docker

docker run -d fntlnz/caturday