net-debug

Description

Assorted network debugging goodies, like tcpdump, socat/websocat, iperf, nmap, nslookup, dig, tcpreplay, and ping/traceroute, all packaged in a self-contained Docker image. The intended use is to sideload the container as a sidecar to Kubernetes pods in order to debug network reachability and performance issues.

Usage examples

Create a Deployment

Config: yaml

Usage:

kubectl apply -f examples/net-debug.yaml

or

kubectl apply -f https://raw.githubusercontent.com/l7mp/net-debug/refs/heads/main/examples/net-debug.yaml

Create a Deployment in host network

Config: yaml

Usage:

kubectl apply -f examples/net-debug-host.yaml

or

kubectl apply -f https://raw.githubusercontent.com/l7mp/net-debug/refs/heads/main/examples/net-debug-host.yaml

Create a DeamonSet in host network

Config: yaml

Usage:

kubectl apply -f examples/net-debug-dameonset.yaml

or

kubectl apply -f https://raw.githubusercontent.com/l7mp/net-debug/refs/heads/main/examples/net-debug-daemonset.yaml

Attach to a pod as debug container

To attach net-debug to an existing pod as a debug container:

kubectl debug <pod_name> -it --image=docker.io/l7mp/net-debug -- bash

Help

Development is coordinated in Discord, feel free to join.

License

MIT License - see LICENSE for full text.