rajakshay/dinghy-ping

Dinghy Ping

Dinghy Ping is a simple network debugging interface meant to be deployed into your compute infrastructure (ie, Kubernetes). Used for debugging network connectivity to other services local to Dinghy Ping or external to the compute infrastructure (egress). Meant to answer simple connectivity questions developers might have when deploying their applications to a container orchestration setup where routing and accessibility may be different from their local development environments.

Requirements

pipenv install

Localhost

python3 api.py

Local Docker Build and Run

# start local redis instance, with rejson module support
docker run -p 6379:6379 -d redislabs/rejson:latest

# build and start dinghy-ping from local code
docker build . --tag dinghy:latest

# on MacOS 
docker run -p 80:80 -p 8000:8000 -e "REDIS_HOST=host.docker.internal" dinghy:latest

# non-MacOS
docker run -p 80:80 -p 8000:8000 dinghy:latest

Dinghy ping single endpoint

curl "http://127.0.0.1/dinghy/ping/https/google.com"

Dinghy ping single endpoint with params

curl "http://127.0.0.1/dinghy/ping/https/www.google.com/search?source=hp&ei=aIHTW9mLNuOJ0gK8g624Ag&q=dinghy&btnK=Google+Search&oq=dinghy&gs_l=psy-ab.3..35i39l2j0i131j0i20i264j0j0i20i264j0l4.4754.5606..6143...1.0..0.585.957.6j5-1......0....1..gws-wiz.....6..0i67j0i131i20i264.oe0qJ9brs-8"

Dinghy ping multiple sites

# dinghy-ping multiple sites
curl -vX POST "http://127.0.0.1/dinghy/ping/domains" \
  -d @tests/multiple_domains.json \
  --header "Content-Type: application/json"

Helm Install

helm upgrade --install dinghy-ping ./helm/dinghy-ping/ --set image.tag=v0.0.9 --set ingress.subdomain="yourhostname.net"

Local development on Mac with Docker controlled K8s

Install Docker for MacOS and enable Kubernetes

# Install ingress-nginx
kubectl apply -f https://raw.githubusercontent.com/kubernetes/ingress-nginx/master/deploy/mandatory.yaml
kubectl apply -f https://raw.githubusercontent.com/kubernetes/ingress-nginx/master/deploy/provider/cloud-generic.yaml

Update your /etc/hosts

127.0.0.1 localhost dinghy-ping.localhost

Install dinghy-ping helm chart, modify to docker image tag of your branch, pr, or release tag

helm upgrade --install dinghy-ping ./helm/dinghy-ping/ --set image.tag=v0.0.9 --set ingress.subdomain="localhost"

Navigate to Dinghy-Ping in browser

http://dinghy-ping.localhost

rajakshay / dinghy-ping